# Release Notes

This document presents the most notable user-level changes in each release of SpacePy. The CHANGELOG file in the source distribution contains more detail.

- 0.2 Series

  - 0.2.2 (2020-12-29)

  - 0.2.1 (2019-10-02)

  - 0.2.0 (2019-06-22)

- 0.1 Series

  - 0.1.6 (2016-09-08)

  - 0.1.5 (2014-12-23)

  - 0.1.4 (2013-05-21)

  - 0.1.3 (2012-06-22)

  - 0.1.2 (2012-05-25)

  - 0.1.1 (2011-10-31)

  - 0.1 (2011-08-24)

## 0.2 Series

### 0.2.2 (2020-12-29)

The 0.2 series will be the last with full support for Python 2; 0.2.3 will likely be the last release. Binary installers for 32-bit Windows will also end after the 0.2 series.

#### New features

`irbempy` incorporates upstream IRBEMlib rev620. This adds IGRF13 coefficients. `coordinates` and `irbempy` now also support using all supported coordinate systems as inputs to routines; if a routine does not support an input system, it will be automatically converted.

`Ticktock` supports conversions to and from `astropy.time.Time`.

The following classes, functions, and methods are new:

`quaternionFromMatrix`(matrix[, scalarPos]) | Given an input rotation matrix, return the equivalent quaternion
`quaternionToMatrix`(Qin[, scalarPos, normalize]) | Given an input quaternion, return the equivalent rotation matrix.
`rebin`(data, bindata, bins[, axis, bintype, …]) | Rebin one axis of input data based on values of another array
`add_arrows`(lines[, n, size, style, …]) | Add directional arrows along a plotted line.
`concatCDF`(cdfs[, varnames, raw]) | Concatenate data from multiple CDFs
`nanfill`(v) | Set fill values to NaN
`empty_entry`(f) | Check for attributes with empty string
`VarBundle`(var) | Collective handling of ISTP-compliant variable and its dependencies.
`deltas`(v) | Check DELTA variables
`empty_entry`(v) | Check for attributes with empty string

#### Deprecations and removals

`pycdf` now warns if creating a new CDF file without explicitly setting backward compatible or not backward compatible (`set_backward()`). The default is still to make backward-compatible CDFs, but this will change in 0.3.0. Similarly it now warns if creating a time variable without specifying a time type; the default is still to use EPOCH or EPOCH16, but this will change to TIME_TT2000 in 0.3.0.

`fix_format()` is now deprecated, as `Iono` can now read these files directly.

Quaternion math functions have been moved to `coordinates`; using the functions in `toolbox` is deprecated.

`feq()` is deprecated; numpy 1.7 added the equivalent `isclose()`.

The `spectrogram` class is now capitalized (`Spectrogram`); the old, lower-case variant is kept for compatibility but will be removed.

#### Dependency requirements

Not all dependencies are required for all functionality; see SpacePy Dependencies for full details, including what functionality is lost if a dependency is not installed.

numpy 1.10 is now required. (Many functions erroneously required it from 0.2.1, but this was not adequately documented.)

scipy 0.11 is now the minimum supported version of SciPy. (Again, this was erroneously required in 0.2.0 without appropriate documentation.)

Several dependencies without an established minimum version were tested.

As of 0.2.2, minimum supported versions of dependencies are:

  - CPython 2 2.7 or CPython 3 3.2

  - AstroPy 1.0

  - CDF 2.7

  - dateutil 1.4 (earlier may work)

  - ffnet 0.7 (earlier may work)

  - h5py 2.6 (earlier may work)

  - matplotlib 1.5

  - networkx 1.0 (earlier may work)

  - numpy 1.10

  - scipy 0.11

#### Major bugfixes

Time conversions between time systems before 1961 now use the proper number of leapseconds (0).

Many minor bugfixes.

#### Other changes

Data sources for leapsecond files and `omni` Qin-Denton files have been updated to provide current sources. If present, entries in the configuration file will still be used instead. A (configurable) warning is issued for out-of-date leapsecond files.

The representation of leap second intervals in time systems which cannot directly represent them has been changed. Formerly times such as 2008-12-31T23:59:60 were represented in e.g. UTC datetime as the the beginning of the next day, e.g. 2009-01-01T00:00:00. They are now represented by the last possible moment of the same day, e.g. 2008-12-31T23:59:59.999999. Fractional leapsecond counts are now rounded to the integer instead of truncated; this rounding is applied to the total TAI - UTC quantity not the individual increments of leap seconds. E.g successive 0.2, 0.2, 0.2 leap seconds will result in 0, 0, and 1 new leap seconds.

Similarly, leap seconds are now included in the fractional day calculation of MJD, so MJD values around a leap second may be different than in previous versions of SpacePy.

Most time systems are now converted to/from TAI rather than using datetime. This may cause small differences with previous versions of SpacePy, on order of a double precision. RDT and JD are particularly affected for dates in the modern era. Time conversions around leapseconds may also be different; in many cases they were undefined in previous versions.

`now()` and `today()` return times in UTC; in previous versions the value returned was local, but was treated as UTC for all conversions (and thus inaccurate.)

See `time` for full discussion of leap seconds, time resolution, and other conversion considerations.

### 0.2.1 (2019-10-02)

#### New features

The following module is new:

`istp` | Support for ISTP-compliant CDFs

#### Deprecations and removals

None

#### Dependency requirements

No changes to minimum dependency versions.

As of 0.2.1, the minimum versions of dependencies are:

  - CPython 2 2.7 or CPython 3 3.2

  - CDF 2.7

  - matplotlib 1.5

  - numpy 1.4

  - scipy 0.10

Other dependencies have no established minimum. See SpacePy Dependencies for full details.

#### Major bugfixes

Fixed compliation of `irbempy` on several systems.

#### Other changes

None of note.

### 0.2.0 (2019-06-22)

#### New features

#### Deprecations and removals

None

#### Dependency requirements

Support for Python 2.6 was removed; 2.7 is the only supported version of Python 2.

As of 0.2.0, the minimum versions of dependencies are:

  - CPython 2 2.6 or CPython 3 3.2

  - CDF 2.7

  - matplotlib 1.5

  - numpy 1.4

  - scipy 0.10

Other dependencies have no established minimum. See SpacePy Dependencies for full details.

#### Major bugfixes

`human_sort()` was fixed for non-numeric inputs (the normal case.) This had been broken since 0.1.6.

Many minor bugfixes as well.

#### Other changes

Many updates to improve ease of installation, including Windows binary wheels.

## 0.1 Series

See the CHANGELOG file in the source distribution for changes in the 0.1 release series.

### 0.1.6 (2016-09-08)

### 0.1.5 (2014-12-23)

### 0.1.4 (2013-05-21)

### 0.1.3 (2012-06-22)

### 0.1.2 (2012-05-25)

### 0.1.1 (2011-10-31)

### 0.1 (2011-08-24)