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.4

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.4
File Size Uploaded
rda_python_icoads-3.0.4.tar.gz 141.3 kB Details

Built distribution (wheel)

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

Total release size: 296.6 kB

Release files / rda_python_icoads-3.0.4.tar.gz

Download URL rda_python_icoads-3.0.4.tar.gz
Size 141.3 kB
Tags Source
SHA-256 checksum
How to use checksums
2072fef88707d4eeb247a9dc155d8b953d12964d4824cb9c788e9d5a2ce8c5c5
BLAKE2b-256 checksum
How to use checksums
f9b20c4984b61e99cb2151d196eb72fff23a119d606cd9b22ee2c378f933ab40
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.4-py3-none-any.whl

Download URL rda_python_icoads-3.0.4-py3-none-any.whl
Size 155.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7776ed40a0c1b20bec0413a69dfeeb5a1ab5818f6649d5b0ee33639732cb7a5c
BLAKE2b-256 checksum
How to use checksums
dda98f7efeac7901538b842706a433a1e3b6eae534f83ac5f43ed1f49988d724
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

This release

3.0.4 This release

2 release files

3.0.3

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