forked from ahgamut/cpython
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
special thanks to @EirikJaccheri EirikJaccheri@27d6fba
- Loading branch information
Showing
1,312 changed files
with
203,570 additions
and
26 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,58 @@ | ||
Pint was originally written by Hernan E. Grecco <[email protected]>. | ||
|
||
and is currently maintained, listed alphabetically, by: | ||
|
||
* Jules Chéron <[email protected]> | ||
* Hernan E. Grecco <[email protected]>. | ||
|
||
Other contributors, listed alphabetically, are: | ||
|
||
* Aaron Coleman | ||
* Alexander Böhn <[email protected]> | ||
* Ana Krivokapic <[email protected]> | ||
* Andrea Zonca <[email protected]> | ||
* Andrew Savage <[email protected]> | ||
* Brend Wanders <[email protected]> | ||
* choloepus | ||
* coutinho <[email protected]> | ||
* Clément Pit-Claudel <[email protected]> | ||
* Daniel Sokolowski <[email protected]> | ||
* Dave Brooks <[email protected]> | ||
* David Linke | ||
* Ed Schofield <[email protected]> | ||
* Eduard Bopp <[email protected]> | ||
* Eli <[email protected]> | ||
* Felix Hummel <[email protected]> | ||
* Francisco Couzo <[email protected]> | ||
* Giel van Schijndel <[email protected]> | ||
* Guido Imperiale <[email protected]> | ||
* Ignacio Fdez. Galván <[email protected]> | ||
* James Rowe <[email protected]> | ||
* Jim Turner <[email protected]> | ||
* Joel B. Mohler <[email protected]> | ||
* John David Reaver <[email protected]> | ||
* Jonas Olson <[email protected]> | ||
* Jules Chéron <[email protected]> | ||
* Kaido Kert <[email protected]> | ||
* Kenneth D. Mankoff <[email protected]> | ||
* Kevin Davies <[email protected]> | ||
* Luke Campbell <[email protected]> | ||
* Matthieu Dartiailh <[email protected]> | ||
* Nate Bogdanowicz <[email protected]> | ||
* Peter Grayson <[email protected]> | ||
* Richard Barnes <[email protected]> | ||
* Robert Booth <[email protected]> | ||
* Ryan Dwyer <[email protected]> | ||
* Ryan Kingsbury <[email protected]> | ||
* Ryan May | ||
* Sebastian Kosmeier | ||
* Sigvald Marholm <[email protected]> | ||
* Sundar Raman <[email protected]> | ||
* Tiago Coutinho <[email protected]> | ||
* Thomas Kluyver <[email protected]> | ||
* Tom Nicholas <[email protected]> | ||
* Tom Ritchford <[email protected]> | ||
* Virgil Dupras <[email protected]> | ||
* Zebedee Nicholls <[email protected]> | ||
|
||
(If you think that your name belongs here, please let the maintainer know) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
Copyright (c) 2012 by Hernan E. Grecco and contributors. See AUTHORS | ||
for more details. | ||
|
||
Some rights reserved. | ||
|
||
Redistribution and use in source and binary forms of the software as well | ||
as documentation, with or without modification, are permitted provided | ||
that the following conditions are met: | ||
|
||
* Redistributions of source code must retain the above copyright | ||
notice, this list of conditions and the following disclaimer. | ||
|
||
* Redistributions in binary form must reproduce the above | ||
copyright notice, this list of conditions and the following | ||
disclaimer in the documentation and/or other materials provided | ||
with the distribution. | ||
|
||
* The names of the contributors may not be used to endorse or | ||
promote products derived from this software without specific | ||
prior written permission. | ||
|
||
THIS SOFTWARE AND DOCUMENTATION IS PROVIDED BY THE COPYRIGHT HOLDERS AND | ||
CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT | ||
NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | ||
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER | ||
OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, | ||
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, | ||
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR | ||
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF | ||
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING | ||
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS | ||
SOFTWARE AND DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH | ||
DAMAGE. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,207 @@ | ||
Metadata-Version: 2.1 | ||
Name: Pint | ||
Version: 0.22 | ||
Summary: Physical quantities module | ||
Author-email: "Hernan E. Grecco" <[email protected]> | ||
Maintainer-email: "Hernan E. Grecco" <[email protected]>, Jules Chéron <[email protected]> | ||
License: BSD | ||
Project-URL: Homepage, https://github.com/hgrecco/pint | ||
Project-URL: Documentation, https://pint.readthedocs.io/ | ||
Keywords: physical,quantities,unit,conversion,science | ||
Classifier: Development Status :: 4 - Beta | ||
Classifier: Intended Audience :: Developers | ||
Classifier: Intended Audience :: Science/Research | ||
Classifier: License :: OSI Approved :: BSD License | ||
Classifier: Operating System :: MacOS :: MacOS X | ||
Classifier: Operating System :: Microsoft :: Windows | ||
Classifier: Operating System :: POSIX | ||
Classifier: Programming Language :: Python | ||
Classifier: Topic :: Scientific/Engineering | ||
Classifier: Topic :: Software Development :: Libraries | ||
Classifier: Programming Language :: Python :: 3.9 | ||
Classifier: Programming Language :: Python :: 3.10 | ||
Classifier: Programming Language :: Python :: 3.11 | ||
Requires-Python: >=3.9 | ||
Description-Content-Type: text/x-rst | ||
License-File: LICENSE | ||
License-File: AUTHORS | ||
Requires-Dist: typing-extensions | ||
Provides-Extra: babel | ||
Requires-Dist: babel (<=2.8) ; extra == 'babel' | ||
Provides-Extra: dask | ||
Requires-Dist: dask ; extra == 'dask' | ||
Provides-Extra: mip | ||
Requires-Dist: mip (>=1.13) ; extra == 'mip' | ||
Provides-Extra: numpy | ||
Requires-Dist: numpy (>=1.19.5) ; extra == 'numpy' | ||
Provides-Extra: pandas | ||
Requires-Dist: pint-pandas (>=0.3) ; extra == 'pandas' | ||
Provides-Extra: test | ||
Requires-Dist: pytest ; extra == 'test' | ||
Requires-Dist: pytest-mpl ; extra == 'test' | ||
Requires-Dist: pytest-cov ; extra == 'test' | ||
Requires-Dist: pytest-subtests ; extra == 'test' | ||
Provides-Extra: uncertainties | ||
Requires-Dist: uncertainties (>=3.1.6) ; extra == 'uncertainties' | ||
Provides-Extra: xarray | ||
Requires-Dist: xarray ; extra == 'xarray' | ||
|
||
.. image:: https://img.shields.io/pypi/v/pint.svg | ||
:target: https://pypi.python.org/pypi/pint | ||
:alt: Latest Version | ||
|
||
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg | ||
:target: https://github.com/python/black | ||
|
||
.. image:: https://readthedocs.org/projects/pint/badge/ | ||
:target: https://pint.readthedocs.org/ | ||
:alt: Documentation | ||
|
||
.. image:: https://img.shields.io/pypi/l/pint.svg | ||
:target: https://pypi.python.org/pypi/pint | ||
:alt: License | ||
|
||
.. image:: https://img.shields.io/pypi/pyversions/pint.svg | ||
:target: https://pypi.python.org/pypi/pint | ||
:alt: Python Versions | ||
|
||
.. image:: https://github.com/hgrecco/pint/workflows/CI/badge.svg | ||
:target: https://github.com/hgrecco/pint/actions?query=workflow%3ACI | ||
:alt: CI | ||
|
||
.. image:: https://github.com/hgrecco/pint/workflows/Lint/badge.svg | ||
:target: https://github.com/hgrecco/pint/actions?query=workflow%3ALint | ||
:alt: LINTER | ||
|
||
.. image:: https://coveralls.io/repos/github/hgrecco/pint/badge.svg?branch=master | ||
:target: https://coveralls.io/github/hgrecco/pint?branch=master | ||
:alt: Coverage | ||
|
||
|
||
Pint: makes units easy | ||
====================== | ||
|
||
Pint is a Python package to define, operate and manipulate physical | ||
quantities: the product of a numerical value and a unit of measurement. | ||
It allows arithmetic operations between them and conversions from and | ||
to different units. | ||
|
||
It is distributed with a comprehensive list of physical units, prefixes | ||
and constants. Due to its modular design, you can extend (or even rewrite!) | ||
the complete list without changing the source code. It supports a lot of | ||
numpy mathematical operations **without monkey patching or wrapping numpy**. | ||
|
||
It has a complete test coverage. It runs in Python 3.9+ with no other dependency. | ||
It is licensed under BSD. | ||
|
||
It is extremely easy and natural to use: | ||
|
||
.. code-block:: python | ||
|
||
>>> import pint | ||
>>> ureg = pint.UnitRegistry() | ||
>>> 3 * ureg.meter + 4 * ureg.cm | ||
<Quantity(3.04, 'meter')> | ||
|
||
and you can make good use of numpy if you want: | ||
|
||
.. code-block:: python | ||
|
||
>>> import numpy as np | ||
>>> [3, 4] * ureg.meter + [4, 3] * ureg.cm | ||
<Quantity([ 3.04 4.03], 'meter')> | ||
>>> np.sum(_) | ||
<Quantity(7.07, 'meter')> | ||
|
||
|
||
Quick Installation | ||
------------------ | ||
|
||
To install Pint, simply: | ||
|
||
.. code-block:: bash | ||
|
||
$ pip install pint | ||
|
||
or utilizing conda, with the conda-forge channel: | ||
|
||
.. code-block:: bash | ||
|
||
$ conda install -c conda-forge pint | ||
|
||
and then simply enjoy it! | ||
|
||
|
||
Documentation | ||
------------- | ||
|
||
Full documentation is available at http://pint.readthedocs.org/ | ||
|
||
|
||
Command-line converter | ||
---------------------- | ||
|
||
A command-line script `pint-convert` provides a quick way to convert between | ||
units or get conversion factors. | ||
|
||
|
||
Design principles | ||
----------------- | ||
|
||
Although there are already a few very good Python packages to handle physical | ||
quantities, no one was really fitting my needs. Like most developers, I | ||
programmed Pint to scratch my own itches. | ||
|
||
**Unit parsing**: prefixed and pluralized forms of units are recognized without | ||
explicitly defining them. In other words: as the prefix *kilo* and the unit | ||
*meter* are defined, Pint understands *kilometers*. This results in a much | ||
shorter and maintainable unit definition list as compared to other packages. | ||
|
||
**Standalone unit definitions**: units definitions are loaded from a text file | ||
which is simple and easy to edit. Adding and changing units and their | ||
definitions does not involve changing the code. | ||
|
||
**Advanced string formatting**: a quantity can be formatted into string using | ||
`PEP 3101`_ syntax. Extended conversion flags are given to provide symbolic, | ||
LaTeX and pretty formatting. Unit name translation is available if Babel_ is | ||
installed. | ||
|
||
**Free to choose the numerical type**: You can use any numerical type | ||
(`fraction`, `float`, `decimal`, `numpy.ndarray`, etc). NumPy_ is not required | ||
but supported. | ||
|
||
**Awesome NumPy integration**: When you choose to use a NumPy_ ndarray, its methods and | ||
ufuncs are supported including automatic conversion of units. For example | ||
`numpy.arccos(q)` will require a dimensionless `q` and the units of the output | ||
quantity will be radian. | ||
|
||
**Uncertainties integration**: transparently handles calculations with | ||
quantities with uncertainties (like 3.14±0.01 meter) via the `uncertainties | ||
package`_. | ||
|
||
**Handle temperature**: conversion between units with different reference | ||
points, like positions on a map or absolute temperature scales. | ||
|
||
**Dependency free**: it depends only on Python and its standard library. It interacts with other packages | ||
like numpy and uncertainties if they are installed | ||
|
||
**Pandas integration**: Thanks to `Pandas Extension Types`_ it is now possible to use Pint with Pandas. Operations on DataFrames and between columns are units aware, providing even more convenience for users of Pandas DataFrames. For full details, see the `pint-pandas Jupyter notebook`_. | ||
|
||
|
||
Pint is maintained by a community of scientists, programmers and enthusiasts around the world. | ||
See AUTHORS_ for a complete list. | ||
|
||
To review an ordered list of notable changes for each version of a project, | ||
see CHANGES_ | ||
|
||
|
||
.. _Website: http://www.dimensionalanalysis.org/ | ||
.. _`comprehensive list of physical units, prefixes and constants`: https://github.com/hgrecco/pint/blob/master/pint/default_en.txt | ||
.. _`uncertainties package`: https://pythonhosted.org/uncertainties/ | ||
.. _`NumPy`: http://www.numpy.org/ | ||
.. _`PEP 3101`: https://www.python.org/dev/peps/pep-3101/ | ||
.. _`Babel`: http://babel.pocoo.org/ | ||
.. _`Pandas Extension Types`: https://pandas.pydata.org/pandas-docs/stable/development/extending.html#extension-types | ||
.. _`pint-pandas Jupyter notebook`: https://github.com/hgrecco/pint-pandas/blob/master/notebooks/pint-pandas.ipynb | ||
.. _`AUTHORS`: https://github.com/hgrecco/pint/blob/master/AUTHORS | ||
.. _`CHANGES`: https://github.com/hgrecco/pint/blob/master/CHANGES |
Oops, something went wrong.