Insert coordinate values before the given indices in the object and return a new Frame object.

The values to be inserted must conform to the rules for in-place setting of |SkyCoord| objects.

The API signature matches the np.insert API, but is more limited. The specification of insert index obj must be a single integer, and the axis must be 0 for simple insertion before the index.

Parameters¶

objint

Integer index before which values is inserted.

valuesarray-like

Value(s) to insert. If the type of values is different from that of quantity, values is converted to the matching type.

axisint, optional

Axis along which to insert values. Default is 0, which is the only allowed value and will insert a row.

Returns¶

out~astropy.coordinates.SkyCoord instance

New coordinate object with inserted value(s)