DEPRECATED: This package is obsolete. See PYSIAF (https://pysiaf.readthedocs.io/) instead for XML SIAF parsing code, and WebbPSF (https://webbpsf.readthedocs.io/) for JWST mirror file XML parsing code.
jwxml is no longer actively developed and its use should be phased out.
Note: This is probably mostly useful internally at STScI.
Miscellaneous XML support helper code related to some JWST configuration files, mostly optics and wavefront sensing related.
So far this provides support for reading in and interacting with:
- The so-called SIAF (Science Instrument Aperture Files)
- Wavefront control SUR (Segment Update Request) files
More functionality may be added ad hoc as needed; no overall long term development master plan is implied.
Science Instrument Aperture Files contain detailed focal plane and pointing models for the science instruments. They are maintained in the JWST PRD (Project Reference Database). Snapshots taken from the PRD are bundled with jwxml, but care should be taken to ensure one is using the latest files from the PRD directly.
For a file obtained from the PRD:
siaf = jwxml.SIAF(filename='/your/path/to/NIRCam_SIAF_2016-01-28.xml')To use the bundled SIAF:
siaf = jwxml.SIAF('NIRCam')To check which PRD version is in use:
print(jwxml.PRD_VERSION)