MulSeries.insert#

MulSeries.insert(label, value, loc=None, name=None, inplace=True)#

Insert a value into MulSeries at specified location.

Duplicate labels are allowed. It is an append operation if loc=None.

Parameters#

labelstr, number, or hashable object: Label of the inserted value
valueScalar: The inserted value.
locint: Insertion index. Must verify 0 <= loc <= MulSeries.shape[0] if axis==0. If loc=None, insert at the end of the MulSeries, namely an append operation.
nameScalar, Series, or array-like: The metadata of value inserted into the index dataframe.
inplacebool, default True: Whether insert inplace or return a new MulSeries.

Returns#

None or MulSeries: returns None if inplace=True

Examples#

>>> import pandas as pd
>>> import muldataframe as md
>>> index = pd.DataFrame([[1,2],[3,6],[5,6]],
             index=['a','b','b'],
             columns=['x','y'])
>>> columns = pd.DataFrame([[5,7],[3,6]],
                index=['c','d'],
                columns=['f','g'])
>>> ms = MulSeries([1,8,9],index=index,name=columns.loc['c'])
>>> ms.insert('e',7,loc=1,name=[8,9],inplace=False)
(4,)     g  7
         f  5
            c
-------  ------
   x  y     c
a  1  2  a  1
e  8  9  e  7
b  3  6  b  8
b  5  6  b  9