There is a newer version of the record available.

Published March 1, 2023 | Version v2.1.0post1

sunpy/ndcube: v2.1.0

Description

v2.1.0 (2023-03-01) Backwards Incompatible Changes
  • To support compatibility with reproject 0.9, the API of <span class="title-ref">.NDCube.reproject\_to</span> has been tweaked so that any keyword argument to the underlying reprojection function can be passed through. This has the effect of being a breaking change if you were specifying any arguments after shape_out= as positional rather than keyword arguments. (Note that in a future release we will probably change to require keyword arguments to reproject_to. (#552)
Features
  • Implement new property, <span class="title-ref">ndcube.ExtraCoords.is\_empty</span> that returns True if the object has got extra coords. Otherwise return False. (#450)
  • Add <span class="title-ref">ndcube.ExtraCoords.resample</span> method to resample extra coordinates by a certain factor in each array dimension. (#450)
  • Implement a new <span class="title-ref">ndcube.NDCube.rebin</span> method to combine integer numbers of pixels along each axis into larger pixels. (#450)
  • Add new methods to interpolate lookup table coordinates: <span class="title-ref">ndcube.extra\_coords.table\_coord.QuantityTableCoordinate.interpolate</span>, <span class="title-ref">ndcube.extra\_coords.table\_coord.SkyCoordTableCoordinate.interpolate</span>, <span class="title-ref">ndcube.extra\_coords.table\_coord.TimeTableCoordinate.interpolate</span>, <span class="title-ref">ndcube.extra\_coords.table\_coord.MultipleTableCoordinate.interpolate</span> (#450)
  • Add <span class="title-ref">ndcube.NDCubeSequence.crop</span> and <span class="title-ref">ndcube.NDCubeSequence.crop\_by\_values</span> methods which crop the <span class="title-ref">~ndcube.NDCubeSequence</span> based on input world coordinate ranges. (#466)
  • Add basic arithmetic methods between <span class="title-ref">~ndcube.NDCube</span> objects and broadcastable arrays, scalars, and <span class="title-ref">~astropy.unit.Quantity</span> objects. Operations between two <span class="title-ref">~ndcube.NDCube</span> objects are not supported. (#541)
  • Add <span class="title-ref">ndcube.NDCube.to</span> to convert cube to new unit. (#586)
  • Created <span class="title-ref">~ndcube.GlobalCoordsABC</span> and updated <span class="title-ref">~ndcube.NDCubeABC</span>, and <span class="title-ref">~ndcube.extra\_coords.ExtraCoordsABC</span> to reflect official NDCube 2 API definition in SEP. (#592)
Bug Fixes
  • Fix bug #535 where <span class="title-ref">NDCollection</span> could not update when <span class="title-ref">aligned\_axes</span> is <span class="title-ref">None</span> (#538)
  • Fix a bug where <span class="title-ref">aligned\_axis\_physical\_types</span> caused <span class="title-ref">\_\_str\_\_</span> to error when <span class="title-ref">aligned\_axes</span> was <span class="title-ref">None</span>. (#539)
  • Fix a bug where data_unit was not being correctly passed through to the underlying plotting function when animating a cube. (#578)
Improved Documentation
  • Add example to example gallery of how to create an NDCube from a FITS file. (#544)
v2.0.3 (2022-09-23) Bug Fixes
  • Dynamically copy docstring and function signature from <span class="title-ref">NDCube.plotter.plot()</span> to <span class="title-ref">NDCube.plot()</span>. (#534)
  • Fixed a bug where the <span class="title-ref">plot\_axes</span> key was not respected when passing <span class="title-ref">axes</span> to <span class="title-ref">plot</span> for 2D cubes. (#551)
  • Limit maximum reproject version to 0.9 due to API changes. ndcube 2.1 will support the new reproject keyword arguments. (#564)
v2.0.2 (2022-05-10) Bug Fixes
  • Fix a bug in the NDCube._as_mpl_axes implementation, allowing cubes with compatible dimensions to be passed as the projection= keyword argument to certain matplotlib functions again. (#509)
Trivial/Internal Changes
  • Remove use of deprecated distutils module. (#520)
2.0.1 (2021-11-19) Bug Fixes
  • Enable <span class="title-ref">~ndcube.NDCollection</span> to accept aligned axes inputs in any integer type. (#495)
  • Patch to convert quantity objects passed to crop_by_coords to the units given in the wcs.world_axis_units. (#497)
  • Fix a bug which prevented the axes_units= kwarg from working when using the matplotlib animators. (#498)
  • Add support for length-1 lookup table coords within extra coords. (#499)
  • Bump the minimum version of astropy to 4.2 to correctly support capturing dropped world dimensions into global coords when slicing the WCS. (#500)
2.0.0 (2021-10-29) Backwards Incompatible Changes
  • Remove unused util functions and the ndcube WCS class. Refactor util functions for converting between between data and WCS indices to reflect the APE14 nomenclature that distinguishes between array, pixel and world axes. (#280)
  • NDCubeSequence animation axes can no longer be set by extra coords. (#294)
  • ImageAnimatorNDCubeSequence, ImageAnimatorCubeLikeNDCubeSequence, LineAnimatorNDCubeSequence and LineAnimatorCubeLikeNDCubeSequence have been removed and replaced by NDCubeSequenceAnimator. (#294)
  • Change type of output of <span class="title-ref">.NDCollection.aligned\_world\_axis\_physical\_types</span> from tuple to list. This is to be consistent with output of <span class="title-ref">astropy.wcs.WCS.world\_axis\_physical\_types</span>. (#302)
  • Change output type when common axis item is a slice that covers only one subcube. Previously this would return an NDCube. Now an NDCubeSequence is always returned unless the common axis item is an integer. Also, refactor NDCubeSequence.index_as_cube so codebase is simpler. (#311)
  • Replace NDCube.crop_by_coords and NDCube.crop_by_extra_coords with new method, NDCube.crop (#316)
  • Remove NDCubeSequence plotting. (#322)
  • Update <span class="title-ref">.NDCube.array\_axis\_physical\_types</span> return physical types from extra coords as well as the WCS. (#338)
  • Rename <span class="title-ref">.ExtraCoords.add</span> method from previous name "add_coordinate". (#394)
  • The <span class="title-ref">~.NDcube</span> object no longer inherits from <span class="title-ref">astropy.nddata.NDArithmeticMixin</span> as the methods were not coordinate aware. (#457)
Deprecations and Removals
  • Remove <span class="title-ref">NDCube.pixel\_to\_world</span> and <span class="title-ref">NDCube.world\_to\_pixel</span>. (#300)
  • Remove world_axis_physical_types methods from <span class="title-ref">.NDCube</span> and <span class="title-ref">.NDCubeSequence</span>. (#302)
  • Remove NDCubeSequence.sequence_axis_extra_coords. This is replaced by NDCubeSequence.sequence_axis_coords. (#335)
  • Remove <span class="title-ref">ndcube.NDCubeSequence.common\_axis\_extra\_coords</span>. Will be replaced by <span class="title-ref">ndcube.NDCubeSequence.common\_axis\_coords</span>. (#344)
  • Remove NDCollection.aligned_world_axis_physical_types. It will be replaced by <span class="title-ref">~ndcube.NDCollection.aligned\_axis\_physical\_types</span>. (#347)
Features
  • Implement a new <span class="title-ref">.ExtraCoords</span> class which allows the specification of extra coordinates via lookup tables or WCS. This class exposes the extra coords as an APE 14 WCS object. (#271)

  • Add new method, <span class="title-ref">~ndcube.NDCube.axis\_world\_coord\_values</span>, to return world coords for all pixels for all axes in WCS as quantity objects. (#279)

  • Added a new method <span class="title-ref">ndcube.NDCube.array\_axis\_physical\_types</span> to show which physical types are associated with each array axis. (#281)

  • Add properties to NDCubeSequence giving the world physical types for each array axis. (#301)

  • Add as_mpl_axes method to NDCube plotting mixin so the an NDCube can be provided to astropy WCSAxes as a projection. (#314)

  • Make pyplot colorbar work with the output on NDCube.plot when it is a 2D image. (#314)

  • Introduce a new class, <span class="title-ref">~ndcube.global\_coords.GlobalCoords</span>, for holding scalar coordinates that don't apply to any pixel axes. (#323)

  • Implement <span class="title-ref">.NDCube.world\_axis\_coords</span> which returns high level coordinate objects for all, or a subset of, axes. (#327)

  • New property, NDCubeSequence.sequence_axis_coords creates lists of GlobalCoords from each NDCube in the sequence. This replaces NDCubeSequence.sequence_axis_extra_coords, but because it uses the GlobaCoords infrastructure, can handle more than just coords that began as extra coords. (#335)

  • Implement <span class="title-ref">ndcube.NDCubeSequence.common\_axis\_coords</span> to replace <span class="title-ref">~ndcube.NDCubeSequence.common\_axis\_extra\_coords</span>. In contrast to old property, this new property collates coordinates from the wcs as well as extra_coords. (#344)

  • New property, <span class="title-ref">ndcube.NDCollection.aligned\_axis\_physical\_types</span>. This replaces <span class="title-ref">~ndcube.NDCollection.aligned\_world\_axis\_physical\_types</span> and returns a list of tuples, where each tuple gives the physical types common between all memebers of the collection for a given aligned axis. (#347)

  • Allow <span class="title-ref">ndcube.NDCubeSequence.explode\_along\_axis</span> to explode sequence along any axis, not just the common axis. (#358)

  • Plotting functionality on <span class="title-ref">NDCube</span> has been refactored to use pluggable "plotter" classes. All plotting functionality can now be accessed via the <span class="title-ref">.NDCube.plotter</span> attribute, with <span class="title-ref">.NDCube.plot</span> becoming an alias for <span class="title-ref">.NDCube.plotter.plot</span>.

    Advanced users, or package maintainers that which to customise the plotting functionality of an NDCube instance can set the .plotter attribute of a cube to be a subclass of <span class="title-ref">ndcube.visualization.BasePlotter</span> which then customises the behaviour of the NDCube.plot() method and provides any other methods implemented on the plotter. (#401)

  • Preserve sliced-out coordinates from WCS in the GlobalCoords instance. (#402)

  • Enable instantiating an NDCube from an existing NDCube by copying extra/global coords. (#404)

  • Support exposing dropped dimensions when <span class="title-ref">.ExtraCoords</span> is sliced. (#411)

  • <span class="title-ref">~ExtraCoords</span> is now explicitly limited to one dimensional tables because of a limitation in our use of <span class="title-ref">astropy.modeling</span>. (#414)

  • Adds functionality to reproject an <span class="title-ref">~.NDCube</span> object to coordinates described by another WCS or FITS Header by calling the new <span class="title-ref">~.NDCube.reproject\_to</span> method. (#434)

  • Change the edges= keyword to pixel_corners= in <span class="title-ref">NDCube.axis\_world\_coords</span> and <span class="title-ref">NDCube.axis\_world\_coords\_values</span> to make its meaning clearer based on SEP feedback. (#437)

  • <span class="title-ref">~.NDCube.axis\_world\_coords</span> and <span class="title-ref">~.NDCube.axis\_world\_coords\_values</span> now use a different, substantially faster and more memory efficient algorithm to generate the coordinates along all axes. (#442)

  • Extends <span class="title-ref">~.NDCube.reproject\_to</span> functionality by supporting adaptive and exact algorithms for an <span class="title-ref">~NDCube</span> with 2D celestial WCS. (#448)

  • Introduce optional offset between old and new pixel grids in <span class="title-ref">~ndcube.wcs.wrappers.resampled\_wcs.ResampledLowLevelWCS</span>. (#449)

  • <span class="title-ref">.ExtraCoords.from\_lookup\_table</span> accepts (a seqence of) physical_types as kwarg to set the types of its lookup_tables. (#451)

  • Create new plotter class for animating <span class="title-ref">~ndcube.NDCubeSequence</span> is the 2.0 framework. This class always sets the sequence axis as a slider and leverages <span class="title-ref">ndcube.NDCube.plot</span>. (#456)

  • Add __len__ method to <span class="title-ref">~ndcube.NDCubeSequence</span> which makes len(sequence) return the number of cubes in the sequence. (#464)

  • Add __iter__ method to <span class="title-ref">~ndcube.NDCubeSequence</span> which iterates through the cubes within the sequence. (#465)

  • Add property to <span class="title-ref">~ndcube.extra\_coords.ExtraCoords</span> that returns a WCS of extra coords that describes all axes of associated cube. (#472)

Bug Fixes
  • Fix NDCollection.aligned_dimensions so it doesnt crash when components of collection are NDCubeSequences. (#264)

  • Generalize int type checking so it is independent of the bit-type of the OS. (#269)

  • Fix axis_world_coord_values when the WCS is 1D and ensure it always returns Quantities (#287)

  • Change name of NDCube.axis_world_coord_values to NDCube.axis_world_coords_values to be consistent with NDCube.axis_world_coords (#293)

  • Remove NDCubeSequence animation dependence of deprecated sunpy ImageAnimator and LineAnimator classes in favour of ArrayAnimatorWCS class. (#294)

  • Fix bug whereby common axis was not updated appropriately when slicing an NDCubeSequence. (#310)

  • Fix bug in NDCube.axis_world_coords_values when number of pixel and world dimensions differ. (#319)

  • Fixes bug in <span class="title-ref">~ndcube.utils.wcs.array\_indices\_for\_world\_objects</span> when the WCS input does not have a world_axis_object_components attribute. The fix causes the low_level_wcs version is tried before the code fails. This enables <span class="title-ref">ndcube.NDCube.combined\_wcs</span> to be used with this function. (#344)

  • Fixes IndexError in <span class="title-ref">~ndcube.utils.wcs.array\_indices\_for\_world\_objects</span> which occurred when some of the world axes are dependent. (#344)

  • Stop <span class="title-ref">ndcube.NDCube.explode\_along\_axis</span> setting a common axis to the output <span class="title-ref">~ndcube.NDCubeSequence</span>. The output sequence should have no common axis. (#358)

  • Enable 2-D NDCubes to be visualized as a 1-D animated line. (#381)

  • Ensure corner inputs to <span class="title-ref">ndcube.NDCube.crop</span> are converted to units stored in WCS as <span class="title-ref">~astropy.wcs.WCS.world\_to\_array\_index\_values</span> does not handle units. (#382)

  • updated ndcube github repository link in <span class="title-ref">ndcube.docs.installation.rst</span>. (#392)

  • Fix bug in NDCube.axis_world_coords_values when axes_coords is initially a bare astropy coordinate object rather than a list/tuple of coordinate objects. (#400)

  • Change the implementation of <span class="title-ref">.NDCube.crop</span> so that it takes into account all the corners of the world region specified by the upper and lower corners, not just those two points. (#438)

  • Ensure <span class="title-ref">NDCube</span> init forces WCS to become high level.

    This patches a bug in astropy. (#447)

  • Fix bug in <span class="title-ref">~ndcube.NDCube.axis\_world\_coords\_values</span> which caused the units to be stripped when an axes input was given. (#461)

  • Fix bug in <span class="title-ref">~ndcube.utils.wcs.get\_dependent\_world\_axes</span> where an erroneous matrix transpose caused an error for non-square axis correlation matrices and wrong results for diagonally non-symmetric ones. (#471)

  • Extend support for cropping an <span class="title-ref">~ndcube.NDCube</span> using an <span class="title-ref">~ndcube.extra\_coords.ExtraCoords</span> instance as the wcs. (#472)

  • Fix check as to whether user inputs to <span class="title-ref">ndcube.wcs.wrappers.CompoundLowLevelWCS.world\_to\_pixel\_values</span> result in consistent pixel values when world dimensions share pixel dimensions. Previously this check was unreliable when non-trivial mapping between world and pixel dimensions was used. (#472)

  • Fix slicing <span class="title-ref">~ndcube.ExtraCoords</span> made of lookup tables. This bug meant that mapping of coords to arrays axes was not adjusted when an axis was dropped. (#482)

Improved Documentation
  • Document accepted input to lookup_table in <span class="title-ref">.ExtraCoords</span> setting its physical_types. (#451)
  • Improved information and formatting of __str__ methods. (#453)
Trivial/Internal Changes
  • Simplify and speed up implementation of NDCubeSequence slicing. (#251)
  • Fix docstring formatting to help docs build. (#262)
  • Use pytest-mpl for figure tests. (#312)
  • Port the tests for NDCube to use pytest fixtures (#318)
  • Allow corner inputs to <span class="title-ref">~ndcube.NDCube.crop</span> to not be wrapped in a <span class="title-ref">tuple</span> is only one high level coordinate objects required. (#380)
  • Make sunpy an optional dependence. Without it, the _animate_cube plotting functionality will be disabled. (#393)
  • Adds a function to compare the physical types of two WCS objects. (#433)
  • Propagate reference to NDCube object through <span class="title-ref">~ndcube.extra\_coords.ExtraCoords</span> string slicing. (#454)
  • Adds a function to identify invariant axes between two WCS objects. (#459)
  • The matplotlib animators code has been moved from <span class="title-ref">sunpy</span> to a new package <span class="title-ref">mpl\_animators</span> so ndcube no longer has an optional dependancy on sunpy. (#484)
1.3.0 (2020-03-27) Features
  • Add new NDCollection class for linking and manipulating partially or non-aligned NDCubes or NDCubeSequences. (#238)
Bug Fixes
  • Fixed the files included and excluded from the tarball. (#212)
  • Fix crashing bug when an NDCube axis after the first is sliced with a numpy.int64. (#223)
  • Raises error if NDCube is sliced with an Ellipsis. (#224)
  • Changes behavior of NDCubeSequence slicing. Previously, a slice item of interval length 1 would cause an NDCube object to be returned. Now an NDCubeSequence made up of 1 NDCube is returned. This is consistent with how interval length 1 slice items slice arrays. (#241)
1.2.0 (2019-09-10) Features
  • Changed all instances of "missing_axis" to "missing_axes" (#157)
  • Added a feature to get the pixel_edges from <span class="title-ref">ndcube.NDCube.axis\_world\_coords</span> (#174)
Bug Fixes
  • <span class="title-ref">ndcube.NDCube.world\_axis\_physical\_types</span> now sets the axis label to the WCS CTYPE if no corresponding IVOA name can be found. (#164)
  • Fixed the bug of using <span class="title-ref">pixel\_edges</span> instead of <span class="title-ref">pixel\_values</span> in plotting (#176)
  • Fix 2D plotting from crashing when both data and WCS are 2D. (#182)
  • Fix the ability to pass a custom Axes to <span class="title-ref">ndcube.NDCube.plot</span> for a 2D cube. (#204)
Trivial/Internal Changes
  • Include more helpful error when invalid item type is used to slice an <span class="title-ref">~ndcube.NDCube</span>. (#158)
1.1 API-Breaking Changes
  • <span class="title-ref">~ndcube.NDCubeBase.crop\_by\_extra\_coord</span> API has been broken and replaced. Old version: crop_by_extra_coord(min_coord_value, interval_width, coord_name). New version: crop_by_extra_coord(coord_name, min_coord_value, max_coord_value). [#142]
New Features
  • Created a new <span class="title-ref">~ndcube.NDCubeBase</span> which has all the functionality of <span class="title-ref">~ncube.NDCube</span> except the plotting. The old NDCubeBase which outlined the NDCube API was renamed NDCubeABC. <span class="title-ref">~ndcube.NDCube</span> has all the same functionality as before except is now simply inherits from <span class="title-ref">~ndcube.NDCubeBase</span> and <span class="title-ref">~ndcube.mixins.plotting.NDCubePlotMixin</span>. [#101]
  • Moved NDCubSequence plotting to a new mixin class, NDCubSequencePlotMixin, making the plotting an optional extra. All the non-plotting functionality now lives in the NDCubeSequenceBase class. [#98]
  • Created a new <span class="title-ref">~ndcube.NDCubeBase.explode\_along\_axis</span> method that breaks an NDCube out into an NDCubeSequence along a chosen axis. It is equivalent to <span class="title-ref">~ndcube.NDCubeSequenceBase.explode\_along\_axis</span>. [#118]
  • NDCubeSequence plot mixin can now animate a cube as a 1-D line if a single axis number is supplied to plot_axis_indices kwarg.
API Changes
  • Replaced API of what was previously utils.wcs.get_dependent_axes, with two new functions, utils.wcs.get_dependent_data_axes and utils.wcs.get_dependent_wcs_axes. This was inspired by a new implementation in glue-viz which is intended to be merged into astropy in the future. This API change helped fix the NDCube.world_axis_physical_type bug listed below. [#80]
  • Give users more control in plotting both for NDCubePlotMixin and NDCubeSequencePlotMixin. In most cases the axes coordinates, axes units, and data unit can be supplied manually or via supplying the name of an extra coordinate if it is wanted to describe an axis. In the case of NDCube, the old API is currently still supported by will be removed in future versions. [#98 #103]
Bug Fixes
  • Allowed <span class="title-ref">~ndcube.NDCubeBase.axis\_world\_coords</span> to accept negative axis indices as arguments. [#106]
  • Fixed bug in NDCube.crop_by_coords in case where real world coordinate system was rotated relative to pixel grid. [#113].
  • <span class="title-ref">~ndcube.NDCubeBase.world\_axis\_physical\_types</span> is now not case-sensitive to the CTYPE values in the WCS. [#109]
  • <span class="title-ref">~ndcube.NDCubeBase.plot</span> now generates a 1-D line animation when image_axis is an integer.
1.0.1 New Features
  • Added installation instructions to docs. [#77]
Bug Fixes
  • Fixed bugs in NDCubeSequence slicing and NDCubeSequence.dimensions in cases where sub-cubes contain scalar .data. [#79]
  • Fixed NDCube.world_axis_physical_types in cases where there is a missing WCS axis. [#80]
  • Fixed bugs in converting between negative data and WCS axis numbers. [#91]
  • Add installation instruction to docs. [#77]
  • Fix function name called within NDCubeSequence.plot animation update plot. [#95]

Files

sunpy/ndcube-v2.1.0post1.zip

Files (684.0 kB)

Name Size
md5:49ec87f9c7de526b3bc52b5c5fb3d5af
684.0 kB Preview Download

Additional details

Related works