{"id":44435046,"url":"https://github.com/cioos-siooc/ocean-data-parser","last_synced_at":"2026-02-12T13:53:41.681Z","repository":{"id":37242452,"uuid":"505578792","full_name":"cioos-siooc/ocean-data-parser","owner":"cioos-siooc","description":"A Python package for parsing oceanographic proprietary data formats to xarray Dataset. ","archived":false,"fork":false,"pushed_at":"2026-02-04T20:55:22.000Z","size":98911,"stargazers_count":5,"open_issues_count":20,"forks_count":2,"subscribers_count":2,"default_branch":"development","last_synced_at":"2026-02-05T08:41:36.777Z","etag":null,"topics":["ocean","parser","xarray"],"latest_commit_sha":null,"homepage":"https://cioos-siooc.github.io/ocean-data-parser/","language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cioos-siooc.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2022-06-20T19:51:54.000Z","updated_at":"2026-01-12T15:01:23.000Z","dependencies_parsed_at":"2023-01-28T15:02:26.872Z","dependency_job_id":"e39174be-614d-4fff-866c-efb7a80f006e","html_url":"https://github.com/cioos-siooc/ocean-data-parser","commit_stats":{"total_commits":934,"total_committers":4,"mean_commits":233.5,"dds":"0.17451820128479656","last_synced_commit":"40041fc66a9ddb6baebdcc388a390da621daf360"},"previous_names":["cioos-siooc/ocean-data-parser"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/cioos-siooc/ocean-data-parser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioos-siooc%2Focean-data-parser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioos-siooc%2Focean-data-parser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioos-siooc%2Focean-data-parser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioos-siooc%2Focean-data-parser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cioos-siooc","download_url":"https://codeload.github.com/cioos-siooc/ocean-data-parser/tar.gz/refs/heads/development","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cioos-siooc%2Focean-data-parser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29367645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-12T08:51:36.827Z","status":"ssl_error","status_checked_at":"2026-02-12T08:51:26.849Z","response_time":55,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ocean","parser","xarray"],"created_at":"2026-02-12T13:53:40.999Z","updated_at":"2026-02-12T13:53:41.676Z","avatar_url":"https://github.com/cioos-siooc.png","language":"Jupyter Notebook","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![Logo](docs/images/logo_EN_FR-1024x208.png#gh-light-mode-only)\n![Logo](docs/images/cioos-national_EN_FR_W-01.png#gh-dark-mode-only)\n\n# ocean-data-parser\n\n\u003c!-- You can get project-relevant badges from: [shields.io](https://shields.io/) --\u003e\n\n[![Build documentation](https://github.com/cioos-siooc/ocean-data-parser/actions/workflows/deploy-docs.yaml/badge.svg)](https://github.com/cioos-siooc/ocean-data-parser/actions/workflows/deploy-docs.yaml)\n\n`ocean-data-parser` - a Python package for parsing oceanographic proprietary data formats to xarray Datasets[^1].\n\n\u003cdiv align = center\u003e\n\u003ca href='https://cioos-siooc.github.io/ocean-data-parser/'\u003e\u003ckbd\u003e \u003cbr\u003e See Full Documentation Here \u003cbr\u003e \u003c/kbd\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## Installation\n\nFirst, install the [uv package manager](https://github.com/astral-sh/uv)\n```console\npip install uv\n```\nNext, clone the repository to your local machine, enter the project directory and use `uv sync` to setup the package.\n\n```console\ngit clone https://github.com/cioos-siooc/ocean-data-parser\ncd ocean-data-parser\nuv sync --python 3.9\n```\n\nThis process will create a Python 3.9 virtual environment in the a `.venv` directory and populate it with the packages described in the `pyproject.toml` and `uv.lock` files.\n\nActivate the new environment:\n\n```console\nsource .venv/bin/activate\n```\n\nTest the install:\n\n```console\nodpy --version\n```\n\n### How to\n\n#### odpy cli\n\nOnce installed, the package is usable via the command line interface:\n\n```console\nodpy --help\n```\n\nTo batch convert a series of files to NetCDF:\n\n```\nodpy convert -i '**/*.cnv' -p 'seabird.cnv'\n```\n\n#### Format auto-detection\n\nLoad a compatible file with the automated parser detection method:\n\n```python\nimport ocean_data_parser.read\n\n# Load a file to an xarray object\nds = ocean_data_parser.read.file('Path to file')\n\n# Save to netcdf\nds.to_netcdf('save-path.nc')\n```\n\n!!!warning\n    The parser detection method relies on the file extension and the first few lines present within the given file.\n\nOr specify the specific parser to use for this file format:\n\n``` python\nfrom ocean_data_parser.parsers import seabird\n\n# Load a seabird cnv file as an xarray dataset\nds = seabird.cnv('Path to seabird cnv file')\n\n# Save to netcdf\nds.to_netcdf('save-path.nc')\n```\n\nThe `ocean-data-parser` can then be used within either a Python package, script or jupyter notebook. See the [documentation Notebook section](https://cioos-siooc.github.io/ocean-data-parser) for examples of how to use the package within a jupyter notebook.\n\n## Contributions\n\nAll contributions are welcome!\n\nPlease create a new [discussion](https://github.com/cioos-siooc/ocean-data-parser/discussions) or [issue](https://github.com/cioos-siooc/ocean-data-parser/issues) within the GitHub repository for any questions, ideas and suggestions.\n\n[^1]: [Xarray package documentation](https://docs.xarray.dev/en/stable/index.html)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcioos-siooc%2Focean-data-parser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcioos-siooc%2Focean-data-parser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcioos-siooc%2Focean-data-parser/lists"}