This release is a pre-release and may not be stable for production use.
Machine readable FITS specifications for DKIST data.
This repository contains machine readable versions of DKIST specifications for FITS files.
This repository is used alongside the dkist-header-validator to validate that SPEC122, SPEC214, extra, or trend data is compliant with these DKIST specifications. To use the validator, please click here and follow the installation instructions.
Usage
This repository contains machine readable versions of DKIST specifications 122 (level 0 FITS files), 214 l0 (Data Center ingested files) and 214 (level 1 FITS files), as well as the specs for dataset extras and trend data. There are four submodules spec122, spec214, dataset_extras, and trend; they respectively provide load_spec122, load_level0_spec214, load_spec214, load_sparse_dataset_extra, and load_sparse_trend_extra functions which return the “simple” schema for each specification. The spec214, dataset_extras, and trend modules also provide load_full_spec214, load_full_dataset_extra, and load_full_trend functions, which provides extra metadata on the schema designed for generation of documentation. Finally, all found modules provide load_processed_* functions, which adjusts the schemas based on an L0/L1 header given as input. load_processed_* are the highest-level “gimme-the-actual-spec” functions for each spec.
Releases
Version Numbers
The version number of this repository follows the following form:
vX.Y.Z
The version number of this repository does not follow semantic versioning for the Python code in the package, it versions the specifications using the following interpretation of the three components:
X: This number will be incremented for any change which results in a backwards incompatible change to the FITS headers. This could include things such as removal of a key or changing the interpretation of a key in any way, such as a change in units. Any change which could potentially mean that a script written to process one of our headers would yield a different result needs a change to this number.
Y: This number will be incremented for any backwards compatible change to the header. This means any change which leads to any character in the header changing (other than values obviously) so this could include changes to comments describing values or the addition of new keys to the header. Changing the ordering of the keys in the header does, or fields in COMMENT or HISTORY cards do not require changes to this number, but a change in a value comment would (as these may be parsed to extract units etc).
Z: This number will be incremented for any change to the repository which does not lead to a change in the FITS headers. This means any change to the Python API, infrastructure or anything else. The Python API should not be considered stable between increments of this number.
Changelog
When you make any change to this repository it MUST be accompanied by a changelog file. The changelog for this repository uses the towncrier package. Entries in the changelog for the next release are added as individual files (one per change) to the changelog/ directory.
Writing a Changelog Entry
A changelog entry accompanying a change should be added to the changelog/ directory. The name of a file in this directory follows a specific template:
<PULL REQUEST NUMBER>.<TYPE>[.<COUNTER>].rst
The fields have the following meanings:
<PULL REQUEST NUMBER>: This is the number of the pull request, so people can jump from the changelog entry to the diff on BitBucket.
<TYPE>: This is the type of the change and must be one of the values described below.
<COUNTER>: This is an optional field, if you make more than one change of the same type you can append a counter to the subsequent changes, i.e. 100.bugfix.rst and 100.bugfix.1.rst for two bugfix changes in the same PR.
The list of possible types is defined the the towncrier section of pyproject.toml, the types are:
spec_breaking: This is a change which is a backwards incompatible change to the FITS headers. If a release has a change of this type in it the first number in the version number must be incremented.
spec_change: This is a change which is a backwards compatible change to the FITS headers. If a release has a change of this type in it the second number in the version number must be incremented.
code_breaking: This is a change which breaks the Python API. The Python API changes only increment the last version number, so it is important to clearly document in the changelog when a release changes the API in a breaking manner.
code_feature: This change is a backwards compatible change to the Python API, such as a new feature.
bugfix: This is a change which fixes a bug in the Python API (but has no resultant change in the headers).
doc: A documentation change.
deprecation: A change which introduces a warning that a feature in the Python API will be changed in the future.
trivial: Any small change which doesn’t fit anywhere else, such as a change to the package infrastructure.
Rendering the Changelog at Release Time
When you are about to tag a release first you must run towncrier to render the changelog. The steps for this are as follows:
Install towncrier with pip install towncrier
Run towncrier build –version vx.y.z using the version number you want to tag.
Agree to have towncrier remove the fragments.
Add and commit your changes.
Tag the release.
Documentation
Note that this repo makes use of sphinx-automodapi rather than autoapi like a lot of the other DKIST DC repos to have a little more control over rendering the limited Python API.
License
This project is Copyright (c) AURA/NSO and licensed under the terms of the BSD 3-Clause license. This package is based upon the Openastronomy packaging guide which is licensed under the BSD 3-clause licence. See the licenses folder for more information.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dkist_fits_specifications-4.29.0rc3.tar.gz.
File metadata
- Download URL: dkist_fits_specifications-4.29.0rc3.tar.gz
- Upload date:
- Size: 95.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.21
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5fdc9e5a336c1b5efc2db30896a7f6bc5e19c98b95a187faef30df53aa5bc896
|
|
| MD5 |
9075db4f362434ecf70910d6fe69945a
|
|
| BLAKE2b-256 |
2b0ecb8666395a131d28e8711a501b86ff87068e834dfe9774f63c6623c5a18d
|
File details
Details for the file dkist_fits_specifications-4.29.0rc3-py3-none-any.whl.
File metadata
- Download URL: dkist_fits_specifications-4.29.0rc3-py3-none-any.whl
- Upload date:
- Size: 105.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.10.21
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
49ad9794120fa952c7433ecc3e5939d9ec9d9b3b5cd28ba7f54b9a2425e61298
|
|
| MD5 |
f9f87af279d20d3d65d118fae5f36699
|
|
| BLAKE2b-256 |
775f3c771ecd177f40c6d66fb0ebc1013fc1e39ae9a6578d1e00c567704716de
|
