Aiapy

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

Breaking Changes
----------------

- Removed ``fix_observer_location`` as it is no longer needed. (`346 <https://github.com/LM-SAL/aiapy/pull/346>`__)
- Due to the temporary shutdown of the JSOC, many of the functions within ``aiapy`` are currently not functioning as they rely on the JSOC to retrieve data.

In an effort to enable other sources of data to be provided to the broken functions, the following breaking changes have been made:

1. `aiapy.calibrate.correct_degradation`: The "calibration_version" keyword has been removed and "correction_table" is now a required argument.
To get a correction table, one can use the `aiapy.calibrate.util.get_correction_table`.
This allows one to select between, JSOC, SSW, or a custom correction table.
For SSW, the correction table will be the latest version of the SSW correction table (V10).
If you want to use the JSOC, you can pass in "jsoc" as a string argument.

2. `aiapy.calibrate.estimate_error`: "error_table" is now a required argument.
To get the error table, one can use the `aiapy.calibrate.util.get_error_table`.
By default, this function will fetch the most recent version of the error table (V3) from SSW.

3. `aiapy.response.channel.Channel.eve_correction`: "correction_table" is now a required argument.
As in `aiapy.calibrate.correct_degradation`, one can use the `aiapy.calibrate.util.get_correction_table` to get the correction table.

4. `aiapy.calibrate.update_pointing`: "pointing_table" is now a required argument.
To get the pointing table, one can use `aiapy.calibrate.util.get_pointing_table`.
This function now has a "source" keyword which can be used to select between "JSOC" (plus a start and end time) and "LMSAL" to get a copy of the pointing information dated from 11/20/2024 stored on LMSAL servers.

Note that many of the files from SSW are not updated with any frequency and provide worse results than using the data from the JSOC. (`346 <https://github.com/LM-SAL/aiapy/pull/346>`__)


Bug Fixes
---------

- Use `~sunpy.map.GenericMap.reference_date` when constructing an observer coordinate and in place
of pulling ``T_OBS`` directly from the header. (`345 <https://github.com/LM-SAL/aiapy/pull/345>`__)

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

Bug Fixes
---------

- Fixed Spike issue with data being loaded as floats.

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

Breaking Changes
----------------

- All inputs and outputs that previously used "counts" or "ct" now use "DN". (`338 <https://github.com/LM-SAL/aiapy/pull/338>`__)
- Minimum version of ``sunpy`` supported is now ``sunpy`` 6.0.0

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

Breaking Changes
----------------

- Removed the ``aiapy.calibrate.normalize_exposure`` function.
The same functionality can be achieved by dividing a `~sunpy.map.Map` by the exposure time property, ``my_map / my_map.exposure_time``. (`182 <https://github.com/LM-SAL/aiapy/pull/182>`__)
- All the functions in aiapy, that took keywords have been made to only accept them as keyword arguments.
This means that you can no longer pass them as positional arguments. (`313 <https://github.com/LM-SAL/aiapy/pull/313>`__)
- Removed ``setup.cfg`` and ``setup.py`` files, this means you will need to use a modern version of pip (23.0 or above) to install this package now. (`313 <https://github.com/LM-SAL/aiapy/pull/313>`__)
- Increased the minimum version of Python to 3.10 (`313 <https://github.com/LM-SAL/aiapy/pull/313>`__)
- Downgraded warning for Multiple Valid Epochs (`aiapy.util.util._select_epoch_from_correction_table`) to a logging debug message. (`318 <https://github.com/LM-SAL/aiapy/pull/318>`__)


New Features
------------

- Added extra mirrors to fetch files from SSW. (`322 <https://github.com/LM-SAL/aiapy/pull/322>`__)


Documentation
-------------

- Cleaned up notes on AIA data preparation and included respiking procedure in the list of steps. (`182 <https://github.com/LM-SAL/aiapy/pull/182>`__)
- Transformed the documentation layout. (`318 <https://github.com/LM-SAL/aiapy/pull/318>`__)
- Fixed incorrect IDL routine reference in the `aiapy.calibrate.estimate_error` documentation. (`322 <https://github.com/LM-SAL/aiapy/pull/322>`__)
- Improved the "Requesting specific AIA images from the JSOC" Example to animate and use Fido instead of DRMS. (`323 <https://github.com/LM-SAL/aiapy/pull/323>`__)


Internal Changes
----------------

- Catch all `erfa.core.ErfaWarning` that are raised when we convert the times from the error and degradation tables into UTC while making them `astropy.time.Time` objects. (`324 <https://github.com/LM-SAL/aiapy/pull/324>`__)

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

Bug Fixes
---------

- Fixed mismatch with the sample data downloder.
- Fixed theme build to use the new sunpy theme.

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

Bug Fixes
---------

- Fixed missing citation. (`177 <https://gitlab.com/LMSAL_HUB/aia_hub/aiapy/-/merge_requests/177>`__)