larray.Axis.extend

Axis.extend(labels) Axis[source]

Append new labels to an axis or increase its length in case of wildcard axis. Note that extend does not occur in-place: a new axis object is allocated, filled and returned.

Parameters
labelsint, iterable or Axis

New labels to append to the axis. Passing directly another Axis is also possible. If the current axis is a wildcard axis, passing a length is enough.

Returns
Axis

A copy of the axis with new labels appended to it or with increased length (if wildcard).

Examples

>>> time = Axis([2007, 2008], 'time')
>>> time
Axis([2007, 2008], 'time')
>>> time.extend([2009, 2010])
Axis([2007, 2008, 2009, 2010], 'time')
>>> waxis = Axis(10, 'wildcard_axis')
>>> waxis
Axis(10, 'wildcard_axis')
>>> waxis.extend(5)
Axis(15, 'wildcard_axis')
>>> waxis.extend([11, 12, 13, 14])
Traceback (most recent call last):
...
ValueError: Axis to append must (not) be wildcard if this axis is (not) wildcard