Skip to main content

rda_python_icoads

RDA Python package to manage RDA ICOADS datasets.

Prerequisite

To dynamically generate a PDF readme fitting for each data subset, the Linux commandline utility wkhtmltopdf must be installed. See https://wkhtmltopdf.org/index.html for download and install instructions.

Programs

The package installs the following command-line utilities, all running as the current user:

  • imma1_subset — generate IMMA1-format ICOADS subset deliveries
  • msg3_subset — generate MSG-format ICOADS R3 subsets
  • msg_download — download MSG ICOADS source files
  • checkicoads — check ICOADS archive integrity
  • cleanicoads — clean up stale ICOADS files
  • counticoads, countattm, countattmvar, countsst — record/attribute counters
  • fillicoads, fillinventory, fillitable, fillmonth — populate ICOADS DB tables
  • fixiidx — fix ICOADS indices
  • maxsst — compute maximum SST values
  • writeicoads — write ICOADS records

Run any program with no arguments to print its usage details.

Environment setup

Create a Python environment first; package installs in the next section run inside whichever environment you activate here.

Option A — Python venv (DECS machines)

python3 -m venv $ENVHOME          # e.g. /glade/u/home/gdexdata/gdexmsenv
source $ENVHOME/bin/activate

Option B — Conda (DAV/Casper)

conda create --prefix $ENVHOME python=3.12   # e.g. /glade/work/gdexdata/conda-envs/pg-gdex
conda activate $ENVHOME

Installing rda-python-icoads

Pick whichever install mode fits your workflow. All variants pull in the transitive dependency (rda_python_common) automatically.

For local development, clone this repo alongside your project and install it in editable mode so that changes are picked up without re-installing:

git clone https://github.com/NCAR/rda-python-icoads.git
cd rda-python-icoads
pip install -e .

To test a specific branch (e.g. an in-progress feature or fix branch), pass -b/--branch to git clone:

git clone -b <branch-name> https://github.com/NCAR/rda-python-icoads.git
cd rda-python-icoads
pip install -e .

For a regular (non-editable) install from a checkout:

pip install /path/to/rda-python-icoads

For a production install on a system that uses the published distribution:

pip install rda_python_icoads

Metadata

Release files for rda-python-icoads 3.0.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rda-python-icoads 3.0.3
File Size Uploaded
rda_python_icoads-3.0.3.tar.gz 141.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for rda-python-icoads 3.0.3
File Interpreter ABI Platform
rda_python_icoads-3.0.3-py3-none-any.whl Python 3 none any Details

Total release size: 295.8 kB

Release files / rda_python_icoads-3.0.3.tar.gz

Download URL rda_python_icoads-3.0.3.tar.gz
Size 141.0 kB
Tags Source
SHA-256 checksum
How to use checksums
f7ab5a6b8126b11bcf5225afe6f5d20eb467091122d68d0777f8dd11d976c446
BLAKE2b-256 checksum
How to use checksums
be5c6e3234afd23d016b128fc10afcc2be9ee6d1dcddd7bd47f921062432d5d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.

Transparency log

Release files / rda_python_icoads-3.0.3-py3-none-any.whl

Download URL rda_python_icoads-3.0.3-py3-none-any.whl
Size 154.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3d3b47ce5e92c2dcad6023232813d9a89ab848063cfab6b84cdf8cb0e01c447f
BLAKE2b-256 checksum
How to use checksums
f7cd1c2d64d47adee011efffd002515191b5e0e2786257bb1385e4f93ab07448
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 9, 2026.

Transparency log

Release history Release notifications | RSS feed

3.0.4

2 release files

This release

3.0.3 This release

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

1.0.18

2 release files

1.0.17

2 release files

1.0.16

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.9

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page