pygnss 2.1.2__cp314-cp314t-macosx_11_0_arm64.whl

pygnss-2.1.2.dist-info/METADATA

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: pygnss
+Version: 2.1.2
+Summary: Package with utilities and tools for GNSS data processing
+Author-email: Miquel Garcia-Fernandez <miquel@mgfernan.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mgfernan/pygnss
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: nequick>=0.2.0
+Requires-Dist: numpy
+Requires-Dist: pandas>=2.2
+Requires-Dist: pyarrow>=18.0.0
+Provides-Extra: test
+Requires-Dist: pytest>=8.3.4; extra == "test"
+Requires-Dist: pytest-env>=1.1.5; extra == "test"
+Requires-Dist: pytest-mocha>=0.4.0; extra == "test"
+Requires-Dist: flake8>=7.0.0; extra == "test"
+Requires-Dist: pnt-datasets>=0.2.2; extra == "test"
+Requires-Dist: package-name>=0.1; extra == "test"
+Provides-Extra: release
+Requires-Dist: python-semantic-release>=9.4.0; extra == "release"
+Dynamic: license-file
+
+# pygnss — GNSS utilities and tools
+
+pygnss is a lightweight collection of utilities for GNSS data processing:
+
+- parsers for Hatanaka (CRX) and RINEX formats,
+- IONEX (GIM) utilities and exporters,
+- small geodetic and ionospheric helpers, and
+- a few filtering tools (particle filter, EKF/UKF helpers) used in demos and tests.
+
+This README gives a short overview for users and contributors: installation,
+development (building the compiled extension), available CLI scripts and
+examples of the most used APIs.
+
+## Installation
+
+Stable release from PyPI (no compiled extension required for pure-Python
+features):
+
+```bash
+pip install pygnss
+```
+
+Developer / editable install (builds the C extension declared in
+`pyproject.toml`). This is the recommended setup when working on the
+repository locally because some features (Hatanaka/CRX parsing) rely on a
+compiled extension for speed.
+
+```bash
+# create and activate a venv
+python -m venv .venv
+source .venv/bin/activate
+# install the package and test/dev extras
+python -m pip install --upgrade pip
+python -m pip install -e '.[test]'
+```
+
+Notes on the compiled extension
+
+- The extension module `pygnss._c_ext` is built from the sources listed in
+  `pyproject.toml` (under [[tool.setuptools.ext-modules]]). Building the
+  package with `pip install .` or `python -m build` will compile it. On CI
+  the workflow provided in `.github/workflows/python-package.yml` creates a
+  virtualenv and runs `pip install -e '.[test]'` to ensure the entry points
+  and compiled modules are available for tests.
+
+## CLI entry points (installed as console scripts)
+
+The package declares several console scripts (see `pyproject.toml`):
+
+- `ionex_diff`  — compare IONEX files or compare an IONEX to NeQuick output
+- `compute_cdf` — utility to compute CDF from data (used by examples)
+- `rinex_from_file`, `rinex_to_parquet`, `merge_rinex_nav` — helpers for
+  RINEX conversions
+
+After installing the package into a venv these commands are available on
+`$PATH` (from `.venv/bin`). Tests rely on the entry points being discoverable
+via PATH in CI, so the workflow prepends `.venv/bin` to PATH before running
+tests.
+
+## Quick usage examples
+
+1. Hatanaka (CRX) -> pandas DataFrame
+
+```python
+from pygnss import hatanaka
+
+df = hatanaka.to_dataframe('station.crx.gz', station='MYST')
+print(df.head())
+```
+
+If the compiled extension is not available the function raises an ImportError
+with instructions to build/install the package (see "Developer" section).
+
+1. Read and diff IONEX maps (programmatic)
+
+```python
+from pygnss import ionex
+from pygnss.iono import gim
+
+# load an ionex and collect VTEC maps
+handler = gim.GimHandlerArray()
+ionex.load('sample.ionex', gim_handler=handler)
+print(len(handler.vtec_gims))
+```
+
+## Running tests locally
+
+With the venv active and the test extras installed the canonical way to run
+the test-suite is:
+
+```bash
+# inside the project root with .venv activated
+python -m pytest -v
+```
+
+If tests call console scripts (such as `ionex_diff`) the venv `bin` directory
+must be on `PATH` so subprocesses can find the entry points. The CI workflow
+prepares the environment accordingly.
+
+## Where to look next
+
+- `pygnss/hatanaka.py` — Hatanaka/CRX parsing wrapper (uses compiled helper)
+- `pygnss/ionex.py`    — IONEX loader/writer and CLI glue
+- `pygnss/filter/`     — particle filter, EKF/UKF helpers and demos

pygnss-2.1.2.dist-info/RECORD

@@ -0,0 +1,44 @@
+pygnss/hatanaka.py,sha256=JHRYWanz0ZtJ14WzNUq88tbhG8ksSRTXzzoIstm78Pw,2928
+pygnss/time.py,sha256=YdMNs2xA43LrSgEOgB7jpEq0dCWv89fUBF5syDLjbu0,11178
+pygnss/ionex.py,sha256=WcY6PVwjzATjqyC0Htc5Jh_cv2a7yz4TZIcD723TpsY,14325
+pygnss/nequick.py,sha256=tSsUw3FoRWS-TBKKVb0_c90DFz_2jUTkUvNPsGQOLA8,1722
+pygnss/sinex.py,sha256=nErOmGCFFmGSnmWGNTJhaj3yZ6IIB8GgtW5WPypJc6U,3057
+pygnss/tensorial.py,sha256=aA0-0WK2MXhDUg0_8HMbECOt9cXmp3EnKFQXjdYMBXA,1598
+pygnss/decorator.py,sha256=qB-0jl2GTEHJdvmDruNll5X3RrdySssv94u9Hok5-lA,1438
+pygnss/constants.py,sha256=1hF6K92X6E6Ofo0rAuCBCgrwln9jxio26RV2a6vyURk,133
+pygnss/__init__.py,sha256=UiuBcRXPtXxPUBDdp0ZDvWl0U9Db1kMNfT3oAfhxqLg,22
+pygnss/cl.py,sha256=ISmd2RjikUMmj3nLPN0VSjvQLG5rLizp2X2ajeBkoDE,4509
+pygnss/logger.py,sha256=4kvcTWXPoiG-MlyP6B330l4Fu7MfCuDjuIlIiLA8f1Y,1479
+pygnss/geodetic.py,sha256=RCXD4_RlzQR2DxNIFGS4iODwZZcnxklMsCw9mohYcBg,33948
+pygnss/_c_ext.cpython-314t-darwin.so,sha256=RqydGDiLmoan0EgC9asFaShTDiG7Avi7DEYAbCffLT8,73920
+pygnss/file.py,sha256=kkMBWjoTPkxJD1UgH0mXJT2fxnhU8u7_l2Ph5Xz2-hY,933
+pygnss/rinex.py,sha256=7pUmnMe8KYMxGEeqYvQI1m8kvoTvLPbKXfxhcwxYfH8,68792
+pygnss/stats.py,sha256=GYZfcyDvbM9xamWIyVlqyN5-DPJzTLJrybRrcNV6Z6o,1912
+pygnss/orbit/kepler.py,sha256=QORTgg5yBtsQXxLWSzoZ1pmh-CwPiZlFdIYqhQhv1a0,1745
+pygnss/orbit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pygnss/orbit/tle.py,sha256=6CIEielPgui3DXNv46XxOGlig31ROIwjH42xLGaeE5M,5905
+pygnss/parsers/rtklib/stats.py,sha256=YV6yadxMeQMQYZvsUCaSf4ZTpK8Bbv3f2xgu0l4PekA,5449
+pygnss/_c_ext/src/constants.c,sha256=-DCFy5gQR_UHmsW94f0f5yu6aVen4OUb5FdYBrlOoss,1809
+pygnss/_c_ext/src/mtable_init.c,sha256=n8jU39bA6sjVHG7U0OUIDTGMpddMytJf7TIjdQHjMA4,1315
+pygnss/_c_ext/src/hatanaka.c,sha256=zqqH4JrC09qbFzLUiHunNGA-ut9HxEQ8Fmy5QR5XeGs,2511
+pygnss/_c_ext/src/klobuchar.c,sha256=YqH1i8SbIR424nAiCHozV4fsSf22365EA5gav3v982o,9956
+pygnss/_c_ext/src/helpers.c,sha256=gINr73ktRgox_S7fYdFR58lLqAUACRpJfog4M5BW1-Q,364
+pygnss/gnss/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pygnss/gnss/edit.py,sha256=T1r0WbJmt8tLJpG_IIsy4Atej6cy0IStBaSGxw0S5ho,1884
+pygnss/gnss/types.py,sha256=lmL15KRckRiTwVkYvGzF4c1BrojnQlegrYCXSz1hGaI,10377
+pygnss/gnss/residuals.py,sha256=8qKGNOYkrqxHGOSjIfH21K82PAqEh2068kf78j5usL8,1244
+pygnss/gnss/observables.py,sha256=0x0NLkTjxf8cO9F_f_Q1b-1hEeoNjWB2x-53ecUEv0M,1656
+pygnss/iono/gim.py,sha256=khKzClxLf46mVO6BCDk9u9DgS_50d-sbWEyoUQu7Jng,3543
+pygnss/iono/chapman.py,sha256=eyq2RaCkLpQJRzuHt_DSNaLjto1w_W1PdT_ys8A3Bjc,1388
+pygnss/iono/__init__.py,sha256=xuewp1KSVsRQhyXyCCZxIrhNiIc3DluW-YqUZqXhhFs,1538
+pygnss/filter/ukf.py,sha256=ps2itLh8QqNpZ7Y_JeKRs2AqU7zEUvJq4IrfV5bVPEI,10672
+pygnss/filter/models.py,sha256=Cy9rE1JwNJDB5VhZzFhMHuuwSOIO-PR4JKDgQF9CVOw,2339
+pygnss/filter/__init__.py,sha256=vEF_51C-aROGDNpDVGGu9BUPWxCo-P6H9QpFSjqf4c0,2249
+pygnss/filter/ekf.py,sha256=FnI5I98dmmR0ZmSVxXEHuWAMG-dIVzN1j-1sOHYbnJE,2043
+pygnss/filter/particle.py,sha256=HZr_FD9zA0cpX0Gk5bM3icWBW91vOl8vXeKfhTxrMbA,18075
+pygnss-2.1.2.dist-info/RECORD,,
+pygnss-2.1.2.dist-info/WHEEL,sha256=26nyvDx4qlf6NyRSh1NSNrXJDCQeX0hnJ7EH1bB1egM,137
+pygnss-2.1.2.dist-info/entry_points.txt,sha256=awWUCMfX3uMIAPPZqZfSUuw7Kd7defip8L7GtthKqgg,292
+pygnss-2.1.2.dist-info/top_level.txt,sha256=oZRSR-qOv98VW2PRRMGCVNCJmewcJjyJYmxzxfeimtg,7
+pygnss-2.1.2.dist-info/METADATA,sha256=F6V_LtnUEWP2iSR8XVznXpg3Ip0T0y3Usp8DNTAjPzo,4262
+pygnss-2.1.2.dist-info/licenses/LICENSE,sha256=Wwany6RAAZ9vVHjFLA9KBJ0HE77d52s2NOUA1CPAEug,1067

pygnss-2.1.2.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: false
+Tag: cp314-cp314t-macosx_11_0_arm64
+Generator: delocate 0.13.0
+

pygnss-2.1.2.dist-info/entry_points.txt

@@ -0,0 +1,8 @@
+[console_scripts]
+cl = pygnss.cl:entry_point
+compute_cdf = pygnss.stats:cdf_cli
+ionex_diff = pygnss.ionex:cli
+merge_rinex_nav = pygnss.rinex:merge_nav_cli
+rinex_from_file = pygnss.rinex:rinex_from_file
+rinex_to_parquet = pygnss.rinex:rinex_to_parquet
+tensorial = pygnss.tensorial:entry_point

pygnss-2.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2022] [Rokubun]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pygnss-2.1.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+pygnss