{"id":38643643,"url":"https://github.com/oceanmodeling/inspectds","last_synced_at":"2026-01-17T09:11:00.197Z","repository":{"id":45049217,"uuid":"373489904","full_name":"oceanmodeling/inspectds","owner":"oceanmodeling","description":"A CLI utiltiy to print the metadata of datasets in various formats (NetCDF, zarr, grib, selafin etc)","archived":false,"fork":false,"pushed_at":"2024-11-08T16:20:21.000Z","size":577,"stargazers_count":2,"open_issues_count":8,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-17T09:14:09.067Z","etag":null,"topics":["cli","dataset","grib","metadata","netcdf","python","telemac","zarr"],"latest_commit_sha":null,"homepage":"","language":"Roff","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oceanmodeling.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2021-06-03T11:54:12.000Z","updated_at":"2024-11-08T16:20:25.000Z","dependencies_parsed_at":"2023-12-25T20:32:44.359Z","dependency_job_id":"8c9e2d34-5889-4de4-8d68-2e621650bf26","html_url":"https://github.com/oceanmodeling/inspectds","commit_stats":{"total_commits":40,"total_committers":2,"mean_commits":20.0,"dds":"0.050000000000000044","last_synced_commit":"3f909d5e53b9fc1f569d71b4e63b23b9f6e5c1eb"},"previous_names":["oceanmodeling/inspectds"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/oceanmodeling/inspectds","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanmodeling%2Finspectds","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanmodeling%2Finspectds/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanmodeling%2Finspectds/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanmodeling%2Finspectds/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oceanmodeling","download_url":"https://codeload.github.com/oceanmodeling/inspectds/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oceanmodeling%2Finspectds/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28504902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T06:57:29.758Z","status":"ssl_error","status_checked_at":"2026-01-17T06:56:03.931Z","response_time":85,"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":["cli","dataset","grib","metadata","netcdf","python","telemac","zarr"],"created_at":"2026-01-17T09:10:59.466Z","updated_at":"2026-01-17T09:11:00.108Z","avatar_url":"https://github.com/oceanmodeling.png","language":"Roff","funding_links":[],"categories":[],"sub_categories":[],"readme":"# inspectds\n\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/pmav99/inspectds)\n![CI](https://github.com/pmav99/inspectds/actions/workflows/run_tests.yml/badge.svg)\n\nA CLI utility to print metadata of datasets in various formats (e.g. NetCDF, zarr, GRIB, tiff etc)\n\n_powered by [xarray](https://github.com/pydata/xarray)_\n\n## Prerequisites\n\nYou need the following binary dependencies:\n\n- Python \u003e= 3.9\n- Optionally, [eccodes](https://github.com/ecmwf/eccodes), which is necessary for GRIB support.\n\n## Installation\n\n### conda\n\n```\nconda install -c conda-forge inspectds\n```\n\n### PyPI\n\nThe recommended way of installation is [pipx](https://github.com/pypa/pipx):\n\n```\npipx install inspectds\n```\n\nor if you want support for GRIB, SELAFIN or both:\n\n```\npipx install 'inspectds[grib]'\npipx install 'inspectds[selafin]'\npipx install 'inspectds[all]'\n```\n\nIf you want to install the latest development version from git, then use:\n\n```\npipx install 'git+https://github.com/pmav99/inspectds.git#egg=inspectds[all]'\n```\n\nNote: Support for GRIB also requires [eccodes](https://github.com/ecmwf/eccodes).\nThis is not a python dependency!\nYou need to install it via e.g. `apt` or `conda` or compile it from source or whatever.\n\n## Usage\n\n### Netcdf\n\n```\n$ inspectds tests/data/example_1.nc\n\nDimensions: (lat: 5, level: 4, lon: 10, time: 1)\nCoordinates:\n  * lat      (lat) int32 20 30 40 50 60\n  * lon      (lon) int32 -160 -140 -118 -96 -84 -52 -45 -35 -25 -15\n  * level    (level) int32 1000 850 700 500\n  * time     (time) datetime64[ns] 1996-01-01T12:00:00\nData variables:\n    temp     (time, level, lat, lon) float32 ...\n    rh       (time, lat, lon) float32 ...\n```\n\n### Zarr\n\n```\n$ inspectds tests/data/store.zarr\n\nDimensions: (lat: 19, lon: 36, time: 12)\nCoordinates:\n  * lat      (lat) int64 -90 -80 -70 -60 -50 -40 -30 ... 30 40 50 60 70 80 90\n  * lon      (lon) int64 -180 -170 -160 -150 -140 -130 ... 130 140 150 160 170\n  * time     (time) datetime64[ns] 2001-01-31 2001-02-28 ... 2001-12-31\nData variables:\n    aaa      (lon, lat, time) int64 ...\n```\n\n### Tiff\n\n```\n$ inspectds ETOPO_2022_v1_60s_N90W180_surface.tif\nDimensions: (band: 1, x: 21600, y: 10800)\nCoordinates:\n  * band         (band) int64 8B 1\n  * x            (x) float64 173kB -180.0 -180.0 -180.0 ... 180.0 180.0 180.0\n  * y            (y) float64 86kB 89.99 89.97 89.96 ... -89.96 -89.98 -89.99\n    spatial_ref  int64 8B 0\nData variables:\n    band_data  (band, y, x) float32 933MB ...\n```\n\n### GRIB\n\n```\n$ inspectds tests/data/example.grib\n\nDimensions: (number: 2, time: 3, isobaricInhPa: 2, latitude: 3, longitude: 4)\nCoordinates:\n  * number         (number) int64 0 1\n  * time           (time) datetime64[ns] 2017-01-01 ... 2017-01-02\n    step           timedelta64[ns] ...\n  * isobaricInhPa  (isobaricInhPa) float64 850.0 500.0\n  * latitude       (latitude) float64 90.0 0.0 -90.0\n  * longitude      (longitude) float64 0.0 90.0 180.0 270.0\n    valid_time     (time) datetime64[ns] ...\nData variables:\n    z        (number, time, isobaricInhPa, latitude, longitude) float32 ...\n    t        (number, time, isobaricInhPa, latitude, longitude) float32 ...\n```\n\n### SELAFIN\n\n```\n$ inspectds tests/data/iceland.slf\nDimensions: (time: 13, node: 3526)\nCoordinates:\n    x        (node) float32 14kB -13.99 -14.97 -15.89 ... -13.52 -16.31 -12.28\n    y        (node) float32 14kB 57.38 60.19 69.79 63.11 ... 66.37 69.34 63.52\n  * time     (time) datetime64[ns] 104B 2017-10-01 ... 2017-10-01T12:00:00\nData variables:\n    S        (time, node) float32 183kB ...\n```\n\n### More info:\n\n```\n$ inspectds --help\n\n Usage: inspectds [OPTIONS] PATH\n\n╭─ Arguments ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n│ *    path      PATH  The path to the dataset [default: None] [required]                                                                                                                                                                                     │\n╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n│ --dataset-type                                       [auto|netcdf|zarr|grib|selafin]  The dataset type. If 'auto', then it gets inferred from PATH [default: auto]                                                                                          │\n│ --mask-and-scale         --no-mask-and-scale                                          Whether to mask and scale the dataset [default: no-mask-and-scale]                                                                                                    │\n│ --dimensions             --no-dimensions                                              Whether to include 'Dimensions' in the output [default: dimensions]                                                                                                   │\n│ --coordinates            --no-coordinates                                             Whether to include 'Coordinates' in the output [default: coordinates]                                                                                                 │\n│ --variables              --no-variables                                               Whether to include 'Variables' in the output [default: variables]                                                                                                     │\n│ --variable-attributes    --no-variable-attributes                                     Whether to include the variable attributes in the output [default: no-variable-attributes]                                                                            │\n│ --global-attributes      --no-global-attributes                                       Whether to include the global attributes in the output [default: no-global-attributes]                                                                                │\n│ --full                   --no-full                                                    Display full output. Overrides any other option [default: no-full]                                                                                                    │\n│ --version                                                                             Display the version                                                                                                                                                   │\n│ --help                                                                                Show this message and exit.                                                                                                                                           │\n╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n```\n\n## Development\n\n```\nmamba env create --file ci/py3.11.yml --name inspectds_dev\nconda activate inspectds_dev\nmake init\nmake test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foceanmodeling%2Finspectds","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foceanmodeling%2Finspectds","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foceanmodeling%2Finspectds/lists"}