ATCF Data Parser

0.0.3 verified Sat May 09 auth: no python

Parse A-deck data posted online by the Automated Tropical Cyclone Forecasting System (ATCF). Version 0.0.3, released with minimal changes; low release cadence. Requires Python >= 3.11.

pip install atcf-data-parser

Common errors

error ModuleNotFoundError: No module named 'atcf_data_parser' ↓

cause The package is installed as `atcf-data-parser` but imported as `atcf_data_parser` with underscores.

fix

Use correct import: from atcf_data_parser import parse_fnmoc_atcf

error TypeError: parse_fnmoc_atcf() missing 1 required positional argument: 'url' ↓

cause The function requires a URL argument, not called with empty parentheses.

fix

Provide a valid URL string: records = parse_fnmoc_atcf('https://...')

Warnings

gotcha The library is very early (v0.0.3) and may have breaking changes in future releases. Pin your dependency to a specific version. ↓

fix Use `atcf-data-parser==0.0.3` in requirements.txt or pyproject.toml.

gotcha The main function `parse_fnmoc_atcf` expects a URL string, not a local file path. Does not support file I/O directly. ↓

fix Use `urllib.request` or `requests` to download the file first if you need to parse local data.

Imports

parse_fnmoc_atcf

from atcf_data_parser import parse_fnmoc_atcf

Quickstart

Parse an A-deck file from FNMOC URL (requires network access).

from atcf_data_parser import parse_fnmoc_atcf

# Fetch and parse a sample A-deck URL
url = "https://www.nrlmry.navy.mil/atcf_web/docs/tc/2024/AL032024/adv/AL032024_A_202407010000"
records = parse_fnmoc_atcf(url)
print(records[0] if records else "No records found")