Script 'mail_helper' called by obssrc
Hello community,
here is the log from the commit of package python-uncertainties for
openSUSE:Factory checked in at 2021-07-22 22:43:30
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Comparing /work/SRC/openSUSE:Factory/python-uncertainties (Old)
and /work/SRC/openSUSE:Factory/.python-uncertainties.new.1899 (New)
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "python-uncertainties"
Thu Jul 22 22:43:30 2021 rev:12 rq:907691 version:3.1.6
Changes:
--------
---
/work/SRC/openSUSE:Factory/python-uncertainties/python-uncertainties.changes
2021-02-19 23:46:23.447429597 +0100
+++
/work/SRC/openSUSE:Factory/.python-uncertainties.new.1899/python-uncertainties.changes
2021-07-22 22:44:18.215126049 +0200
@@ -1,0 +2,6 @@
+Thu Jul 22 02:06:55 UTC 2021 - Arun Persaud <a...@gmx.de>
+
+- update to version 3.1.6:
+ * the pretty-print and LaTeX format can now be customized.
+
+-------------------------------------------------------------------
Old:
----
uncertainties-3.1.5.tar.gz
New:
----
uncertainties-3.1.6.tar.gz
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Other differences:
------------------
++++++ python-uncertainties.spec ++++++
--- /var/tmp/diff_new_pack.jp3kKp/_old 2021-07-22 22:44:18.587125565 +0200
+++ /var/tmp/diff_new_pack.jp3kKp/_new 2021-07-22 22:44:18.587125565 +0200
@@ -18,7 +18,7 @@
%{?!python_module:%define python_module() python-%{**} python3-%{**}}
Name: python-uncertainties
-Version: 3.1.5
+Version: 3.1.6
Release: 0
Summary: Uncertainties on the Quantities Involved (aka "Error
Propagation")
License: BSD-3-Clause
++++++ uncertainties-3.1.5.tar.gz -> uncertainties-3.1.6.tar.gz ++++++
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/PKG-INFO
new/uncertainties-3.1.6/PKG-INFO
--- old/uncertainties-3.1.5/PKG-INFO 2020-11-18 09:25:46.000000000 +0100
+++ new/uncertainties-3.1.6/PKG-INFO 2021-07-11 22:55:37.229128000 +0200
@@ -1,254 +1,13 @@
Metadata-Version: 2.1
Name: uncertainties
-Version: 3.1.5
+Version: 3.1.6
Summary: Transparent calculations with uncertainties on the quantities
involved (aka error propagation); fast calculation of derivatives
Home-page: http://uncertainties-python-package.readthedocs.io/
Author: Eric O. LEBIGOT (EOL)
Author-email: eric.lebi...@normalesup.org
License: Revised BSD License
-Project-URL: Source, https://github.com/lebigot/uncertainties
Project-URL: Documentation,
https://uncertainties-python-package.readthedocs.io/
-Description: Overview
- ========
-
- ``uncertainties`` allows **calculations** such as (2 +/- 0.1)*2 = 4 +/-
- 0.2 to be **performed transparently**. Much more complex mathematical
- expressions involving numbers with uncertainties can also be evaluated
- directly.
-
- The ``uncertainties`` package **takes the pain and complexity out**
- of uncertainty calculations.
-
- **Detailed information** about this package can be found on its `main
- website`_.
-
- Basic examples
- ==============
-
- .. code-block:: python
-
- >>> from uncertainties import ufloat
-
- >>> x = ufloat(2, 0.25)
- >>> x
- 2.0+/-0.25
-
- >>> square = x**2 # Transparent calculations
- >>> square
- 4.0+/-1.0
- >>> square.nominal_value
- 4.0
- >>> square.std_dev # Standard deviation
- 1.0
-
- >>> square - x*x
- 0.0 # Exactly 0: correlations taken into account
-
- >>> from uncertainties.umath import * # sin(), etc.
- >>> sin(1+x**2)
- -0.95892427466313845+/-0.2836621854632263
-
- >>> print (2*x+1000).derivatives[x] # Automatic calculation of
derivatives
- 2.0
-
- >>> from uncertainties import unumpy # Array manipulation
- >>> random_vars = unumpy.uarray([1, 2], [0.1, 0.2])
- >>> print random_vars
- [1.0+/-0.1 2.0+/-0.2]
- >>> print random_vars.mean()
- 1.50+/-0.11
- >>> print unumpy.cos(random_vars)
- [0.540302305868+/-0.0841470984808 -0.416146836547+/-0.181859485365]
-
- Main features
- =============
-
- - **Transparent calculations with uncertainties**: **no or little
- modification of existing code** is needed. Similarly, the Python_
(or
- IPython_) shell can be used as **a powerful calculator** that
- handles quantities with uncertainties (``print`` statements are
- optional, which is convenient).
-
- - **Correlations** between expressions are correctly taken into
- account. Thus, ``x-x`` is exactly zero, for instance (most
- implementations found on the web yield a non-zero uncertainty for
- ``x-x``, which is incorrect).
-
- - **Almost all mathematical operations** are supported, including most
- functions from the standard math_ module (sin,...). Comparison
- operators (``>``, ``==``, etc.) are supported too.
-
- - Many **fast operations on arrays and matrices** of numbers with
- uncertainties are supported.
-
- - **Extensive support for printing** numbers with uncertainties
- (including LaTeX support and pretty-printing).
-
- - Most uncertainty calculations are performed **analytically**.
-
- - This module also gives access to the **derivatives** of any
- mathematical expression (they are used by error
- propagation theory, and are thus automatically calculated by this
- module).
-
-
- Installation or upgrade
- =======================
-
- Installation instructions are available on the `main web site
-
<http://uncertainties-python-package.readthedocs.io/en/latest/index.html#installation-and-download>`_
- for this package.
-
- Contact
- =======
-
- Please send **feature requests, bug reports, or feedback** to
- `Eric O. LEBIGOT (EOL)`_.
-
- Version history
- ===============
-
- Main changes:
-
- - 3.1.5: added a "p" formatting option, that makes sure that there are
always
- parentheses around the ??? ?? ??? part of printed numbers.
- - 3.1.4: Python 2.7+ is now required.
- - 3.1.2: Fix for NumPy 1.17 and ``unumpy.ulinalg.pinv()``.
- - 3.1: Variables built through a correlation or covariance matrix, and
that
- have uncertainties that span many orders of magnitude are now
- calculated more accurately (improved ``correlated_values()`` and
- ``correlated_values_norm()`` functions).
- - 3.0: Massive speedup for some operations involving large numbers of
numbers with uncertainty, like ``sum(ufloat(1, 1) for _ in xrange(100000))``
(this is about 5,000 times faster than before).
- - 2.4.8: Friendlier completions in Python shells, etc.: internal
functions should not appear anymore (for the user modules: ``uncertainties``,
``uncertainties.umath`` and ``uncertainties.unumpy``). Parsing the shorthand
notation (e.g. ``3.1(2)``) now works with infinite values (e.g. ``-inf(inf)``);
this mirrors the ability to print such numbers with uncertainty. The Particle
Data Group rounding rule is applied in more cases (e.g. printing 724.2??26.2
now gives ``724??26``). The shorthand+LaTeX formatting of numbers with an
infinite nominal value is fixed. ``uncertainties.unumpy.matrix`` now uses
``.std_devs`` instead of ``.std_devs()``, for consistency with floats with
uncertainty (automatic conversion of code added to ``uncertainties.1to2``).
- - 2.4.7: String formatting now works for ``(-)inf+/-...`` numbers.
- - 2.4.5: String formatting now works for ``NaN+/-...`` numbers.
- - 2.4.4: The documentation license now allows its commercial use.
- - 2.4.2: `NumPy 1.8 compatibility
<https://github.com/numpy/numpy/issues/4063>`_.
- - 2.4.1: In ``uncertainties.umath``, functions ``ceil()``, ``floor()``,
- ``isinf()``, ``isnan()`` and ``trunc()`` now return values of
- the same type as the corresponding ``math`` module function
- (instead of generally returning a value with a zero uncertainty
- ``...+/-0``).
- - 2.4: Extensive support for the formatting_ of numbers with
uncertainties.
- A zero uncertainty is now explicitly displayed as the integer 0.
- The new formats are generally understood by ``ufloat_fromstr()``.
- Abbreviations for the nominal value (``n``) and the standard
- deviation (``s``) are now available.
- - 2.3.6: Full support for limit cases of the power operator
- ``umath.pow()``.
- - 2.3.5: Uncertainties and derivatives can now be NaN (not-a-number).
- Full support for numbers with a zero uncertainty
- (``sqrt(ufloat(0, 0))`` now works).
- Full support for limit cases of the power operator (``x**y``).
- - 2.3: Functions wrapped
- so that they accept numbers with uncertainties instead of floats
- now have full keyword arguments support
- (improved ``wrap()`` function). Incompatible change:
- ``wrap(..., None)`` should be replaced by ``wrap(...)`` or
- ``wrap(..., [])``.
- - 2.2: Creating arrays and matrices of numbers with uncertainties
- with ``uarray()`` and ``umatrix()`` now requires two simple arguments
- (nominal values and standard deviations) instead of a tuple argument.
- This is consistent with the new, simpler ``ufloat()`` interface.
- The previous
- usage will be supported for some time. Users are encouraged to update
- their code, for instance through the newly provided `code updater`_,
- which in addition now automatically converts ``.set_std_dev(v)`` to
- ``.std_dev = v``.
- - 2.1: Numbers with uncertainties are now created more directly like
- ``ufloat(3, 0.1)``, ``ufloat(3, 0.1, "pi")``,
- ``ufloat_fromstr("3.0(1)")``, or ``ufloat_fromstr("3.0(1)", "pi")``.
- The previous ``ufloat((3, 0.1))`` and ``ufloat("3.0(1)")`` forms
- will be supported for some time. Users are encouraged to update
- their code, for instance through the newly provided `code updater`_.
- - 2.0: The standard deviation is now obtained more directly without an
- explicit
- call (``x.std_dev`` instead of ``x.std_dev()``). ``x.std_dev()``
- will be supported for some time. Users are encouraged to update
- their code. The standard deviation of a variable can now be
- directly updated with ``x.std_dev = 0.1``. As a consequence,
- ``x.set_std_dev()`` is deprecated.
- - 1.9.1: Support added for pickling subclasses of ``UFloat`` (=
``Variable``).
- - 1.9: Added functions for handling correlation matrices:
- ``correlation_matrix()`` and
- ``correlated_values_norm()``. (These new functions mirror the
- covariance-matrix based ``covariance_matrix()`` and
- ``correlated_values()``.) ``UFloat.position_in_sigmas()`` is
- now named ``UFloat.std_score()``, so as to follow the common
- naming convention (`standard score
- <http://en.wikipedia.org/wiki/Standard_score>`_). Obsolete
- functions were removed (from the main module:
- ``NumberWithUncert``, ``num_with_uncert``, ``array_u``,
- ``nominal_values``, ``std_devs``).
- - 1.8: Compatibility with Python 3.2 added.
- - 1.7.2: Compatibility with Python 2.3, Python 2.4, Jython 2.5.1 and
- Jython 2.5.2 added.
- - 1.7.1: New semantics: ``ufloat("12.3(78)")`` now represents
12.3+/-7.8
- instead of 12.3+/-78.
- - 1.7: ``ufloat()`` now raises ValueError instead of a generic
Exception,
- when given an incorrect
- string representation, like ``float()`` does.
- - 1.6: Testing whether an object is a number with uncertainty should
now
- be done with ``isinstance(..., UFloat)``.
- ``AffineScalarFunc`` is not imported by ``from uncertainties import
*``
- anymore, but its new alias ``UFloat`` is.
- - 1.5.5: The first possible license is now the Revised BSD License
- instead of GPLv2, which
- makes it easier to include this package in other projects.
- - 1.5.4.2: Added ``umath.modf()`` and ``umath.frexp()``.
- - 1.5.4: ``ufloat`` does not accept a single number (nominal value)
anymore.
- This removes some potential confusion about
- ``ufloat(1.1)`` (zero uncertainty) being different from
- ``ufloat("1.1")`` (uncertainty of 1 on the last digit).
- - 1.5.2: ``float_u``, ``array_u`` and ``matrix_u`` renamed ``ufloat``,
- ``uarray`` and ``umatrix``, for ease of typing.
- - 1.5: Added functions ``nominal_value`` and ``std_dev``, and
- modules ``unumpy`` (additional support for NumPy_ arrays and
- matrices) and ``unumpy.ulinalg`` (generalization of some
- functions from ``numpy.linalg``).
- Memory footprint of arrays of numbers with uncertainties
- divided by 3.
- Function ``array_u`` is 5 times faster.
- Main function ``num_with_uncert`` renamed
- ``float_u``, for consistency with ``unumpy.array_u`` and
- ``unumpy.matrix_u``, with the added benefit of a shorter name.
- - 1.4.5: Added support for the standard ``pickle`` module.
- - 1.4.2: Added support for the standard ``copy`` module.
- - 1.4: Added utilities for manipulating NumPy_ arrays of numbers with
- uncertainties (``array_u``, ``nominal_values`` and ``std_devs``).
- - 1.3: Numbers with uncertainties are now constructed with
- ``num_with_uncert()``, which replaces ``NumberWithUncert()``. This
- simplifies the class hierarchy by removing the ``NumberWithUncert``
class.
- - 1.2.5: Numbers with uncertainties can now be entered as
- ``NumberWithUncert("1.23+/-0.45")`` too.
- - 1.2.3: ``log(x, base)`` is now supported by ``umath.log()``, in
addition
- to ``log(x)``.
- - 1.2.2: Values with uncertainties are now output like 3+/-1, in order
- to avoid confusing 3+-1 with 3+(-1).
- - 1.2: A new function, ``wrap()``, is exposed, which allows non-Python
- functions (e.g. Fortran or C used through a module such as SciPy) to
- handle numbers with uncertainties.
- - 1.1: Mathematical functions (such as cosine, etc.) are in a new
- uncertainties.umath module;
- they do not override functions from the ``math`` module anymore.
- - 1.0.12: Main class (``Number_with_uncert``) renamed
``NumberWithUncert``
- so as to follow `PEP 8`_.
- - 1.0.11: ``origin_value`` renamed more appropriately as
- ``nominal_value``.
- - 1.0.9: ``correlations()`` renamed more appropriately as
- ``covariance_matrix()``.
-
- .. _Python: http://docs.python.org/tutorial/interpreter.html
- .. _IPython: http://ipython.readthedocs.io/en/stable/
- .. _NumPy: http://numpy.scipy.org/
- .. _math: http://docs.python.org/library/math.html
- .. _PEP 8: http://www.python.org/dev/peps/pep-0008/
- .. _error propagation theory:
http://en.wikipedia.org/wiki/Propagation_of_uncertainty
- .. _Eric O. LEBIGOT (EOL): mailto:eric.lebi...@normalesup.org
- .. _PayPal:
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4TK7KNDTEDT4S
- .. _main website: http://uncertainties-python-package.readthedocs.io/
- .. _code updater:
http://uncertainties-python-package.readthedocs.io/en/latest/index.html#migration-from-version-1-to-version-2
- .. _formatting:
http://uncertainties-python-package.readthedocs.io/en/latest/user_guide.html#printing
+Project-URL: Source, https://github.com/lebigot/uncertainties
Keywords: error propagation,uncertainties,uncertainty calculations,standard
deviation,derivatives,partial derivatives,differentiation
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
@@ -280,7 +39,252 @@
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
+Provides-Extra: optional
Provides-Extra: docs
Provides-Extra: tests
-Provides-Extra: optional
Provides-Extra: all
+License-File: LICENSE.txt
+
+Overview
+========
+
+``uncertainties`` allows **calculations** such as (2 +/- 0.1)*2 = 4 +/-
+0.2 to be **performed transparently**. Much more complex mathematical
+expressions involving numbers with uncertainties can also be evaluated
+directly.
+
+The ``uncertainties`` package **takes the pain and complexity out**
+of uncertainty calculations.
+
+**Detailed information** about this package can be found on its `main
+website`_.
+
+Basic examples
+==============
+
+.. code-block:: python
+
+ >>> from uncertainties import ufloat
+
+ >>> x = ufloat(2, 0.25)
+ >>> x
+ 2.0+/-0.25
+
+ >>> square = x**2 # Transparent calculations
+ >>> square
+ 4.0+/-1.0
+ >>> square.nominal_value
+ 4.0
+ >>> square.std_dev # Standard deviation
+ 1.0
+
+ >>> square - x*x
+ 0.0 # Exactly 0: correlations taken into account
+
+ >>> from uncertainties.umath import * # sin(), etc.
+ >>> sin(1+x**2)
+ -0.95892427466313845+/-0.2836621854632263
+
+ >>> print (2*x+1000).derivatives[x] # Automatic calculation of derivatives
+ 2.0
+
+ >>> from uncertainties import unumpy # Array manipulation
+ >>> random_vars = unumpy.uarray([1, 2], [0.1, 0.2])
+ >>> print random_vars
+ [1.0+/-0.1 2.0+/-0.2]
+ >>> print random_vars.mean()
+ 1.50+/-0.11
+ >>> print unumpy.cos(random_vars)
+ [0.540302305868+/-0.0841470984808 -0.416146836547+/-0.181859485365]
+
+Main features
+=============
+
+- **Transparent calculations with uncertainties**: **no or little
+ modification of existing code** is needed. Similarly, the Python_ (or
+ IPython_) shell can be used as **a powerful calculator** that
+ handles quantities with uncertainties (``print`` statements are
+ optional, which is convenient).
+
+- **Correlations** between expressions are correctly taken into
+ account. Thus, ``x-x`` is exactly zero, for instance (most
+ implementations found on the web yield a non-zero uncertainty for
+ ``x-x``, which is incorrect).
+
+- **Almost all mathematical operations** are supported, including most
+ functions from the standard math_ module (sin,...). Comparison
+ operators (``>``, ``==``, etc.) are supported too.
+
+- Many **fast operations on arrays and matrices** of numbers with
+ uncertainties are supported.
+
+- **Extensive support for printing** numbers with uncertainties
+ (including LaTeX support and pretty-printing).
+
+- Most uncertainty calculations are performed **analytically**.
+
+- This module also gives access to the **derivatives** of any
+ mathematical expression (they are used by error
+ propagation theory, and are thus automatically calculated by this
+ module).
+
+
+Installation or upgrade
+=======================
+
+Installation instructions are available on the `main web site
+<http://uncertainties-python-package.readthedocs.io/en/latest/index.html#installation-and-download>`_
+for this package.
+
+Contact
+=======
+
+Please send **feature requests, bug reports, or feedback** to
+`Eric O. LEBIGOT (EOL)`_.
+
+Version history
+===============
+
+Main changes:
+
+- 3.1.6: the pretty-print and LaTeX format can now be customized.
+- 3.1.5: added a "p" formatting option, that makes sure that there are always
+ parentheses around the ??? ?? ??? part of printed numbers.
+- 3.1.4: Python 2.7+ is now required.
+- 3.1.2: Fix for NumPy 1.17 and ``unumpy.ulinalg.pinv()``.
+- 3.1: Variables built through a correlation or covariance matrix, and that
+ have uncertainties that span many orders of magnitude are now
+ calculated more accurately (improved ``correlated_values()`` and
+ ``correlated_values_norm()`` functions).
+- 3.0: Massive speedup for some operations involving large numbers of numbers
with uncertainty, like ``sum(ufloat(1, 1) for _ in xrange(100000))`` (this is
about 5,000 times faster than before).
+- 2.4.8: Friendlier completions in Python shells, etc.: internal functions
should not appear anymore (for the user modules: ``uncertainties``,
``uncertainties.umath`` and ``uncertainties.unumpy``). Parsing the shorthand
notation (e.g. ``3.1(2)``) now works with infinite values (e.g. ``-inf(inf)``);
this mirrors the ability to print such numbers with uncertainty. The Particle
Data Group rounding rule is applied in more cases (e.g. printing 724.2??26.2
now gives ``724??26``). The shorthand+LaTeX formatting of numbers with an
infinite nominal value is fixed. ``uncertainties.unumpy.matrix`` now uses
``.std_devs`` instead of ``.std_devs()``, for consistency with floats with
uncertainty (automatic conversion of code added to ``uncertainties.1to2``).
+- 2.4.7: String formatting now works for ``(-)inf+/-...`` numbers.
+- 2.4.5: String formatting now works for ``NaN+/-...`` numbers.
+- 2.4.4: The documentation license now allows its commercial use.
+- 2.4.2: `NumPy 1.8 compatibility
<https://github.com/numpy/numpy/issues/4063>`_.
+- 2.4.1: In ``uncertainties.umath``, functions ``ceil()``, ``floor()``,
+ ``isinf()``, ``isnan()`` and ``trunc()`` now return values of
+ the same type as the corresponding ``math`` module function
+ (instead of generally returning a value with a zero uncertainty
+ ``...+/-0``).
+- 2.4: Extensive support for the formatting_ of numbers with uncertainties.
+ A zero uncertainty is now explicitly displayed as the integer 0.
+ The new formats are generally understood by ``ufloat_fromstr()``.
+ Abbreviations for the nominal value (``n``) and the standard
+ deviation (``s``) are now available.
+- 2.3.6: Full support for limit cases of the power operator
+ ``umath.pow()``.
+- 2.3.5: Uncertainties and derivatives can now be NaN (not-a-number).
+ Full support for numbers with a zero uncertainty
+ (``sqrt(ufloat(0, 0))`` now works).
+ Full support for limit cases of the power operator (``x**y``).
+- 2.3: Functions wrapped
+ so that they accept numbers with uncertainties instead of floats
+ now have full keyword arguments support
+ (improved ``wrap()`` function). Incompatible change:
+ ``wrap(..., None)`` should be replaced by ``wrap(...)`` or
+ ``wrap(..., [])``.
+- 2.2: Creating arrays and matrices of numbers with uncertainties
+ with ``uarray()`` and ``umatrix()`` now requires two simple arguments
+ (nominal values and standard deviations) instead of a tuple argument.
+ This is consistent with the new, simpler ``ufloat()`` interface.
+ The previous
+ usage will be supported for some time. Users are encouraged to update
+ their code, for instance through the newly provided `code updater`_,
+ which in addition now automatically converts ``.set_std_dev(v)`` to
+ ``.std_dev = v``.
+- 2.1: Numbers with uncertainties are now created more directly like
+ ``ufloat(3, 0.1)``, ``ufloat(3, 0.1, "pi")``,
+ ``ufloat_fromstr("3.0(1)")``, or ``ufloat_fromstr("3.0(1)", "pi")``.
+ The previous ``ufloat((3, 0.1))`` and ``ufloat("3.0(1)")`` forms
+ will be supported for some time. Users are encouraged to update
+ their code, for instance through the newly provided `code updater`_.
+- 2.0: The standard deviation is now obtained more directly without an
+ explicit
+ call (``x.std_dev`` instead of ``x.std_dev()``). ``x.std_dev()``
+ will be supported for some time. Users are encouraged to update
+ their code. The standard deviation of a variable can now be
+ directly updated with ``x.std_dev = 0.1``. As a consequence,
+ ``x.set_std_dev()`` is deprecated.
+- 1.9.1: Support added for pickling subclasses of ``UFloat`` (= ``Variable``).
+- 1.9: Added functions for handling correlation matrices:
+ ``correlation_matrix()`` and
+ ``correlated_values_norm()``. (These new functions mirror the
+ covariance-matrix based ``covariance_matrix()`` and
+ ``correlated_values()``.) ``UFloat.position_in_sigmas()`` is
+ now named ``UFloat.std_score()``, so as to follow the common
+ naming convention (`standard score
+ <http://en.wikipedia.org/wiki/Standard_score>`_). Obsolete
+ functions were removed (from the main module:
+ ``NumberWithUncert``, ``num_with_uncert``, ``array_u``,
+ ``nominal_values``, ``std_devs``).
+- 1.8: Compatibility with Python 3.2 added.
+- 1.7.2: Compatibility with Python 2.3, Python 2.4, Jython 2.5.1 and
+ Jython 2.5.2 added.
+- 1.7.1: New semantics: ``ufloat("12.3(78)")`` now represents 12.3+/-7.8
+ instead of 12.3+/-78.
+- 1.7: ``ufloat()`` now raises ValueError instead of a generic Exception,
+ when given an incorrect
+ string representation, like ``float()`` does.
+- 1.6: Testing whether an object is a number with uncertainty should now
+ be done with ``isinstance(..., UFloat)``.
+ ``AffineScalarFunc`` is not imported by ``from uncertainties import *``
+ anymore, but its new alias ``UFloat`` is.
+- 1.5.5: The first possible license is now the Revised BSD License
+ instead of GPLv2, which
+ makes it easier to include this package in other projects.
+- 1.5.4.2: Added ``umath.modf()`` and ``umath.frexp()``.
+- 1.5.4: ``ufloat`` does not accept a single number (nominal value) anymore.
+ This removes some potential confusion about
+ ``ufloat(1.1)`` (zero uncertainty) being different from
+ ``ufloat("1.1")`` (uncertainty of 1 on the last digit).
+- 1.5.2: ``float_u``, ``array_u`` and ``matrix_u`` renamed ``ufloat``,
+ ``uarray`` and ``umatrix``, for ease of typing.
+- 1.5: Added functions ``nominal_value`` and ``std_dev``, and
+ modules ``unumpy`` (additional support for NumPy_ arrays and
+ matrices) and ``unumpy.ulinalg`` (generalization of some
+ functions from ``numpy.linalg``).
+ Memory footprint of arrays of numbers with uncertainties
+ divided by 3.
+ Function ``array_u`` is 5 times faster.
+ Main function ``num_with_uncert`` renamed
+ ``float_u``, for consistency with ``unumpy.array_u`` and
+ ``unumpy.matrix_u``, with the added benefit of a shorter name.
+- 1.4.5: Added support for the standard ``pickle`` module.
+- 1.4.2: Added support for the standard ``copy`` module.
+- 1.4: Added utilities for manipulating NumPy_ arrays of numbers with
+ uncertainties (``array_u``, ``nominal_values`` and ``std_devs``).
+- 1.3: Numbers with uncertainties are now constructed with
+ ``num_with_uncert()``, which replaces ``NumberWithUncert()``. This
+ simplifies the class hierarchy by removing the ``NumberWithUncert`` class.
+- 1.2.5: Numbers with uncertainties can now be entered as
+ ``NumberWithUncert("1.23+/-0.45")`` too.
+- 1.2.3: ``log(x, base)`` is now supported by ``umath.log()``, in addition
+ to ``log(x)``.
+- 1.2.2: Values with uncertainties are now output like 3+/-1, in order
+ to avoid confusing 3+-1 with 3+(-1).
+- 1.2: A new function, ``wrap()``, is exposed, which allows non-Python
+ functions (e.g. Fortran or C used through a module such as SciPy) to
+ handle numbers with uncertainties.
+- 1.1: Mathematical functions (such as cosine, etc.) are in a new
+ uncertainties.umath module;
+ they do not override functions from the ``math`` module anymore.
+- 1.0.12: Main class (``Number_with_uncert``) renamed ``NumberWithUncert``
+ so as to follow `PEP 8`_.
+- 1.0.11: ``origin_value`` renamed more appropriately as
+ ``nominal_value``.
+- 1.0.9: ``correlations()`` renamed more appropriately as
+ ``covariance_matrix()``.
+
+.. _Python: http://docs.python.org/tutorial/interpreter.html
+.. _IPython: http://ipython.readthedocs.io/en/stable/
+.. _NumPy: http://numpy.scipy.org/
+.. _math: http://docs.python.org/library/math.html
+.. _PEP 8: http://www.python.org/dev/peps/pep-0008/
+.. _error propagation theory:
http://en.wikipedia.org/wiki/Propagation_of_uncertainty
+.. _Eric O. LEBIGOT (EOL): mailto:eric.lebi...@normalesup.org
+.. _PayPal:
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4TK7KNDTEDT4S
+.. _main website: http://uncertainties-python-package.readthedocs.io/
+.. _code updater:
http://uncertainties-python-package.readthedocs.io/en/latest/index.html#migration-from-version-1-to-version-2
+.. _formatting:
http://uncertainties-python-package.readthedocs.io/en/latest/user_guide.html#printing
+
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/doc/conf.py
new/uncertainties-3.1.6/doc/conf.py
--- old/uncertainties-3.1.5/doc/conf.py 2020-02-23 18:49:30.000000000 +0100
+++ new/uncertainties-3.1.6/doc/conf.py 2021-07-11 22:50:02.000000000 +0200
@@ -194,8 +194,11 @@
# Additional stuff for the LaTeX preamble.
#latex_preamble = r'\DeclareUnicodeCharacter{207B}{$^-$}'
latex_elements = {
- # Superscript -, for pdflatex (unnecessary, with xelatex):
- 'preamble': r'\DeclareUnicodeCharacter{207B}{$^-$}'
+ # Superscript -, etc. for pdflatex (unnecessary, with xelatex):
+ 'preamble': r'''
+\DeclareUnicodeCharacter{207B}{$^-$}
+\DeclareUnicodeCharacter{22C5}{$\cdot$}
+'''
}
# Documents to append as an appendix to all manuals.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/doc/index.rst
new/uncertainties-3.1.6/doc/index.rst
--- old/uncertainties-3.1.5/doc/index.rst 2020-06-07 10:50:06.000000000
+0200
+++ new/uncertainties-3.1.6/doc/index.rst 2021-07-11 22:52:17.000000000
+0200
@@ -416,7 +416,7 @@
This software is released under a **dual license**; one of the
following options can be chosen:
-1. The `Revised BSD License`_ (?? 2010???2019, Eric O. LEBIGOT [EOL]).
+1. The `Revised BSD License`_ (?? 2010???2021, Eric O. LEBIGOT [EOL]).
2. Any other license, as long as it is obtained from the creator of
this package.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/doc/user_guide.rst
new/uncertainties-3.1.6/doc/user_guide.rst
--- old/uncertainties-3.1.5/doc/user_guide.rst 2020-11-18 09:04:01.000000000
+0100
+++ new/uncertainties-3.1.6/doc/user_guide.rst 2021-07-11 22:50:02.000000000
+0200
@@ -167,6 +167,10 @@
Access to the uncertainty and to the nominal value
==================================================
+.. index::
+ pair: nominal value; scalar
+ pair: uncertainty; scalar
+
The nominal value and the uncertainty (standard deviation) can also be
accessed independently:
@@ -588,9 +592,19 @@
prints with the shorthand notation: ``Result = 0.20(1)``.
-.. index::
- pair: nominal value; scalar
- pair: uncertainty; scalar
+Customization of the pretty print and LaTeX outputs
+---------------------------------------------------
+
+The pretty print and LaTeX outputs themselves can be customized.
+
+For example, the pretty-print representation of numbers with uncertainty can
+display multiplication with a centered dot (???) instead of the default symbol
+(??), like in ``(2.00??0.10)???10?????``; this is easily done through the
global
+setting ``uncertainties.core.MULT_SYMBOLS["pretty-print"] = "???"``.
+
+Beyond this multiplication symbol, the "??" symbol, the parentheses and the
+exponent representations can also be customized globally. The details can be
+found in the documentation of :func:`uncertainties.core.format_num`.
Making custom functions accept numbers with uncertainties
=========================================================
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/setup.py
new/uncertainties-3.1.6/setup.py
--- old/uncertainties-3.1.5/setup.py 2020-11-18 09:24:42.000000000 +0100
+++ new/uncertainties-3.1.6/setup.py 2021-07-11 22:50:02.000000000 +0200
@@ -20,7 +20,7 @@
# Common options for distutils/setuptools's setup():
setup_options = dict(
name='uncertainties',
- version='3.1.5',
+ version='3.1.6',
author='Eric O. LEBIGOT (EOL)',
author_email='eric.lebi...@normalesup.org',
url='http://uncertainties-python-package.readthedocs.io/',
@@ -131,6 +131,7 @@
Main changes:
+- 3.1.6: the pretty-print and LaTeX format can now be customized.
- 3.1.5: added a "p" formatting option, that makes sure that there are always
parentheses around the ??? ?? ??? part of printed numbers.
- 3.1.4: Python 2.7+ is now required.
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/uncertainties/__init__.py
new/uncertainties-3.1.6/uncertainties/__init__.py
--- old/uncertainties-3.1.5/uncertainties/__init__.py 2020-11-18
09:21:15.000000000 +0100
+++ new/uncertainties-3.1.6/uncertainties/__init__.py 2021-07-11
22:50:02.000000000 +0200
@@ -226,7 +226,7 @@
from .core import __all__ # For a correct help(uncertainties)
# Numerical version:
-__version_info__ = (3, 1, 5)
+__version_info__ = (3, 1, 6)
__version__ = '.'.join(map(str, __version_info__))
__author__ = 'Eric O. LEBIGOT (EOL) <eric.lebi...@normalesup.org>'
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/uncertainties/core.py
new/uncertainties-3.1.6/uncertainties/core.py
--- old/uncertainties-3.1.5/uncertainties/core.py 2020-11-18
09:04:01.000000000 +0100
+++ new/uncertainties-3.1.6/uncertainties/core.py 2021-07-11
22:50:02.000000000 +0200
@@ -21,10 +21,10 @@
from builtins import range
from past.builtins import basestring
from builtins import object
-import sys
-import re
import math
from math import sqrt, log, isnan, isinf # Optimization: no attribute look-up
+import re
+import sys
try:
from math import isinfinite # !! Python 3.2+
@@ -1021,11 +1021,19 @@
# a subclass of unicode, in Python 2):
return int(str(number_str).translate(FROM_SUPERSCRIPT))
-# Function that transforms an exponent produced by format_num() into
+PM_SYMBOLS = {'pretty-print': u'??', 'latex': r' \pm ', 'default': '+/-'}
+
+# Multiplication symbol for pretty printing (so that pretty printing can
+# be customized):
+MULT_SYMBOLS = {'pretty-print': u'??', 'latex': r'\times'}
+
+# Function that transforms a numerical exponent produced by format_num() into
# the corresponding string notation (for non-default modes):
EXP_PRINT = {
- 'pretty-print': lambda common_exp: u'??10%s' % to_superscript(common_exp),
- 'latex': lambda common_exp: r' \times 10^{%d}' % common_exp}
+ 'pretty-print': lambda common_exp: u'%s10%s' % (
+ MULT_SYMBOLS['pretty-print'], to_superscript(common_exp)),
+ 'latex': lambda common_exp: r' %s 10^{%d}' % (
+ MULT_SYMBOLS['latex'], common_exp)}
# Symbols used for grouping (typically between parentheses) in format_num():
GROUP_SYMBOLS = {
@@ -1041,21 +1049,30 @@
def format_num(nom_val_main, error_main, common_exp,
fmt_parts, prec, main_pres_type, options):
- r'''
+ u'''
Return a formatted number with uncertainty.
Null errors (error_main) are displayed as the integer 0, with
no decimal point.
- The formatting can be partially customized globally. The EXP_PRINT
- maps non-default modes ("latex", "pretty-print") to a function
- that transforms a common exponent into a string (of the form
- "times 10 to the power <exponent>", where "times" can be
- represented, e.g., as a centered dot instead of the multiplication
- symbol). The GROUP_SYMBOLS mapping maps each of these modes to the
- pair of strings used for grouping expressions (typically
- parentheses, which can be for instance replaced by "\left(" and
- "\right(" in LaTeX so as to create a non-breakable group).
+ The formatting can be customized globally through the PM_SYMBOLS,
+ MULT_SYMBOLS, GROUP_SYMBOLS and EXP_PRINT dictionaries, which contain
+ respectively the symbol for ??, for multiplication, for parentheses, and a
+ function that maps an exponent to something like "??10??" (using
+ MULT_SYMBOLS).
+
+ Each of these dictionary has (at least) a 'pretty-print' and a 'latex' key,
+ that define the symbols to be used for these two output formats (the
+ PM_SYMBOLS and GROUP_SYMBOLS also have a 'default' key for the default
+ output format). For example, the defaults for the 'pretty-print' format
+ are:
+
+ - PM_SYMBOLS['pretty-print'] = '??'
+ - MULT_SYMBOLS['pretty-print'] = '??'
+ - GROUP_SYMBOLS['pretty-print'] = ( '(', ')' )
+ - EXP_PRINT['pretty-print']: see the source code.
+
+ Arguments:
nom_val_main, error_main -- nominal value and error, before using
common_exp (e.g., "1.23e2" would have a main value of 1.23;
@@ -1418,14 +1435,7 @@
fmt_parts['width'])
####################
- if 'P' in options:
- # Unicode has priority over LaTeX, so that users with a
- # Unicode-compatible LaTeX source can use ??:
- pm_symbol = u'??'
- elif 'L' in options:
- pm_symbol = r' \pm '
- else:
- pm_symbol = '+/-'
+ pm_symbol = PM_SYMBOLS[print_type] # Shortcut
####################
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/uncertainties-3.1.5/uncertainties/test_uncertainties.py
new/uncertainties-3.1.6/uncertainties/test_uncertainties.py
--- old/uncertainties-3.1.5/uncertainties/test_uncertainties.py 2020-11-18
09:04:01.000000000 +0100
+++ new/uncertainties-3.1.6/uncertainties/test_uncertainties.py 2021-07-11
22:50:02.000000000 +0200
@@ -2131,6 +2131,29 @@
assert isinstance(u'R??sultat = %s' % x.format(''), str)
assert isinstance(u'R??sultat = %s' % x.format('P'), str)
+def test_custom_pretty_print_and_latex():
+ '''Test of the pretty-print and LaTeX format customizations'''
+
+ x = ufloat(2, 0.1)*1e-11
+
+ # We will later restore the defaults:
+ PREV_CUSTOMIZATIONS = {
+ var: getattr(uncert_core, var).copy()
+ for var in ['PM_SYMBOLS', 'MULT_SYMBOLS', 'GROUP_SYMBOLS']}
+
+ # Customizations:
+ for format in ["pretty-print", "latex"]:
+ uncert_core.PM_SYMBOLS[format] = u" ?? "
+ uncert_core.MULT_SYMBOLS[format] = u"???"
+ uncert_core.GROUP_SYMBOLS[format] = ( "[", "]" )
+
+ assert u"{:P}".format(x) == u'[2.00 ?? 0.10]???10???????'
+ assert u"{:L}".format(x) == u'[2.00 ?? 0.10] ??? 10^{-11}'
+
+ # We restore the defaults:
+ for (var, setting) in PREV_CUSTOMIZATIONS.items():
+ setattr(uncert_core, var, setting)
+
###############################################################################
# The tests below require NumPy, which is an optional package:
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore' old/uncertainties-3.1.5/uncertainties.egg-info/PKG-INFO
new/uncertainties-3.1.6/uncertainties.egg-info/PKG-INFO
--- old/uncertainties-3.1.5/uncertainties.egg-info/PKG-INFO 2020-11-18
09:25:46.000000000 +0100
+++ new/uncertainties-3.1.6/uncertainties.egg-info/PKG-INFO 2021-07-11
22:55:37.000000000 +0200
@@ -1,254 +1,13 @@
Metadata-Version: 2.1
Name: uncertainties
-Version: 3.1.5
+Version: 3.1.6
Summary: Transparent calculations with uncertainties on the quantities
involved (aka error propagation); fast calculation of derivatives
Home-page: http://uncertainties-python-package.readthedocs.io/
Author: Eric O. LEBIGOT (EOL)
Author-email: eric.lebi...@normalesup.org
License: Revised BSD License
-Project-URL: Source, https://github.com/lebigot/uncertainties
Project-URL: Documentation,
https://uncertainties-python-package.readthedocs.io/
-Description: Overview
- ========
-
- ``uncertainties`` allows **calculations** such as (2 +/- 0.1)*2 = 4 +/-
- 0.2 to be **performed transparently**. Much more complex mathematical
- expressions involving numbers with uncertainties can also be evaluated
- directly.
-
- The ``uncertainties`` package **takes the pain and complexity out**
- of uncertainty calculations.
-
- **Detailed information** about this package can be found on its `main
- website`_.
-
- Basic examples
- ==============
-
- .. code-block:: python
-
- >>> from uncertainties import ufloat
-
- >>> x = ufloat(2, 0.25)
- >>> x
- 2.0+/-0.25
-
- >>> square = x**2 # Transparent calculations
- >>> square
- 4.0+/-1.0
- >>> square.nominal_value
- 4.0
- >>> square.std_dev # Standard deviation
- 1.0
-
- >>> square - x*x
- 0.0 # Exactly 0: correlations taken into account
-
- >>> from uncertainties.umath import * # sin(), etc.
- >>> sin(1+x**2)
- -0.95892427466313845+/-0.2836621854632263
-
- >>> print (2*x+1000).derivatives[x] # Automatic calculation of
derivatives
- 2.0
-
- >>> from uncertainties import unumpy # Array manipulation
- >>> random_vars = unumpy.uarray([1, 2], [0.1, 0.2])
- >>> print random_vars
- [1.0+/-0.1 2.0+/-0.2]
- >>> print random_vars.mean()
- 1.50+/-0.11
- >>> print unumpy.cos(random_vars)
- [0.540302305868+/-0.0841470984808 -0.416146836547+/-0.181859485365]
-
- Main features
- =============
-
- - **Transparent calculations with uncertainties**: **no or little
- modification of existing code** is needed. Similarly, the Python_
(or
- IPython_) shell can be used as **a powerful calculator** that
- handles quantities with uncertainties (``print`` statements are
- optional, which is convenient).
-
- - **Correlations** between expressions are correctly taken into
- account. Thus, ``x-x`` is exactly zero, for instance (most
- implementations found on the web yield a non-zero uncertainty for
- ``x-x``, which is incorrect).
-
- - **Almost all mathematical operations** are supported, including most
- functions from the standard math_ module (sin,...). Comparison
- operators (``>``, ``==``, etc.) are supported too.
-
- - Many **fast operations on arrays and matrices** of numbers with
- uncertainties are supported.
-
- - **Extensive support for printing** numbers with uncertainties
- (including LaTeX support and pretty-printing).
-
- - Most uncertainty calculations are performed **analytically**.
-
- - This module also gives access to the **derivatives** of any
- mathematical expression (they are used by error
- propagation theory, and are thus automatically calculated by this
- module).
-
-
- Installation or upgrade
- =======================
-
- Installation instructions are available on the `main web site
-
<http://uncertainties-python-package.readthedocs.io/en/latest/index.html#installation-and-download>`_
- for this package.
-
- Contact
- =======
-
- Please send **feature requests, bug reports, or feedback** to
- `Eric O. LEBIGOT (EOL)`_.
-
- Version history
- ===============
-
- Main changes:
-
- - 3.1.5: added a "p" formatting option, that makes sure that there are
always
- parentheses around the ??? ?? ??? part of printed numbers.
- - 3.1.4: Python 2.7+ is now required.
- - 3.1.2: Fix for NumPy 1.17 and ``unumpy.ulinalg.pinv()``.
- - 3.1: Variables built through a correlation or covariance matrix, and
that
- have uncertainties that span many orders of magnitude are now
- calculated more accurately (improved ``correlated_values()`` and
- ``correlated_values_norm()`` functions).
- - 3.0: Massive speedup for some operations involving large numbers of
numbers with uncertainty, like ``sum(ufloat(1, 1) for _ in xrange(100000))``
(this is about 5,000 times faster than before).
- - 2.4.8: Friendlier completions in Python shells, etc.: internal
functions should not appear anymore (for the user modules: ``uncertainties``,
``uncertainties.umath`` and ``uncertainties.unumpy``). Parsing the shorthand
notation (e.g. ``3.1(2)``) now works with infinite values (e.g. ``-inf(inf)``);
this mirrors the ability to print such numbers with uncertainty. The Particle
Data Group rounding rule is applied in more cases (e.g. printing 724.2??26.2
now gives ``724??26``). The shorthand+LaTeX formatting of numbers with an
infinite nominal value is fixed. ``uncertainties.unumpy.matrix`` now uses
``.std_devs`` instead of ``.std_devs()``, for consistency with floats with
uncertainty (automatic conversion of code added to ``uncertainties.1to2``).
- - 2.4.7: String formatting now works for ``(-)inf+/-...`` numbers.
- - 2.4.5: String formatting now works for ``NaN+/-...`` numbers.
- - 2.4.4: The documentation license now allows its commercial use.
- - 2.4.2: `NumPy 1.8 compatibility
<https://github.com/numpy/numpy/issues/4063>`_.
- - 2.4.1: In ``uncertainties.umath``, functions ``ceil()``, ``floor()``,
- ``isinf()``, ``isnan()`` and ``trunc()`` now return values of
- the same type as the corresponding ``math`` module function
- (instead of generally returning a value with a zero uncertainty
- ``...+/-0``).
- - 2.4: Extensive support for the formatting_ of numbers with
uncertainties.
- A zero uncertainty is now explicitly displayed as the integer 0.
- The new formats are generally understood by ``ufloat_fromstr()``.
- Abbreviations for the nominal value (``n``) and the standard
- deviation (``s``) are now available.
- - 2.3.6: Full support for limit cases of the power operator
- ``umath.pow()``.
- - 2.3.5: Uncertainties and derivatives can now be NaN (not-a-number).
- Full support for numbers with a zero uncertainty
- (``sqrt(ufloat(0, 0))`` now works).
- Full support for limit cases of the power operator (``x**y``).
- - 2.3: Functions wrapped
- so that they accept numbers with uncertainties instead of floats
- now have full keyword arguments support
- (improved ``wrap()`` function). Incompatible change:
- ``wrap(..., None)`` should be replaced by ``wrap(...)`` or
- ``wrap(..., [])``.
- - 2.2: Creating arrays and matrices of numbers with uncertainties
- with ``uarray()`` and ``umatrix()`` now requires two simple arguments
- (nominal values and standard deviations) instead of a tuple argument.
- This is consistent with the new, simpler ``ufloat()`` interface.
- The previous
- usage will be supported for some time. Users are encouraged to update
- their code, for instance through the newly provided `code updater`_,
- which in addition now automatically converts ``.set_std_dev(v)`` to
- ``.std_dev = v``.
- - 2.1: Numbers with uncertainties are now created more directly like
- ``ufloat(3, 0.1)``, ``ufloat(3, 0.1, "pi")``,
- ``ufloat_fromstr("3.0(1)")``, or ``ufloat_fromstr("3.0(1)", "pi")``.
- The previous ``ufloat((3, 0.1))`` and ``ufloat("3.0(1)")`` forms
- will be supported for some time. Users are encouraged to update
- their code, for instance through the newly provided `code updater`_.
- - 2.0: The standard deviation is now obtained more directly without an
- explicit
- call (``x.std_dev`` instead of ``x.std_dev()``). ``x.std_dev()``
- will be supported for some time. Users are encouraged to update
- their code. The standard deviation of a variable can now be
- directly updated with ``x.std_dev = 0.1``. As a consequence,
- ``x.set_std_dev()`` is deprecated.
- - 1.9.1: Support added for pickling subclasses of ``UFloat`` (=
``Variable``).
- - 1.9: Added functions for handling correlation matrices:
- ``correlation_matrix()`` and
- ``correlated_values_norm()``. (These new functions mirror the
- covariance-matrix based ``covariance_matrix()`` and
- ``correlated_values()``.) ``UFloat.position_in_sigmas()`` is
- now named ``UFloat.std_score()``, so as to follow the common
- naming convention (`standard score
- <http://en.wikipedia.org/wiki/Standard_score>`_). Obsolete
- functions were removed (from the main module:
- ``NumberWithUncert``, ``num_with_uncert``, ``array_u``,
- ``nominal_values``, ``std_devs``).
- - 1.8: Compatibility with Python 3.2 added.
- - 1.7.2: Compatibility with Python 2.3, Python 2.4, Jython 2.5.1 and
- Jython 2.5.2 added.
- - 1.7.1: New semantics: ``ufloat("12.3(78)")`` now represents
12.3+/-7.8
- instead of 12.3+/-78.
- - 1.7: ``ufloat()`` now raises ValueError instead of a generic
Exception,
- when given an incorrect
- string representation, like ``float()`` does.
- - 1.6: Testing whether an object is a number with uncertainty should
now
- be done with ``isinstance(..., UFloat)``.
- ``AffineScalarFunc`` is not imported by ``from uncertainties import
*``
- anymore, but its new alias ``UFloat`` is.
- - 1.5.5: The first possible license is now the Revised BSD License
- instead of GPLv2, which
- makes it easier to include this package in other projects.
- - 1.5.4.2: Added ``umath.modf()`` and ``umath.frexp()``.
- - 1.5.4: ``ufloat`` does not accept a single number (nominal value)
anymore.
- This removes some potential confusion about
- ``ufloat(1.1)`` (zero uncertainty) being different from
- ``ufloat("1.1")`` (uncertainty of 1 on the last digit).
- - 1.5.2: ``float_u``, ``array_u`` and ``matrix_u`` renamed ``ufloat``,
- ``uarray`` and ``umatrix``, for ease of typing.
- - 1.5: Added functions ``nominal_value`` and ``std_dev``, and
- modules ``unumpy`` (additional support for NumPy_ arrays and
- matrices) and ``unumpy.ulinalg`` (generalization of some
- functions from ``numpy.linalg``).
- Memory footprint of arrays of numbers with uncertainties
- divided by 3.
- Function ``array_u`` is 5 times faster.
- Main function ``num_with_uncert`` renamed
- ``float_u``, for consistency with ``unumpy.array_u`` and
- ``unumpy.matrix_u``, with the added benefit of a shorter name.
- - 1.4.5: Added support for the standard ``pickle`` module.
- - 1.4.2: Added support for the standard ``copy`` module.
- - 1.4: Added utilities for manipulating NumPy_ arrays of numbers with
- uncertainties (``array_u``, ``nominal_values`` and ``std_devs``).
- - 1.3: Numbers with uncertainties are now constructed with
- ``num_with_uncert()``, which replaces ``NumberWithUncert()``. This
- simplifies the class hierarchy by removing the ``NumberWithUncert``
class.
- - 1.2.5: Numbers with uncertainties can now be entered as
- ``NumberWithUncert("1.23+/-0.45")`` too.
- - 1.2.3: ``log(x, base)`` is now supported by ``umath.log()``, in
addition
- to ``log(x)``.
- - 1.2.2: Values with uncertainties are now output like 3+/-1, in order
- to avoid confusing 3+-1 with 3+(-1).
- - 1.2: A new function, ``wrap()``, is exposed, which allows non-Python
- functions (e.g. Fortran or C used through a module such as SciPy) to
- handle numbers with uncertainties.
- - 1.1: Mathematical functions (such as cosine, etc.) are in a new
- uncertainties.umath module;
- they do not override functions from the ``math`` module anymore.
- - 1.0.12: Main class (``Number_with_uncert``) renamed
``NumberWithUncert``
- so as to follow `PEP 8`_.
- - 1.0.11: ``origin_value`` renamed more appropriately as
- ``nominal_value``.
- - 1.0.9: ``correlations()`` renamed more appropriately as
- ``covariance_matrix()``.
-
- .. _Python: http://docs.python.org/tutorial/interpreter.html
- .. _IPython: http://ipython.readthedocs.io/en/stable/
- .. _NumPy: http://numpy.scipy.org/
- .. _math: http://docs.python.org/library/math.html
- .. _PEP 8: http://www.python.org/dev/peps/pep-0008/
- .. _error propagation theory:
http://en.wikipedia.org/wiki/Propagation_of_uncertainty
- .. _Eric O. LEBIGOT (EOL): mailto:eric.lebi...@normalesup.org
- .. _PayPal:
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4TK7KNDTEDT4S
- .. _main website: http://uncertainties-python-package.readthedocs.io/
- .. _code updater:
http://uncertainties-python-package.readthedocs.io/en/latest/index.html#migration-from-version-1-to-version-2
- .. _formatting:
http://uncertainties-python-package.readthedocs.io/en/latest/user_guide.html#printing
+Project-URL: Source, https://github.com/lebigot/uncertainties
Keywords: error propagation,uncertainties,uncertainty calculations,standard
deviation,derivatives,partial derivatives,differentiation
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
@@ -280,7 +39,252 @@
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
+Provides-Extra: optional
Provides-Extra: docs
Provides-Extra: tests
-Provides-Extra: optional
Provides-Extra: all
+License-File: LICENSE.txt
+
+Overview
+========
+
+``uncertainties`` allows **calculations** such as (2 +/- 0.1)*2 = 4 +/-
+0.2 to be **performed transparently**. Much more complex mathematical
+expressions involving numbers with uncertainties can also be evaluated
+directly.
+
+The ``uncertainties`` package **takes the pain and complexity out**
+of uncertainty calculations.
+
+**Detailed information** about this package can be found on its `main
+website`_.
+
+Basic examples
+==============
+
+.. code-block:: python
+
+ >>> from uncertainties import ufloat
+
+ >>> x = ufloat(2, 0.25)
+ >>> x
+ 2.0+/-0.25
+
+ >>> square = x**2 # Transparent calculations
+ >>> square
+ 4.0+/-1.0
+ >>> square.nominal_value
+ 4.0
+ >>> square.std_dev # Standard deviation
+ 1.0
+
+ >>> square - x*x
+ 0.0 # Exactly 0: correlations taken into account
+
+ >>> from uncertainties.umath import * # sin(), etc.
+ >>> sin(1+x**2)
+ -0.95892427466313845+/-0.2836621854632263
+
+ >>> print (2*x+1000).derivatives[x] # Automatic calculation of derivatives
+ 2.0
+
+ >>> from uncertainties import unumpy # Array manipulation
+ >>> random_vars = unumpy.uarray([1, 2], [0.1, 0.2])
+ >>> print random_vars
+ [1.0+/-0.1 2.0+/-0.2]
+ >>> print random_vars.mean()
+ 1.50+/-0.11
+ >>> print unumpy.cos(random_vars)
+ [0.540302305868+/-0.0841470984808 -0.416146836547+/-0.181859485365]
+
+Main features
+=============
+
+- **Transparent calculations with uncertainties**: **no or little
+ modification of existing code** is needed. Similarly, the Python_ (or
+ IPython_) shell can be used as **a powerful calculator** that
+ handles quantities with uncertainties (``print`` statements are
+ optional, which is convenient).
+
+- **Correlations** between expressions are correctly taken into
+ account. Thus, ``x-x`` is exactly zero, for instance (most
+ implementations found on the web yield a non-zero uncertainty for
+ ``x-x``, which is incorrect).
+
+- **Almost all mathematical operations** are supported, including most
+ functions from the standard math_ module (sin,...). Comparison
+ operators (``>``, ``==``, etc.) are supported too.
+
+- Many **fast operations on arrays and matrices** of numbers with
+ uncertainties are supported.
+
+- **Extensive support for printing** numbers with uncertainties
+ (including LaTeX support and pretty-printing).
+
+- Most uncertainty calculations are performed **analytically**.
+
+- This module also gives access to the **derivatives** of any
+ mathematical expression (they are used by error
+ propagation theory, and are thus automatically calculated by this
+ module).
+
+
+Installation or upgrade
+=======================
+
+Installation instructions are available on the `main web site
+<http://uncertainties-python-package.readthedocs.io/en/latest/index.html#installation-and-download>`_
+for this package.
+
+Contact
+=======
+
+Please send **feature requests, bug reports, or feedback** to
+`Eric O. LEBIGOT (EOL)`_.
+
+Version history
+===============
+
+Main changes:
+
+- 3.1.6: the pretty-print and LaTeX format can now be customized.
+- 3.1.5: added a "p" formatting option, that makes sure that there are always
+ parentheses around the ??? ?? ??? part of printed numbers.
+- 3.1.4: Python 2.7+ is now required.
+- 3.1.2: Fix for NumPy 1.17 and ``unumpy.ulinalg.pinv()``.
+- 3.1: Variables built through a correlation or covariance matrix, and that
+ have uncertainties that span many orders of magnitude are now
+ calculated more accurately (improved ``correlated_values()`` and
+ ``correlated_values_norm()`` functions).
+- 3.0: Massive speedup for some operations involving large numbers of numbers
with uncertainty, like ``sum(ufloat(1, 1) for _ in xrange(100000))`` (this is
about 5,000 times faster than before).
+- 2.4.8: Friendlier completions in Python shells, etc.: internal functions
should not appear anymore (for the user modules: ``uncertainties``,
``uncertainties.umath`` and ``uncertainties.unumpy``). Parsing the shorthand
notation (e.g. ``3.1(2)``) now works with infinite values (e.g. ``-inf(inf)``);
this mirrors the ability to print such numbers with uncertainty. The Particle
Data Group rounding rule is applied in more cases (e.g. printing 724.2??26.2
now gives ``724??26``). The shorthand+LaTeX formatting of numbers with an
infinite nominal value is fixed. ``uncertainties.unumpy.matrix`` now uses
``.std_devs`` instead of ``.std_devs()``, for consistency with floats with
uncertainty (automatic conversion of code added to ``uncertainties.1to2``).
+- 2.4.7: String formatting now works for ``(-)inf+/-...`` numbers.
+- 2.4.5: String formatting now works for ``NaN+/-...`` numbers.
+- 2.4.4: The documentation license now allows its commercial use.
+- 2.4.2: `NumPy 1.8 compatibility
<https://github.com/numpy/numpy/issues/4063>`_.
+- 2.4.1: In ``uncertainties.umath``, functions ``ceil()``, ``floor()``,
+ ``isinf()``, ``isnan()`` and ``trunc()`` now return values of
+ the same type as the corresponding ``math`` module function
+ (instead of generally returning a value with a zero uncertainty
+ ``...+/-0``).
+- 2.4: Extensive support for the formatting_ of numbers with uncertainties.
+ A zero uncertainty is now explicitly displayed as the integer 0.
+ The new formats are generally understood by ``ufloat_fromstr()``.
+ Abbreviations for the nominal value (``n``) and the standard
+ deviation (``s``) are now available.
+- 2.3.6: Full support for limit cases of the power operator
+ ``umath.pow()``.
+- 2.3.5: Uncertainties and derivatives can now be NaN (not-a-number).
+ Full support for numbers with a zero uncertainty
+ (``sqrt(ufloat(0, 0))`` now works).
+ Full support for limit cases of the power operator (``x**y``).
+- 2.3: Functions wrapped
+ so that they accept numbers with uncertainties instead of floats
+ now have full keyword arguments support
+ (improved ``wrap()`` function). Incompatible change:
+ ``wrap(..., None)`` should be replaced by ``wrap(...)`` or
+ ``wrap(..., [])``.
+- 2.2: Creating arrays and matrices of numbers with uncertainties
+ with ``uarray()`` and ``umatrix()`` now requires two simple arguments
+ (nominal values and standard deviations) instead of a tuple argument.
+ This is consistent with the new, simpler ``ufloat()`` interface.
+ The previous
+ usage will be supported for some time. Users are encouraged to update
+ their code, for instance through the newly provided `code updater`_,
+ which in addition now automatically converts ``.set_std_dev(v)`` to
+ ``.std_dev = v``.
+- 2.1: Numbers with uncertainties are now created more directly like
+ ``ufloat(3, 0.1)``, ``ufloat(3, 0.1, "pi")``,
+ ``ufloat_fromstr("3.0(1)")``, or ``ufloat_fromstr("3.0(1)", "pi")``.
+ The previous ``ufloat((3, 0.1))`` and ``ufloat("3.0(1)")`` forms
+ will be supported for some time. Users are encouraged to update
+ their code, for instance through the newly provided `code updater`_.
+- 2.0: The standard deviation is now obtained more directly without an
+ explicit
+ call (``x.std_dev`` instead of ``x.std_dev()``). ``x.std_dev()``
+ will be supported for some time. Users are encouraged to update
+ their code. The standard deviation of a variable can now be
+ directly updated with ``x.std_dev = 0.1``. As a consequence,
+ ``x.set_std_dev()`` is deprecated.
+- 1.9.1: Support added for pickling subclasses of ``UFloat`` (= ``Variable``).
+- 1.9: Added functions for handling correlation matrices:
+ ``correlation_matrix()`` and
+ ``correlated_values_norm()``. (These new functions mirror the
+ covariance-matrix based ``covariance_matrix()`` and
+ ``correlated_values()``.) ``UFloat.position_in_sigmas()`` is
+ now named ``UFloat.std_score()``, so as to follow the common
+ naming convention (`standard score
+ <http://en.wikipedia.org/wiki/Standard_score>`_). Obsolete
+ functions were removed (from the main module:
+ ``NumberWithUncert``, ``num_with_uncert``, ``array_u``,
+ ``nominal_values``, ``std_devs``).
+- 1.8: Compatibility with Python 3.2 added.
+- 1.7.2: Compatibility with Python 2.3, Python 2.4, Jython 2.5.1 and
+ Jython 2.5.2 added.
+- 1.7.1: New semantics: ``ufloat("12.3(78)")`` now represents 12.3+/-7.8
+ instead of 12.3+/-78.
+- 1.7: ``ufloat()`` now raises ValueError instead of a generic Exception,
+ when given an incorrect
+ string representation, like ``float()`` does.
+- 1.6: Testing whether an object is a number with uncertainty should now
+ be done with ``isinstance(..., UFloat)``.
+ ``AffineScalarFunc`` is not imported by ``from uncertainties import *``
+ anymore, but its new alias ``UFloat`` is.
+- 1.5.5: The first possible license is now the Revised BSD License
+ instead of GPLv2, which
+ makes it easier to include this package in other projects.
+- 1.5.4.2: Added ``umath.modf()`` and ``umath.frexp()``.
+- 1.5.4: ``ufloat`` does not accept a single number (nominal value) anymore.
+ This removes some potential confusion about
+ ``ufloat(1.1)`` (zero uncertainty) being different from
+ ``ufloat("1.1")`` (uncertainty of 1 on the last digit).
+- 1.5.2: ``float_u``, ``array_u`` and ``matrix_u`` renamed ``ufloat``,
+ ``uarray`` and ``umatrix``, for ease of typing.
+- 1.5: Added functions ``nominal_value`` and ``std_dev``, and
+ modules ``unumpy`` (additional support for NumPy_ arrays and
+ matrices) and ``unumpy.ulinalg`` (generalization of some
+ functions from ``numpy.linalg``).
+ Memory footprint of arrays of numbers with uncertainties
+ divided by 3.
+ Function ``array_u`` is 5 times faster.
+ Main function ``num_with_uncert`` renamed
+ ``float_u``, for consistency with ``unumpy.array_u`` and
+ ``unumpy.matrix_u``, with the added benefit of a shorter name.
+- 1.4.5: Added support for the standard ``pickle`` module.
+- 1.4.2: Added support for the standard ``copy`` module.
+- 1.4: Added utilities for manipulating NumPy_ arrays of numbers with
+ uncertainties (``array_u``, ``nominal_values`` and ``std_devs``).
+- 1.3: Numbers with uncertainties are now constructed with
+ ``num_with_uncert()``, which replaces ``NumberWithUncert()``. This
+ simplifies the class hierarchy by removing the ``NumberWithUncert`` class.
+- 1.2.5: Numbers with uncertainties can now be entered as
+ ``NumberWithUncert("1.23+/-0.45")`` too.
+- 1.2.3: ``log(x, base)`` is now supported by ``umath.log()``, in addition
+ to ``log(x)``.
+- 1.2.2: Values with uncertainties are now output like 3+/-1, in order
+ to avoid confusing 3+-1 with 3+(-1).
+- 1.2: A new function, ``wrap()``, is exposed, which allows non-Python
+ functions (e.g. Fortran or C used through a module such as SciPy) to
+ handle numbers with uncertainties.
+- 1.1: Mathematical functions (such as cosine, etc.) are in a new
+ uncertainties.umath module;
+ they do not override functions from the ``math`` module anymore.
+- 1.0.12: Main class (``Number_with_uncert``) renamed ``NumberWithUncert``
+ so as to follow `PEP 8`_.
+- 1.0.11: ``origin_value`` renamed more appropriately as
+ ``nominal_value``.
+- 1.0.9: ``correlations()`` renamed more appropriately as
+ ``covariance_matrix()``.
+
+.. _Python: http://docs.python.org/tutorial/interpreter.html
+.. _IPython: http://ipython.readthedocs.io/en/stable/
+.. _NumPy: http://numpy.scipy.org/
+.. _math: http://docs.python.org/library/math.html
+.. _PEP 8: http://www.python.org/dev/peps/pep-0008/
+.. _error propagation theory:
http://en.wikipedia.org/wiki/Propagation_of_uncertainty
+.. _Eric O. LEBIGOT (EOL): mailto:eric.lebi...@normalesup.org
+.. _PayPal:
https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=4TK7KNDTEDT4S
+.. _main website: http://uncertainties-python-package.readthedocs.io/
+.. _code updater:
http://uncertainties-python-package.readthedocs.io/en/latest/index.html#migration-from-version-1-to-version-2
+.. _formatting:
http://uncertainties-python-package.readthedocs.io/en/latest/user_guide.html#printing
+
diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn'
'--exclude=.svnignore'
old/uncertainties-3.1.5/uncertainties.egg-info/requires.txt
new/uncertainties-3.1.6/uncertainties.egg-info/requires.txt
--- old/uncertainties-3.1.5/uncertainties.egg-info/requires.txt 2020-11-18
09:25:46.000000000 +0100
+++ new/uncertainties-3.1.6/uncertainties.egg-info/requires.txt 2021-07-11
22:55:37.000000000 +0200
@@ -1,9 +1,9 @@
future
[all]
+nose
numpy
sphinx
-nose
[docs]
sphinx
