pynumerics 2.3.0__py3-none-any.whl

pynumerics-2.3.0.dist-info/METADATA

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: pynumerics
+Version: 2.3.0
+Summary: RMC.Numerics for Python: probability distributions, statistics, MCMC, optimization and numerical methods from the USACE-RMC Numerics library.
+Author-email: Haden Smith <cole.h.smith@usace.army.mil>
+License-Expression: 0BSD
+Project-URL: Homepage, https://github.com/USACE-RMC/Numerics
+Project-URL: Documentation, https://github.com/USACE-RMC/Numerics/tree/main/python/pynumerics/docs
+Project-URL: Repository, https://github.com/USACE-RMC/Numerics
+Project-URL: Issues, https://github.com/USACE-RMC/Numerics/issues
+Project-URL: Changelog, https://github.com/USACE-RMC/Numerics/blob/main/python/pynumerics/CHANGELOG.md
+Keywords: statistics,probability distributions,hydrology,flood frequency analysis,L-moments,MCMC,optimization,Monte Carlo,uncertainty analysis,pythonnet
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Hydrology
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Classifier: Typing :: Typed
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pythonnet<3.2,>=3.1
+Requires-Dist: numpy>=1.26
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Requires-Dist: numpydoc>=1.8; extra == "test"
+Requires-Dist: ruff>=0.6; extra == "test"
+Requires-Dist: scipy>=1.11; extra == "test"
+Requires-Dist: statsmodels>=0.14; extra == "test"
+Requires-Dist: scikit-learn>=1.3; extra == "test"
+Requires-Dist: shapely>=2.0; extra == "test"
+Requires-Dist: arviz<1,>=0.17; extra == "test"
+Requires-Dist: dataretrieval>=1.4; extra == "test"
+Requires-Dist: wetterdienst>=0.184; extra == "test"
+Requires-Dist: kiwis-pie>=0.10.5; extra == "test"
+Provides-Extra: docs
+Requires-Dist: sphinx<10,>=8; extra == "docs"
+Requires-Dist: numpydoc>=1.8; extra == "docs"
+Requires-Dist: myst-parser>=4; extra == "docs"
+Dynamic: license-file
+
+# pynumerics
+
+RMC.Numerics for Python. The wheel ships the `Numerics.dll` assembly from the published
+`RMC.Numerics` NuGet package, byte for byte, with a loader that starts one .NET runtime and one
+`Numerics` assembly per process, and typed wrappers over every Numerics area: univariate and
+multivariate distributions, copulas, statistics, hypothesis tests, sampling, MCMC and the
+bootstrap, integration, differentiation, root finding and ODEs, optimization, special functions,
+linear algebra and Fourier transforms, data and time series, and machine learning.
+
+The wrappers do no numerical work in Python. Arrays cross between NumPy and .NET in bulk, bit for
+bit, every wrapper raises Python exceptions with the Numerics messages, and functions can be
+Python callables or C# source compiled with the bundled Roslyn compiler. The distribution version
+equals the RMC.Numerics version of the bundled assembly.
+
+## Install
+
+```bash
+pip install pynumerics==2.3.0
+```
+
+The 2.3.0 wheel bundles `Numerics.dll` from the RMC.Numerics 2.3.0 NuGet package. Requirements:
+CPython 3.11 to 3.14 on Linux or Windows, and the .NET 10 runtime (`Microsoft.NETCore.App` 10.0).
+Set `DOTNET_ROOT` when .NET is not installed in the default location.
+
+```python
+from pynumerics import distributions
+
+gev = distributions.GeneralizedExtremeValue(location=10.0, scale=2.0, shape=-0.1)
+print(gev.inverse_cdf([0.5, 0.99, 0.999]))   # one call into InverseCDF(IList<double>)
+```
+
+## Documentation
+
+The user guide and the API reference are in
+[`docs/`](https://github.com/USACE-RMC/Numerics/tree/main/python/pynumerics/docs): start with
+[getting started](https://github.com/USACE-RMC/Numerics/blob/main/python/pynumerics/docs/getting-started.md),
+which covers installation, `PYNUMERICS_DLL_DIR` and runtime selection, arrays and errors, value
+semantics, callbacks and migration from rmc-numerics. The
+[changelog](https://github.com/USACE-RMC/Numerics/blob/main/python/pynumerics/CHANGELOG.md) lists
+the changes of each release. Build the HTML pages, including the API
+reference generated from the docstrings, from `python/pynumerics`:
+
+```bash
+python -m pip install -e ".[docs]"
+python -m sphinx -W --keep-going -b html docs docs/_build/html
+```
+
+Releases are published to PyPI by `.github/workflows/PythonPublish.yml` with trusted publishing.
+It starts by itself when `NuGetPublish.yml` has pushed RMC.Numerics X.Y.Z to nuget.org for the
+GitHub Release `vX.Y.Z`: it waits until nuget.org serves the package, builds the wheel from it,
+tests it on Linux and Windows, and uploads it to TestPyPI and then, after the `pypi` environment's
+reviewer approves, to PyPI. `_version.py` must already declare X.Y.Z; no commit is needed after the
+NuGet release, because the wheel build writes the package's SHA-256 into the wheel.
+
+## Build and test
+
+From `python/pynumerics`:
+
+```bash
+python scripts/build_wheel.py --stage-only       # stage _bin/Numerics.dll and the Roslyn assemblies
+python -m pip install -e ".[test]"
+python -m pytest                                  # includes tests/test_docs.py: every docs code block
+python scripts/build_wheel.py                    # build dist/pynumerics-<version>-py3-none-any.whl
+```
+
+The script takes `Numerics.dll` from `lib/net10.0` of the `RMC.Numerics` package in the
+NuGet global packages folder (or `--nupkg PATH`, or `--download` from nuget.org), or a locally
+built assembly with `--dll PATH`. It reads the version, the assembly version and the SHA-256 of
+that file, refuses a version or assembly version that differs from `src/pynumerics/_version.py`,
+and writes all three into the wheel's `_version.py` (the tracked file keeps `NUMERICS_SHA256`
+empty, so `assert_numerics_identity()` needs an explicit `sha256` in a source checkout). It stages
+`Microsoft.CodeAnalysis.dll` and `Microsoft.CodeAnalysis.CSharp.dll` from `lib/net9.0` of the
+Microsoft.CodeAnalysis.Common and Microsoft.CodeAnalysis.CSharp 4.14.0 packages (NuGet cache, or
+`--download`), each checked against its `ROSLYN_*_SHA256` pin; `--roslyn-only` stages only those.
+To test against a locally built assembly, set `PYNUMERICS_DLL_DIR` to
+`Numerics/bin/Release/net10.0`, or build a wheel from it as the pull request check does:
+
+```bash
+dotnet build ../../Numerics/Numerics.csproj -c Release -f net10.0
+python scripts/build_wheel.py --dll ../../Numerics/bin/Release/net10.0/Numerics.dll --download
+```
+
+The same checks run on Linux in the `.github/docker/linux-test` image, from the repository root:
+
+```bash
+docker build -t numerics-linux-test .github/docker/linux-test
+docker run --rm -v "$PWD:/src:ro" -v "$PWD/python/pynumerics/dist:/out" numerics-linux-test
+docker run --rm -v "$PWD/python/pynumerics/dist:/dist:ro" numerics-linux-test identity-check.sh /dist
+```
+
+The first run builds and tests `Test_Numerics` (net10.0), builds the wheel from that build and runs
+ruff and pytest against it; `CHECKS="wheel pytest"` skips the .NET tests. The second installs the
+wheel in a fresh container and checks the identity of the loaded assembly.

pynumerics-2.3.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+pynumerics/__init__.py,sha256=dOafW81iFD3vP5Yjh-rwhSsNUV6-3NhIHM-Nur8xTSM,3024
+pynumerics/_coverage.py,sha256=fC0P9_MJ-zvXK0Kt51tuUAJJfPnZAelSvkDlzE8shwA,159546
+pynumerics/_util.py,sha256=_UNGxnnk0H7W6M_A2XnEydbe89JYfXoSrcU1BfCMgw0,9540
+pynumerics/_version.py,sha256=rmJMKTwQcN7iprdircT3aImCrRvIgb9DksEYdrU0pdU,2349
+pynumerics/bootstrap.py,sha256=vVI8qvRU8hFtRUFJKDtvIrMkSL0UtbW0licrZCI9RL4,23113
+pynumerics/callbacks.py,sha256=nBC2G4ky60ppwOy30TvFo8nKxlSbKNh24aOHO5QTxHk,35208
+pynumerics/copulas.py,sha256=hHaTQ7HLS7s9zyu3Nzgp2b6lf7sYCs7m6us0c2idgyo,31530
+pynumerics/data.py,sha256=JtYd-JiJ27znufZ0M0Wmuhi4DbtrQRtV-UBBWLk_yng,75694
+pynumerics/differentiation.py,sha256=758_VFRtIMWaaB2j2pjku0npPsV5tXmHTxzBQkCI-H0,11856
+pynumerics/distributions.py,sha256=DAqWvWZIl_qnr4jVYLAN8YYtVKCIJapHhhtyv9TJpe8,153974
+pynumerics/download.py,sha256=bkACVdW3Z3VPsnWA8j2g5w9m8OKlc9kGjqVchyKGpQ4,25240
+pynumerics/enums.py,sha256=YtZOl1mHQk4yR43V7HQCAohjxyW2ysWk_6NI8zw10L0,3507
+pynumerics/errors.py,sha256=8uH1CQQsH8mgnykbOvyyaBvmdoaLZ5F_qhecbSbTNAI,8861
+pynumerics/functions.py,sha256=wjIXsdiu5gAfWcLabr3iG1IWLg99DmeePPtaVWbGlvA,36782
+pynumerics/goodness_of_fit.py,sha256=ltAjvaEQRK05Iwu2lBWiGDY6TULtpn9EX18olNWxCu0,21556
+pynumerics/graphs.py,sha256=D433cVFgGqpwkQvtogvSmQ4n0EWPsXarUyjHZaEdu1k,20641
+pynumerics/hypothesis_tests.py,sha256=juDu2HwZ18ZuLJXNmkGv6sV28o76nezAUMJlfxb7tLI,14406
+pynumerics/identity.py,sha256=3NOLZ-d1Vglj4lwH5gmgNtFjRTcALSz3Kg1dPyow3NY,4975
+pynumerics/integration.py,sha256=0faKhGFazAgVptFLx_Ulm3Q4ZnoXQp-ZQaMTa319gJY,26697
+pynumerics/linalg.py,sha256=-QICcLbfGcQlP8ghNDut2k-PZa8JCxNK4VboKs9xAOI,44432
+pynumerics/machine_learning.py,sha256=4sZlkDy6cSsYR-wDgOXQE15K48Ra2tfcSuMMyq7Z8Ts,55730
+pynumerics/marshal.py,sha256=ANAEwwswNLwskvuxbbVNpMlJIK8pzzyO6PXuY7lWGWE,29725
+pynumerics/mathematics.py,sha256=uOHarZxvzy8NQSg5MpxPSD_J3Rgq-t_JwSlugAqdXCY,34440
+pynumerics/mcmc.py,sha256=TyapgjflhRo2dbJS96jnk-vyT_qUvrfYYQbzqoSUDow,54847
+pynumerics/multivariate.py,sha256=9f6FYicp0F0OwvbZo2LIxqM8Dn8KgLsqJnGl-CvSwRs,53865
+pynumerics/ode.py,sha256=b9o5MkD3fCyShMrSIjqK8EsoC5qi4iZxvKJT-GYn_ss,5530
+pynumerics/optimization.py,sha256=Ml9vKJzXpoTgtjXPN86L3tsdRF-_ifLLga0CedWhyw0,68816
+pynumerics/probability.py,sha256=tAvrV8bW5YBWOXeS5B7R6k0wKLCoKRVtuQgRon1LtSc,38502
+pynumerics/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pynumerics/regional.py,sha256=GQSndcYxY8cUcr3QXFjDhjqBL03SrgNbYmoKwHuAoUA,19478
+pynumerics/roots.py,sha256=FQ_ySvg9Mdcywi2MqnCEA6Ajt5rcQqX_DGQ-ohVxzW4,10611
+pynumerics/runtime.py,sha256=ykDBH3ddNclv2tnt3SmR86z9LZnxvm06jP97lIpFNpE,15586
+pynumerics/sampling.py,sha256=gU0Mx5lNDIOnbpCNU4Zc_PlgPDQBFWmc8zHnB14Gx-g,64219
+pynumerics/special.py,sha256=Db_oVF5lPj4lKd1fK2xWj92ML1jh2ILmHj3ezGAVbRY,31382
+pynumerics/statistics.py,sha256=arEPhLLP3Sin11-8hvqpKTakq7-d-5lyBlDbIaLnrtg,67081
+pynumerics/timeseries.py,sha256=6U0j9_DfbpOiPSRWUl3PAcUVXNrK9sH3r9klq4VSOs0,48059
+pynumerics/_bin/Microsoft.CodeAnalysis.CSharp.dll,sha256=UzAqzKB3AOm7ENzyEDRDXW4EVMjuvySBFk7BPlIABMk,6697768
+pynumerics/_bin/Microsoft.CodeAnalysis.LICENSE.txt,sha256=duQve0z_0t1xNkgM5-7WxP4EbY_Nfp41SJi4L_zLmPQ,1387
+pynumerics/_bin/Microsoft.CodeAnalysis.dll,sha256=OVc2stDgK-d77cOEeyadp6k7-OSc00MaSo5o0sUtWEY,3029800
+pynumerics/_bin/Numerics.dll,sha256=aLQ351QaOiy6pinsvDsHSUHvN9pYkZyXzcZlSx5juZI,5522944
+pynumerics/_bin/pynumerics.runtimeconfig.json,sha256=g63qT8IFP6lkG0OCIdPZNdXjJ55wceunvcfebo_heIk,438
+pynumerics-2.3.0.dist-info/licenses/LICENSE,sha256=h4l39CyRqWjAKyAQWGEIMpCyCix2emGLLyro-RM8kkU,607
+pynumerics-2.3.0.dist-info/METADATA,sha256=nupXJn1u9IATE3-ovB4ciW46GK3CU4Kc5kvM4-R8fk8,7416
+pynumerics-2.3.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+pynumerics-2.3.0.dist-info/top_level.txt,sha256=AEhi5LEx-TNiV6TeUF7OlKtg342vH6LpCJakhbW291Y,11
+pynumerics-2.3.0.dist-info/RECORD,,

pynumerics-2.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pynumerics-2.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,10 @@
+Permission to use, copy, modify, and/or distribute this software for
+any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
+WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE
+FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
+DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
+AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

pynumerics-2.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pynumerics