Mocpy

Changed

* currently supported versions of python now range from 3.8 to 3.12. There is a catch for python 3.8: the corresponding astropy version is pinned to astropy<5.3
* the deprecated `write` method now calls `save` internally

Fixed

* all methods of `MOC` with signatures like `function(self, lon, lat, **kwargs)` now accept both lists of coordinates and single coordinates
* `mocpy.stmoc.STMOC.from_spatial_coverages` also accepts single moc objects (had to be a list before)
* `AbstractMOC` derives from metaclass `ABCMeta`

Added

* `save` now accepts `fits_keywords` that are added to the fits header before writing the file
* `n_cells` gives the number of cells corresponding to a given order

Added

* brand new support of frequency MOC ! :rocket:
* documentation has galleries of notebooks

Changed

* `AbstractMOC.__init__` raises `PermissionError` if user tries to modify order manually
* `AbstractMOC.store_index_dtype` became `AbstractMOC._store_index_dtype` as is is intended for internal use only to handle 32 and 64b systems
* tests in doctrings now run in CI too
* CI won't run for linux 32 anymore, but support will still be provided upon bug repports

Fixed

* `sum([moc1, moc2, moc3])` now works correctly (fixes 99)
* `MOC.wcs()` now works correctly for non-squared figures (fixes 98)
* `MOC.from_fits_image` now works even when the fits file has no CDELT (fixes 90)

Added

* `MOC.__init__` and `STMOC.__init__` raise `PermissionError` if user tries to modify order manually

Fixed

* :bug: position angle limited to PI/2 instead of PI in `MOC.from_elliptical_cone`

Added

* `MOC.MAX_ORDER` and `TimeMOC.MAX_ORDER` to replace former `IntervalSet.HPX_MAX_ORDER` and `IntervalSet.TIME_MAX_ORDER`
* `MOC.to_depth29_ranges` (+test) to replace former `IntervalSet.nested`
* `TimeMOC.to_depth61_ranges`
* tests on `MOC.uniq_hpx`

Bugfix

* :bug: return statement was missing in `MOC.uniq_hpx`

Added

* add methods `AbstractMOC.__copy__` and `AbstractMOC.__deepcopy__`
* add op parameter `timeout` in `query_simbad` and `query_vizier_table` that defaults to 1000s
* warning if `max_depth` is not set in `MOC.from_valued_cells`

Changed

* ⚠️ BREAKING: public function `set` in `plot.axis_viewport` module has been renamed into `_set_wcs` and moved to module `plot.utils`

Bugfix

* :bug: a bug was introduced in [0.12.0] on the functions `query_simbad` and `query_vizier_table` that are compatible with `pre_v2` format only
* :bug: when `max_depth=None` in `MOC.from_valued_cells`

Removed

* ⚠️ BREAKING: Deserialisation of ST-MOCs from FITs HDU (reading/writting FITS file fully supported
on the Rust side)
* ⚠️ BREAKING: Remove support of pre_v2 ST-MOC fits file writing (reading still ok)
* ⚠️ BREAKING: internal class `IntervalSet` removed
* ⚠️ BREAKING: `utils` file removed

Added

* add `hdu_index` optional parameter in `MOC.from_fits_images`
* `TimeMOC.to_time_ranges` to get time ranges from a T-MOC
* `MOC.to_rgba` and `MOC.dsiplay_preview` for a quick S-MOC allsky view
* `uniq_gen` and `uniq_zorder` added to `AbstractMOC`
* `flatten` added to `AbstractMOC`
* constructor `MOC.from_healpix_depth29_ranges`
* parameter `values_are_densities` in `MOC.from_valued_healpix_cells`
* parameter `complement` in `MOC.from_polygon`
* `+`, `|`, `-`, `&`, `~` operators redefinition for `union`, `union`, `difference`, `intersect` and `complement` respectively.
* `contains_skycoords` and `contains_lonlat` to replace `contains`
* add `fold` parameter into `save` and `to_string`
* add `MOC.barycenter` and `MOC.largest_distance_from_coo_to_vertices` of a moc
* add `MOC.wcs` giving an astropy WCS centered around a the barycenter of moc

Changed

* ⚠️ BREAKING: `times_to_microseconds` and `microseconds_to_times` moved from `utils` to `tmoc`.
* ⚠️ BREAKING: `uniq` removed from `IntervalSet`, but replacing method `uniq_hpx` added to `MOC`
* ⚠️ BREAKING: the output of `uniq_hpx` is not sorted (but follow the order of the cells in the internal range list)
* ⚠️ BREAKING: `STMOC.query_by_time` now takes in input a `TimeMOC`
* ⚠️ BREAKING: `STMOC.query_by_space` now returns a `MOC`
* ⚠️ BREAKING: `TimeMOC.contains` does not take any longer a time resolution as input parameter
* ⚠️ BREAKING: `TimeMOC.contains_with_timeresolution` as been added with the previous behaviour of `TimeMOC.contains`
* add `save` to `AbstractMOC` and remove from sub-classes
* add `to_string` to `AbstractMOC` and remove from sub-classes
* `from_uniq` removed from `IntervalSet` and added to `MOC`
* change the `contains` implementation to be much memory efficient, faster, and thus working at all HEALPix orders.
* update `cdshealpix` and `moc` dependencies
* ⚠️ BREAKING: `MOC.from_healpix_cells`
* now requires the `max_depth`, the depth of the MOC we want to create
* optional parameter `fully_covered` removed since it was not used
* ⚠️ BREAKING: in `MOC.from_valued_healpix_cells`, the user now have to degrade manually the resolution
if max_depth < deepest cell depth.
* ⚠️ BREAKING: `World2ScreenMPL` has been renamed `WCS`