Dkist

==================

Backwards Incompatible Changes
------------------------------

- We now require gwcs 0.19+ and therefore astropy 5.3+ (`305 <https://github.com/DKISTDC/dkist/pull/305>`_)


Features
--------

- Add a new ``AsymmetricMapping`` model to allow a different mapping in the forward and reverse directions. (`305 <https://github.com/DKISTDC/dkist/pull/305>`_)


Bug Fixes
---------

- Fix the oversight where, when generating a model for a celestial WCS, the scale model was put before the affine transform in the pipeline. This means that the units for the affine transform matrix provided to ``VaryingCelestialTransform`` and ``generate_celestial_transform`` should be pixels not degrees. (`305 <https://github.com/DKISTDC/dkist/pull/305>`_)
- Fix missing references to parent transform schemas in ``Ravel`` and ``VaryingCelestialTransform`` ASDF schemas. (`305 <https://github.com/DKISTDC/dkist/pull/305>`_)


Trivial/Internal Changes
------------------------

- To improve compatibility with external libraries that provide ASDF serialization and
validation (like asdf-astropy) dkist schemas were updated to use tag wildcards
when checking tagged objects (instead of requiring specific tag versions). (`308 <https://github.com/DKISTDC/dkist/pull/308>`_)

===================

Backwards Incompatible Changes
------------------------------

- The ASDF files currently being served by the data center are incompatible with
gwcs 0.19+. This is due to a change in how Stokes coordinates are represented.
In this release we have pinned the gwcs version to <0.19. A future release will
require 0.19+ when the ASDF files have been updated. (`301 <https://github.com/DKISTDC/dkist/pull/301>`_)


Bug Fixes
---------

- Add missing dependencies to setup.cfg - explicit is better than implicit. (`294 <https://github.com/DKISTDC/dkist/pull/294>`_)
- Import ValidationError from asdf, drop jsonschema as a dependency. (`295 <https://github.com/DKISTDC/dkist/pull/295>`_)
- Implement missing ``select_tag`` method of ``DatasetConverter``. (`297 <https://github.com/DKISTDC/dkist/pull/297>`_)
- Update varying celestial transform schema ref to use a uri instead of a tag. (`298 <https://github.com/DKISTDC/dkist/pull/298>`_)
- Ensure that we don't nest Dask arrays when no FITS files can be read.
This might result in more memory being used when computing an array with missing files. (`301 <https://github.com/DKISTDC/dkist/pull/301>`_)

==================

Features
--------

- Add a new `dkist.load_dataset` function to combine and replace ``Dataset.from_directory()`` and ``Dataset.from_asdf()``. (`274 <https://github.com/DKISTDC/dkist/pull/274>`_)
- Add the ability to load more than one asdf file at once to `dkist.load_dataset`. (`287 <https://github.com/DKISTDC/dkist/pull/287>`_)


Bug Fixes
---------

- Fix minor bugs for header slicing functionality and expand test coverage for edge-cases. (`275 <https://github.com/DKISTDC/dkist/pull/275>`_)
- Fixed inverse transform in `.VaryingCelestialTransformSlit2D`. Which fixes a bug in VISP WCSes. (`285 <https://github.com/DKISTDC/dkist/pull/285>`_)
- Fix a bug preventing the transfer of a single dataset with :meth:`~dkist.net.transfer_complete_datasets`. (`288 <https://github.com/DKISTDC/dkist/pull/288>`_)


Improved Documentation
----------------------

- Added a new tutorial section based on the NSO workshop material. (`281 <https://github.com/DKISTDC/dkist/pull/281>`_)


Trivial/Internal Changes
------------------------

- Add jsonschema as an explicit dependency (previously it was provided by asdf). (`274 <https://github.com/DKISTDC/dkist/pull/274>`_)
- Update minimum required versions of asdf, asdf-astropy, dask, matplotlib, numpy, parfive, and sunpy. (`275 <https://github.com/DKISTDC/dkist/pull/275>`_)

======================

Features
--------

- Add path interpolation to :meth:`~dkist.net.transfer_complete_datasets` path location argument. (`266 <https://github.com/DKISTDC/dkist/pull/266>`_)
- Add a `.Dataset.inventory` attribute to more easily access the inventory metadata (previously ``.meta['inventory']``. (`272 <https://github.com/DKISTDC/dkist/pull/272>`_)
- Add experimental support for 3D LUTs to ``TimeVaryingCelestialTransform`` classes. (`277 <https://github.com/DKISTDC/dkist/pull/277>`_)


Bug Fixes
---------

- Improve speed of ``import dkist`` by preventing automatic import of ``dkist.net``. (`266 <https://github.com/DKISTDC/dkist/pull/266>`_)
- Fix how Fido uses Wavelength to search for datasets. (`266 <https://github.com/DKISTDC/dkist/pull/266>`_)
- Fix using ``a.dkist.Embargoed.false`` and ``a.dkist.Embargoed.true`` to specify embargo status. (`266 <https://github.com/DKISTDC/dkist/pull/266>`_)
- Add units support to ``a.dkist.FriedParameter``. (`266 <https://github.com/DKISTDC/dkist/pull/266>`_)
- Add search attrs corresponding to new columns in dataset inventory. (`266 <https://github.com/DKISTDC/dkist/pull/266>`_)
- Make `dkist.Dataset` return the appropriately sliced header table when slicing data. (`271 <https://github.com/DKISTDC/dkist/pull/271>`_)
- Update docstring for :meth:`dkist.net.transfer_complete_datasets` to include previously missing ``path`` parameter. (`273 <https://github.com/DKISTDC/dkist/pull/273>`_)

=====================

Features
--------

- Adds support to Ravel for N-dimensional data. (`249 <https://github.com/DKISTDC/dkist/pull/249>`_)

=====================

Features
--------

- Add support for passing a list of dataset IDs as strings to `dkist.net.transfer_complete_datasets`. (`240 <https://github.com/DKISTDC/dkist/pull/240>`_)


Bug Fixes
---------

- Fix errors with some types of input in `dkist.net.transfer_complete_datasets`. (`240 <https://github.com/DKISTDC/dkist/pull/240>`_)
- Fix searching for Globus endpoints with SDK 3 (`240 <https://github.com/DKISTDC/dkist/pull/240>`_)
- Fixes bug in the inverse property of CoupledCompoundModel by correcting the various mappings in the inverse. (`242 <https://github.com/DKISTDC/dkist/pull/242>`_)