Metadata-Version: 2.3
Name: em27_metadata
Version: 1.11.0
Summary: Single source of truth for ESM's EM27 measurement logistics
Author: Moritz Oliveira Makowski, Marlon Müller
Author-email: Moritz Oliveira Makowski <moritz.makowski@tum.de>, Marlon Müller <marlon.mueller@tum.de>
License: GPL-3.0-or-later
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: pydantic>=2.12.3
Requires-Dist: tomli>=2.4.0
Requires-Dist: tum-esm-utils>=2.11.3
Requires-Python: >=3.11, <4.0
Project-URL: repository, https://github.com/tum-esm/em27-retrieval-pipeline
Project-URL: documentation, https://tum-esm.github.io/em27-retrieval-pipeline/
Description-Content-Type: text/markdown

# em27-metadata

`em27-metadata` provides validated schemas and query interfaces for EM27/SUN measurement metadata. Its source now lives in the [EM27 Retrieval Pipeline](https://github.com/tum-esm/em27-retrieval-pipeline) repository, while the library continues to be distributed under the `em27_metadata` package name. As of library version 1.11.0, the versioning of this library is in sync with the versioning of the EM27 Retrieval Pipeline.

```python
import datetime

import em27_metadata

metadata = em27_metadata.load_from_local_files(config_directory="config")
contexts = metadata.get(
    sensor_id="sensor-id",
    from_datetime=datetime.datetime(2026, 1, 1, tzinfo=datetime.timezone.utc),
    to_datetime=datetime.datetime(2026, 1, 1, 23, 59, 59, tzinfo=datetime.timezone.utc),
)
```

The loader supports the current `em27_metadata.toml` schema and the former `locations.json`, `sensors.json`, `campaigns.json`, and `events.json` layout. See the [metadata documentation](https://tum-esm.github.io/em27-retrieval-pipeline/guides/em27-metadata) for configuration details.
