Skip to main content

readmet

PyPI Documentation DOI License: EUPL-1.2

Python readers (and writers) for vendor-specific meteorological data file formats – Campbell Scientific TOA5, Halo Photonics Doppler lidar .hpl, Scintec SODAR FORMAT-1, AUSTAL/LASAT DMNA and DWD AKTerm. Data are returned as pandas DataFrames or numpy arrays.

Supported file formats

Module Format Instruments / software Files Read Write
toa5 TOA5 Campbell Scientific dataloggers (CR1000, CR3000, CR6, …), LoggerNet *.dat ✔ ✔
hpl HPL Halo Photonics StreamLine Doppler wind lidar (VAD, RHI, Stare, wind profile, processed wind profile) *.hpl ✔
scintec1 Scintec FORMAT-1 / FORMAT-1.1 Scintec SODAR / RASS wind profilers (APRun), scintillometers (SRun) *.mnd and other Scintec output ✔
dmna DMNA AUSTAL, AUSTAL2000, LASAT dispersion models (Ingenieurbüro Janicke) *.dmna, *.dmnb, *.dmna.gz ✔ ✔
akterm AKTerm DWD Ausbreitungsklassen-Zeitreihe (dispersion class time series) for AUSTAL *.akterm, *.akt ✔ ✔

Installation

pip install readmet

or as normal user:

pip install --user readmet

readmet requires numpy and pandas. The sources are available from GitHub.

Examples

Read a Campbell Scientific TOA5 file

from readmet import toa5

header, df = toa5.read("TOA5_CR3000.data_2015_06_17_0010.dat")
print(header["station_name"])
print(df[["AirTC_Avg", "RH_Avg"]].head())

Read Halo Photonics Doppler lidar .hpl files

from readmet import hpl

scan = hpl.DataFile("Wind_Profile_00_20260919_121707.hpl")
print(scan.type, scan.timestamp)
print(scan.rays[0].data.head())     # Doppler velocity, intensity, beta per gate

data = hpl.read("Wind_Profile_*.hpl")   # many scans at once

Read Scintec SODAR / scintillometer FORMAT-1 files

from readmet import scintec1

data = scintec1.read("sodar_202406*.mnd")   # dict of DataFrames per variable

Read an AUSTAL DMNA concentration grid

from readmet import dmna

g = dmna.DataFile("so2-y00a.dmna")
con = g.data["con"]                 # numpy array
x = g.axes("x")                     # grid coordinates

Read a DWD AKTerm file

from readmet import akterm

a = akterm.DataFile("testfile.akterm")
print(a.data[["FF", "DD", "KM"]].head())   # wind speed, direction, stability class

Documentation

Full documentation with one page per format: https://druee.gitlab-pages.uni-trier.de/python-readmet/

Citing

If you use readmet in your research, please cite it via its Zenodo DOI 10.5281/zenodo.23455355 (all versions; the Zenodo page lists a separate DOI for each release). Citation metadata are in CITATION.cff; on GitHub, use Cite this repository in the sidebar to get APA or BibTeX.

License

EUPL-1.2 © Clemens Drüe

Metadata

Release files for readmet 1.0.0

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

Source distribution (sdist)

Source distribution for readmet 1.0.0
File Size Uploaded
readmet-1.0.0.tar.gz 3.1 MB Details

Release files / readmet-1.0.0.tar.gz

Download URL readmet-1.0.0.tar.gz
Size 3.1 MB
Tags Source
SHA-256 checksum
How to use checksums
796a1856c83796bba58a8d4016bdd5a72d34d12243d3c0133ad7454f0d13edf0
BLAKE2b-256 checksum
How to use checksums
8fc8a81f9f422a0591910cb6a3f33b7c799ce19c7012ff1b6b6ec0be41bffc03
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.15.0

Release history Release notifications | RSS feed

This release

1.0.0 This release

1 release file

0.9.2

1 release file

0.9.1

1 release file

0.8.42

1 release file

0.8.40

1 release file

0.8.39

1 release file

0.8.38

1 release file

0.8.34

1 release file

0.8.33

1 release file

0.8.32

1 release file

0.8.31

1 release file

0.8.30

1 release file

0.8.29

1 release file

0.8.28

1 release file

0.8.27

1 release file

0.8.26

1 release file

0.8.25

1 release file

0.8.24

1 release file

0.8.23

1 release file

0.8.22

1 release file

0.8.21

1 release file

0.8.20

1 release file

0.8.19

1 release file

0.8.18

1 release file

0.8.17

1 release file

0.8.16

1 release file

0.8.15

1 release file

0.8.14

1 release file

0.8.12

1 release file

0.8.11

1 release file

0.8.10

1 release file

0.8.9

1 release file

0.8.8

1 release file

0.8.7

1 release file

0.8.6

1 release file

0.8.5

1 release file

0.7.3

1 release file

0.7.1

1 release file

0.7.0

1 release file

0.6.11

1 release file

0.6.9

1 release file

0.6.7

1 release file

0.6.3

1 release file

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