pyisd

Reads NOAA Integrated Surface Database (ISD) data.

Installation

$ pip install isd

Usage

There is a simple command line interface. The isd record command prints a single record in JSON format:

$ isd record 720538-00164-2021

The Python API allows reading compressed and uncompressed ISD files:

import isd.io

with isd.io.open("isd-file") as records_iterator:
    records = list(records_iterator)

There is currently no parsing of the additional_data section, but all mandatory fields are parsed out into appropriately-typed fields on a Record.

Development

Install the development requirements and the package in editable mode:

$ pip install -e .
$ pip install -r requirements-dev.txt

To run the unit tests:

$ pytest

Release

To cut a new release of pyisd (assuming you have the appropriate permissions):

1. Create a new branch, e.g. release/v0.1.4.
2. Update the CHANGELOG.
3. Open a pull request with the changes.
4. Merge the pull request once all required checks pass.
5. Create an annotated tag.
   • The tag must be named the same as the semver, e.g. git tag -a v0.1.4. We use setuptools-scm to manage the package version so the tag name is very important.
   • The tag's contents should probably be the same information that was in the CHANGELOG for this version.
6. Push the annotated tag to github. This will trigger a new pypi release.