lisa.datautils.df_dereference

lisa.datautils.df_dereference(df, col, pointer_col=None, sources=None, inplace=False, **kwargs)

Similar to series_dereference().

Example:

df = pd.DataFrame({
    'ptr': ['A', 'B'],
    'A'  : ['A1', 'A2'],
    'B'  : ['B1', 'B2'],
})
df = df_dereference(df, 'dereferenced', pointer_col='ptr')
#   ptr   A   B dereferenced
# 0   A  A1  B1           A1
# 1   B  A2  B2           B2

Parameters:

• df (pandas.DataFrame) – Dataframe to act on.

• col (str) – Name of the column to create.

• pointer_col (str or None) – Name of the column containing “pointer” values. Defaults to the same value as col.

• sources (collections.abc.Mapping or pandas.DataFrame) – Same meaning as in series_dereference(). If omitted, df is used.

• inplace (bool) – If True, the dataframe is modified inplace.

Variable keyword arguments:

Forwarded to series_dereference().