This module provides tools to create synthetic data files for the AMISR (Advanced Module Incoherent Scatter Radar) systems. The files are based on both a specified ionospheric state and a radar configuration. This can be used to generate synthetic data in the “SRI data format” both for the three existing AMISRs and for hypothetical future “AMISR-like” systems. Primarily, it was designed to help test the functionality of various inversion algorithms that attempt to create a complete picture of ionospheric state parameters from discrete measurements by creating a way to check the output of these algorithms against known “truth” data. Please note that this module does NOT attempt to simulate any aspect of fundamental ISR theory.
Quick Start
Installation
The amisrsynthdata package is pure python and can be installed with pip:
pip install amisrsynthdataAdditional installation instructions are also available.
Example Usage
This package installs the command line tool amisrsynthdata, which is used along with a YAML configuration file to generate an output hdf5 AMISR data file. The configuration file specifies the ionosphere state and radar configuration that should be used. The following steps show how to use a provided example configuration file to run amisrsythdata.
Install amisrsynthdata with the plots option.
pip install 'amisrsynthdata[plots]'Download the example configuration file. This can be done directly from the repository webpage or with a command line utility such as wget.
wget https://raw.githubusercontent.com/amisr/amisrsynthdata/refs/heads/main/example_synth_config.yamlRun amisrsynthdata with the verbose option.
amisrsynthdata example_synth_config.yaml -vThis should product the output synthetic data file synthetic_data.h5 and four summary plot files in your working directory. Note that this example uses extremely simple ionospheric state functions for illustrative purposes. By editing the options in the configuration file, you can specify the radar mode and ionosphere that are used to create the synthetic data. Refer to the configuration file documentation for information about the contents of the configuration file.
Additional information about using this pacakge is available in the usage documentation.
Limitations
The following are NOT currently included in the amisrsynthdata module:
Any kind of proper treatment or simulation of ISR theory - The module effectively assumes the radar measures plasma parameters perfectly at a particular location, although empirical errors can be added.
Integration over a time period or smearing along the length of pulses, as well as pulse coding.
Madrigal data format - Currently files are only generated in the SRI data format.
Documentation
Full documentation for amisrsynthdata is available on ReadTheDocs.
Source Code Repository
The source code for amisrsynthdata is available on GitHub.
Contributing
Contributions to this package are welcome and encouraged, particularly to expand the currently set of specified ionospheres. Contributions can take the form of issues to report bugs and request new features and pull requests to submit new code. Please refer to the contributing guidelines for more details. Specific instructions on how to add a new state function to describe the ionosphere are available in Create New State Functions.
1 maintainer
Release files for amisrsynthdata 1.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| amisrsynthdata-1.2.0.tar.gz | 123.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| amisrsynthdata-1.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 231.0 kB
Release files / amisrsynthdata-1.2.0.tar.gz
| Download URL | amisrsynthdata-1.2.0.tar.gz |
|---|---|
| Size | 123.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
deccb42174b7901d23aada5e797903744d00efd8ed67764a8abca56eec3d5f76
|
|
BLAKE2b-256 checksum How to use checksums |
c5bd935b375484e30a733a1918b27219673d0fe1373e6e453bc9cbabc50b6572
|
| 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 Aug 12, 2026.
Transparency logRelease files / amisrsynthdata-1.2.0-py3-none-any.whl
| Download URL | amisrsynthdata-1.2.0-py3-none-any.whl |
|---|---|
| Size | 107.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ce2f69043f4aba0b6b488a8267852d7f2e6e1b3fe223f4488a491501a424ad9c
|
|
BLAKE2b-256 checksum How to use checksums |
6907c597e89195bb5c21dce84fd080d98ea32335809657e74af26ac33ab5ffe1
|
| 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 Aug 12, 2026.
Transparency log
