https://github.com/clojure/math.numeric-tower
Math functions that deal intelligently with the various types in Clojure's numeric tower
https://github.com/clojure/math.numeric-tower
Last synced: about 1 month ago
JSON representation
Math functions that deal intelligently with the various types in Clojure's numeric tower
- Host: GitHub
- URL: https://github.com/clojure/math.numeric-tower
- Owner: clojure
- License: epl-1.0
- Created: 2011-07-29T15:26:24.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2024-07-15T17:57:24.000Z (11 months ago)
- Last Synced: 2025-04-01T10:15:28.742Z (3 months ago)
- Language: Clojure
- Homepage:
- Size: 67.4 KB
- Stars: 175
- Watchers: 31
- Forks: 14
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
clojure.math.numeric-tower
========================================
Formerly clojure.contrib.math
Math functions that deal intelligently with the various
types in Clojure's numeric tower, as well as math functions
commonly found in Scheme implementations.
Functions included:
* (expt x y) - x to the yth power
* (abs n) - absolute value of n
* (gcd m n) - greatest common divisor of m and n
* (lcm m n) - least common multiple of m and n
* (floor x) - round down
* (ceil x) - round up
* (round x) - round to nearest
* (sqrt x) - square root, exact if possible
* (exact-integer-sqrt k) returns floor of square root and the "remainder"
More documentation in docstrings.
Releases and Dependency Information
========================================
Latest stable release: 0.0.5
* [All Released Versions](https://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22org.clojure%22%20AND%20a%3A%22math.numeric-tower%22)
* [Development Snapshot Versions](https://oss.sonatype.org/index.html#nexus-search;gav~org.clojure~math.numeric-tower~~~)
[CLI/`deps.edn`](https://clojure.org/reference/deps_and_cli) dependency information:
```clojure
org.clojure/math.numeric-tower {:mvn/version "0.0.5"}
```
[Leiningen](https://github.com/technomancy/leiningen) dependency information:
```clojure
[org.clojure/math.numeric-tower "0.0.5"]
```
[Maven](https://maven.apache.org/) dependency information:
```xml
org.clojure
math.numeric-tower
0.0.5
```
Example Usage
========================================
```clojure
(ns example.core
(:require [clojure.math.numeric-tower :as math]))
(defn- sqr
"Uses the numeric tower expt to square a number"
[x]
(math/expt x 2))
(defn euclidean-squared-distance
"Computes the Euclidean squared distance between two sequences"
[a b]
(reduce + (map (comp sqr -) a b)))
(defn euclidean-distance
"Computes the Euclidean distance between two sequences"
[a b]
(math/sqrt (euclidean-squared-distance a b)))
(let [a [1 2 3 5 8 13 21]
b [0 2 4 6 8 10 12]]
(euclidean-distance a b))
;;=> 9.643650760992955
```
Refer to docstrings in the `clojure.math.numeric-tower` namespace for
additional documentation.
[API Documentation](https://clojure.github.io/math.numeric-tower/)
Developer Information
========================================
* [GitHub project](https://github.com/clojure/math.numeric-tower)
* [Bug Tracker](https://clojure.atlassian.net/browse/MTOWER)
* [Continuous Integration](https://github.com/clojure/math.numeric-tower/actions/workflows/test.yml)
Changelog
========================================
* Release 0.0.5 on 2021-12-01
* Exclude abs to avoid future warning in 1.11
* Release 0.0.4 on 2014-01-16
* Adjust return type of expt to match base when power is 0.
* (expt 3M 0) -> 1M
* (expt 3N 0) -> 1N
* Release 0.0.3 on 2013-12-29
* Minor improvement to sqrt of ratio.
* Release 0.0.2 on 2012-11-23
* Added type hints to remove some reflective calls.
* Release 0.0.1 on 2011-10-15
* Initial release.
* Source-compatible with clojure.contrib.math, except for the name change.
License
========================================
Distributed under the Eclipse Public License, the same as Clojure.