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