migrating.rst

Migrating deprecated products

On rare occasion, the model schemas are changed in such a way as to break compatibility with data products produced by earlier versions of this package. When these older files are opened the software will report validation errors:

>>> from stdatamodels.jwst import datamodels >>> datamodels.open("jw95115001001_02102_00001_nrs1_x1d.fits") ... ValueError: Column names don't match schema...

In some cases it will be possible to update the file to the new format using the migrate_data tool included with this package: :

$ migrate_data jw95115001001_02102_00001_nrs1_x1d.fits --in-place

It can also be run on multiple files: :

$ migrate_data *_x1d.fits --in-place

Or configured to write updated files to a separate output directory: :

$ migrate_data *_x1d.fits --output-dir some/other/directory