An open API service indexing awesome lists of open source software.

https://github.com/apache/commons-numbers

Apache Commons Numbers
https://github.com/apache/commons-numbers

angle combinatorics complex floating-point fraction gamma java math precision prime quaternion

Last synced: 28 days ago
JSON representation

Apache Commons Numbers

Awesome Lists containing this project

README

        

Apache Commons Numbers
===================

[![Java CI](https://github.com/apache/commons-numbers/actions/workflows/maven.yml/badge.svg)](https://github.com/apache/commons-numbers/actions/workflows/maven.yml)
[![Coverage Status](https://codecov.io/gh/apache/commons-numbers/branch/master/graph/badge.svg)](https://app.codecov.io/gh/apache/commons-numbers)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-numbers-bom/badge.svg?gav=true)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-numbers-bom/?gav=true)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=commons-numbers&metric=alert_status)](https://sonarcloud.io/dashboard?id=commons-numbers)

The Apache Commons Numbers project provides number types and utilities.

Documentation
-------------

More information can be found on the [Apache Commons Numbers homepage](https://commons.apache.org/proper/commons-numbers).
The [Javadoc](https://commons.apache.org/proper/commons-numbers/commons-numbers-docs/apidocs) for each of the modules can be browsed:

- [Commons Numbers Core](https://commons.apache.org/proper/commons-numbers/commons-numbers-core/apidocs/)
- [Commons Numbers Complex](https://commons.apache.org/proper/commons-numbers/commons-numbers-complex/apidocs/)
- [Commons Numbers Primes](https://commons.apache.org/proper/commons-numbers/commons-numbers-primes/apidocs/)
- [Commons Numbers Quaternion](https://commons.apache.org/proper/commons-numbers/commons-numbers-quaternion/apidocs/)
- [Commons Numbers Fraction](https://commons.apache.org/proper/commons-numbers/commons-numbers-fraction/apidocs/)
- [Commons Numbers Angle](https://commons.apache.org/proper/commons-numbers/commons-numbers-angle/apidocs/)
- [Commons Numbers Gamma](https://commons.apache.org/proper/commons-numbers/commons-numbers-gamma/apidocs/)
- [Commons Numbers Combinatorics](https://commons.apache.org/proper/commons-numbers/commons-numbers-combinatorics/apidocs/)
- [Commons Numbers Arrays](https://commons.apache.org/proper/commons-numbers/commons-numbers-arrays/apidocs/)
- [Commons Numbers Field](https://commons.apache.org/proper/commons-numbers/commons-numbers-field/apidocs/)
- [Commons Numbers RootFinder](https://commons.apache.org/proper/commons-numbers/commons-numbers-rootfinder/apidocs/)

Questions related to the usage of Apache Commons Numbers should be posted to the [user mailing list](https://commons.apache.org/mail-lists.html).

Getting the latest release
--------------------------
You can download source and binaries from our [download page](https://commons.apache.org/proper/commons-numbers/download_numbers.cgi).

Alternatively, you can pull it from the central Maven repositories, for example:

```xml

org.apache.commons
commons-numbers-core
1.2

org.apache.commons
commons-numbers-complex
1.2

org.apache.commons
commons-numbers-quaternion
1.2

```

Building
--------

Building requires a Java JDK and [Apache Maven](https://maven.apache.org/).
The required Java version is found in the `pom.xml` as the `maven.compiler.source` property.

From a command shell, run `mvn` without arguments to invoke the default Maven goal to run all tests and checks.

Contributing
------------

We accept Pull Requests via GitHub. The [developer mailing list](https://commons.apache.org/mail-lists.html) is the main channel of communication for contributors.
There are some guidelines which will make applying PRs easier for us:
+ No tabs! Please use spaces for indentation.
+ Respect the existing code style for each file.
+ Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
+ Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running ```mvn```.

If you plan to contribute on a regular basis, please consider filing a [contributor license agreement](https://www.apache.org/licenses/#clas).
You can learn more about contributing via GitHub in our [contribution guidelines](CONTRIBUTING.md).

License
-------
This code is licensed under the [Apache License v2](https://www.apache.org/licenses/LICENSE-2.0).

See the `NOTICE` file for required notices and attributions.

Donating
--------
You like Apache Commons Numbers? Then [donate back to the ASF](https://www.apache.org/foundation/contributing.html) to support development.

Additional Resources
--------------------

+ [Apache Commons Homepage](https://commons.apache.org/)
+ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/NUMBERS)
+ [Apache Commons Slack Channel](https://the-asf.slack.com/archives/C60NVB8AD)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)

Apache Commons Components
-------------------------

Please see the [list of components](https://commons.apache.org/components.html)