pyodim


Namepyodim JSON
Version 0.5.0 PyPI version JSON
download
home_pagehttps://github.com/vlouf/pyodim
SummaryAn Odim hdf5 file reader.
upload_time2024-11-13 22:52:52
maintainerNone
docs_urlNone
authorValentin Louf
requires_pythonNone
licenseISC
keywords odim h5 radar file reader
VCS
bugtrack_url
requirements numpy dask xarray pyproj h5py pytest
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
# pyodim

`pyodim` is a Python library for reading ODIM H5 radar files, transforming them into xarray datasets with geographic coordinates. This library is designed for users needing direct access to ODIM H5 files, providing tools to read and process radar data.

## Table of Contents
- [Overview](#overview)
- [Installation](#installation)
- [Usage](#usage)

## Overview
The `pyodim` library provides essential functions for handling ODIM H5 radar data. It reads radar sweeps and converts them into xarray datasets, handling various metadata and radar coordinates transformations. The main function, `read_odim`, enables easy access to radar data in a format compatible with Python's data analysis ecosystem.

## Installation

`pyodim` is available on PyPI:
```bash
pip install pyodim
```

It requires the following packages: `h5py pyproj pandas numpy xarray dask`.

## Usage

The main entry point for pyodim is the read_odim function, which reads a sweep from an ODIM H5 file and outputs an xarray dataset.

### Example

```python
from pyodim import read_odim

# Read an ODIM H5 file
dataset = read_odim("radar_file.h5", nslice=0)
print(dataset)
```

`read_odim` takes the following parameters:
- `odim_file` (str): Path to the ODIM H5 file.
- `nslice` (int, optional): Sweep number to read (default is 0).
- `include_fields` (List, optional): Fields to read.
- `exclude_fields` (List, optional): Fields to exclude.
- `check_NI` (bool, optional): Check Nyquist parameter consistency (default is False).
- `read_write` (bool, optional): Open in read-write mode if True.

Feel free to contribute to pyodim by submitting issues or pull requests.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/vlouf/pyodim",
    "name": "pyodim",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "odim h5 radar file reader",
    "author": "Valentin Louf",
    "author_email": "valentin.louf@bom.gov.au",
    "download_url": "https://files.pythonhosted.org/packages/4a/3d/36eebb8aa7d43abb232d547e34608a4779709e3cad0efc3dbab649e93a0e/pyodim-0.5.0.tar.gz",
    "platform": null,
    "description": "\n# pyodim\n\n`pyodim` is a Python library for reading ODIM H5 radar files, transforming them into xarray datasets with geographic coordinates. This library is designed for users needing direct access to ODIM H5 files, providing tools to read and process radar data.\n\n## Table of Contents\n- [Overview](#overview)\n- [Installation](#installation)\n- [Usage](#usage)\n\n## Overview\nThe `pyodim` library provides essential functions for handling ODIM H5 radar data. It reads radar sweeps and converts them into xarray datasets, handling various metadata and radar coordinates transformations. The main function, `read_odim`, enables easy access to radar data in a format compatible with Python's data analysis ecosystem.\n\n## Installation\n\n`pyodim` is available on PyPI:\n```bash\npip install pyodim\n```\n\nIt requires the following packages: `h5py pyproj pandas numpy xarray dask`.\n\n## Usage\n\nThe main entry point for pyodim is the read_odim function, which reads a sweep from an ODIM H5 file and outputs an xarray dataset.\n\n### Example\n\n```python\nfrom pyodim import read_odim\n\n# Read an ODIM H5 file\ndataset = read_odim(\"radar_file.h5\", nslice=0)\nprint(dataset)\n```\n\n`read_odim` takes the following parameters:\n- `odim_file` (str): Path to the ODIM H5 file.\n- `nslice` (int, optional): Sweep number to read (default is 0).\n- `include_fields` (List, optional): Fields to read.\n- `exclude_fields` (List, optional): Fields to exclude.\n- `check_NI` (bool, optional): Check Nyquist parameter consistency (default is False).\n- `read_write` (bool, optional): Open in read-write mode if True.\n\nFeel free to contribute to pyodim by submitting issues or pull requests.\n",
    "bugtrack_url": null,
    "license": "ISC",
    "summary": "An Odim hdf5 file reader.",
    "version": "0.5.0",
    "project_urls": {
        "Homepage": "https://github.com/vlouf/pyodim"
    },
    "split_keywords": [
        "odim",
        "h5",
        "radar",
        "file",
        "reader"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5cee744f0b748627ac94dc83881acfd2d05d89eb95231b18ee767143178e76e9",
                "md5": "08dc9fa05a3971df3a1b856c49a0be27",
                "sha256": "56581d921af36957a049c4014c81bd616f01ee120581ab5e2f4dd303d9535e38"
            },
            "downloads": -1,
            "filename": "pyodim-0.5.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "08dc9fa05a3971df3a1b856c49a0be27",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 8611,
            "upload_time": "2024-11-13T22:52:50",
            "upload_time_iso_8601": "2024-11-13T22:52:50.545761Z",
            "url": "https://files.pythonhosted.org/packages/5c/ee/744f0b748627ac94dc83881acfd2d05d89eb95231b18ee767143178e76e9/pyodim-0.5.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "4a3d36eebb8aa7d43abb232d547e34608a4779709e3cad0efc3dbab649e93a0e",
                "md5": "b0e11e28a05d292b7748efc0ed7824d5",
                "sha256": "4e3abcae204e02de1e9b39a361e6b470ea774a76eec05713f02ab07f48343670"
            },
            "downloads": -1,
            "filename": "pyodim-0.5.0.tar.gz",
            "has_sig": false,
            "md5_digest": "b0e11e28a05d292b7748efc0ed7824d5",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 10066,
            "upload_time": "2024-11-13T22:52:52",
            "upload_time_iso_8601": "2024-11-13T22:52:52.143697Z",
            "url": "https://files.pythonhosted.org/packages/4a/3d/36eebb8aa7d43abb232d547e34608a4779709e3cad0efc3dbab649e93a0e/pyodim-0.5.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-13 22:52:52",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "vlouf",
    "github_project": "pyodim",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "numpy",
            "specs": [
                [
                    ">=",
                    "1.21.0"
                ]
            ]
        },
        {
            "name": "dask",
            "specs": [
                [
                    ">=",
                    "2020.12.0"
                ]
            ]
        },
        {
            "name": "xarray",
            "specs": [
                [
                    ">=",
                    "0.18.0"
                ]
            ]
        },
        {
            "name": "pyproj",
            "specs": [
                [
                    ">=",
                    "3.1.0"
                ]
            ]
        },
        {
            "name": "h5py",
            "specs": [
                [
                    ">=",
                    "3.0"
                ]
            ]
        },
        {
            "name": "pytest",
            "specs": []
        }
    ],
    "lcname": "pyodim"
}
        
Elapsed time: 0.39687s