csemx — Python client

Reference reader, writer, and validator for csemx bundles — an open, vendor-neutral exchange format for modeling-ready frequency-domain controlled-source electromagnetic (CSEM) data (specification).

The core (read/write and the dependency-light checks) needs no third-party packages; the optional full extra adds the libraries required for complete conformance validation.

Beta. The package version tracks the format version it implements: csemx 0.1.x reads and validates format 0.1 bundles exactly. During the 0.x beta, format minor versions may include breaking changes and the validator accepts only its own format version (spec §12).

Contents

  • src/csemx/io.py — read() / write() and the CsemxBundle / Table types
  • src/csemx/validation.py — validate() and the bundle/manifest checks
  • src/csemx/cli.py — the csemx command-line entry point
  • src/csemx/schemas/ — bundled manifest schema and validator metadata
  • tests/ — validator regression tests

Install

python3 -m pip install csemx            # core: read/write + light checks
python3 -m pip install "csemx[full]"    # + PyYAML, jsonschema, pyproj, pyarrow

From a repository checkout, editable:

python3 -m pip install -e "./python"
python3 -m pip install -e "./python[full]"

The full extra enables manifest JSON-Schema validation, EPSG/CRS checks, and Parquet tables. Requires Python ≥ 3.9.

Command line

csemx validate examples/example.csemx              # dependency-light checks
csemx validate --full examples/example.csemx.zip   # full conformance
csemx inspect examples/example.csemx               # summarize a bundle

Library

import csemx

bundle = csemx.read("examples/example.csemx")          # -> CsemxBundle
errors, warnings = csemx.validate("examples/example.csemx", full=True)
csemx.write(bundle, "out.csemx.zip")                   # directory or .zip

Public API: read, write, validate, and the CsemxBundle, Table, and ValidationError types.

Tests

python3 -m unittest python.tests.test_validate   # from the repository root

Project links

Data verified by PyPI on Aug 13, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for ajames_dbg from gravatar.com ajames_dbg

Credits

Author: Deep Blue Geophysics

GitHub Statistics

Data verified by PyPI on Aug 13, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.9

Provides Extra

full

Tags

CSEM controlled-source electromagnetics geophysics electromagnetics data format validation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

csemx-0.1.0.tar.gz (38.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

csemx-0.1.0-py3-none-any.whl (26.3 kB view details)

Uploaded Python 3

File details

Details for the file csemx-0.1.0.tar.gz.

File metadata

  • Download URL: csemx-0.1.0.tar.gz
  • Upload date:
  • Size: 38.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for csemx-0.1.0.tar.gz
Algorithm Hash digest
SHA256 4f88539050dade6398835873c00b123c99753619e032302f5b086381acec3ede
MD5 1eafd3c50e6f579006835aae7d3ca4b2
BLAKE2b-256 e6125bab5f267de6b0361c56b2894006258319909927afc692936640f2283160

See more details on using hashes here.

Provenance

The following attestation bundles were made for csemx-0.1.0.tar.gz:

Publisher: publish.yml on Deep-Blue-Geophysics/csemx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file csemx-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: csemx-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 26.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for csemx-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c38f90c98344a9f6787c654c09c6bfa499ff7856f9a7ad46437f071890659a14
MD5 2dadce1d635e6d873dc3ae7c7ae991a8
BLAKE2b-256 d9b3cc953efc17e2b2dcac73c5bdf1d2d3f261b0936f01f472722cfe316ff724

See more details on using hashes here.

Provenance

The following attestation bundles were made for csemx-0.1.0-py3-none-any.whl:

Publisher: publish.yml on Deep-Blue-Geophysics/csemx

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.2.0

2 files

This release

0.1.0 This release

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page