Roman Datamodels Support
Installation
The easiest way to install the latest roman-datamodels release into a fresh virtualenv or conda environment is
pip install roman-datamodels
Detailed Installation
The roman-datamodels package can be installed into a virtualenv or conda environment via pip. We recommend that for each
installation you start by creating a fresh environment that only has Python installed and then install the roman_datamodels
package and its dependencies into that bare environment. If using conda environments, first make sure you have a recent
version of Anaconda or Miniconda installed. If desired, you can create multiple environments to allow for switching
between different versions of the roman-datamodels package (e.g. a released version versus the current development version).
In all cases, the installation is generally a 3-step process:
- Create a conda environment
- Activate that environment
- Install the desired version of the
roman-datamodelspackage into that environment
Details are given below on how to do this for different types of installations, including tagged releases, DMS builds used in operations, and development versions. Remember that all conda operations must be done from within a bash shell.
Installing latest releases
You can install the latest released version via pip. From a bash shell:
conda create -n <env_name> python
conda activate <env_name>
pip install roman-datamodels
Note
Alternatively, you can also usevirtualenvto create an environment; however, this installation method is not supported by STScI if you encounter issues.
You can also install a specific version (from roman-datamodels 0.1.0 onward):
conda create -n <env_name> python
conda activate <env_name>
pip install roman-datamodels==0.5.0
Installing the development version from Github
You can install the latest development version (not as well tested) from the Github main branch:
conda create -n <env_name> python
conda activate <env_name>
pip install git+https://github.com/spacetelescope/roman_datamodels
Installing for Developers
If you want to be able to work on and test the source code with the roman-datamodels package, the high-level procedure to do
this is to first create a conda environment using the same procedures outlined above, but then install your personal
copy of the code overtop of the original code in that environment. Again, this should be done in a separate conda
environment from any existing environments that you may have already installed with released versions of the roman-datamodels
package.
As usual, the first two steps are to create and activate an environment:
conda create -n <env_name> python
conda activate <env_name>
To install your own copy of the code into that environment, you first need to fork and clone the roman_datamodels repo:
cd <where you want to put the repo>
git clone https://github.com/spacetelescope/roman_datamodels
cd roman_datamodels
Note
Installing viasetup.py(python setup.py install,python setup.py develop, etc.) is deprecated and does not work.
Install from your local checked-out copy as an "editable" install:
pip install -e .
If you want to run the unit or regression tests and/or build the docs, you can make sure those dependencies are installed too:
pip install -e ".[test]"
pip install -e ".[docs]"
pip install -e ".[test,docs]"
Need other useful packages in your development environment?
pip install ipython pytest-xdist
4 maintainers
Metadata
4 maintainers
Release files for roman-datamodels 1.1.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 | |
|---|---|---|---|
| roman_datamodels-1.1.0.tar.gz | 150.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| roman_datamodels-1.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 192.7 kB
Release files / roman_datamodels-1.1.0.tar.gz
| Download URL | roman_datamodels-1.1.0.tar.gz |
|---|---|
| Size | 150.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
13ddbc37894e77da0ad4b887266aa45626c77437fb0d1f09ca99b93d21a407e1
|
|
BLAKE2b-256 checksum How to use checksums |
b422ece59bee609f8e1326ab52d20a1444727d72aa156bf1356456d966a5b4e0
|
| 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 13, 2026.
Transparency logRelease files / roman_datamodels-1.1.0-py3-none-any.whl
| Download URL | roman_datamodels-1.1.0-py3-none-any.whl |
|---|---|
| Size | 42.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
51d52c98e2c3909754bd2f82794166efadf6e954e0dbf99ed4fb3e204e5e71c1
|
|
BLAKE2b-256 checksum How to use checksums |
c98d140f12fa6d1d0aeaab24e2ecbec0eeec6103db73f4bb1232dcd0bbc0bd14
|
| 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 13, 2026.
Transparency log
