holoviews.core.data.pandas module

class holoviews.core.data.pandas.PandasAPI

Bases: object

This class is used to describe the interface as having a pandas-like API.

The reason to have this class is that it is not always possible to directly inherit from the PandasInterface.

This class should not have any logic as it should be used like:

if issubclass(interface, PandasAPI):

…

class holoviews.core.data.pandas.PandasInterface(*, name)

Bases: Interface, PandasAPI

Methods

add_dimension(dataset, dimension, dim_pos, ...)	Returns a copy of the data with the dimension values added.
applies(obj)	Indicates whether the interface is designed specifically to handle the supplied object's type.
as_dframe(dataset)	Returns the data of a Dataset as a dataframe avoiding copying if it already a dataframe type.
assign(dataset, new_data)	Adds a dictionary containing data for multiple new dimensions to a copy of the dataset.data.
dframe(dataset, dimensions)	Returns the data as a pandas.DataFrame containing the selected dimensions.
dtype(dataset, dimension)	Returns the dtype for the selected dimension.
iloc(dataset, index)	Implements integer indexing on the rows and columns of the data.
isscalar(dataset, dim)	Whether the selected dimension is a scalar value.
loaded()	Indicates whether the required dependencies are loaded.
range(dataset, dimension)	Computes the minimum and maximum value along a dimension.
redim(dataset, dimensions)	Renames dimensions in the data.
reindex(dataset[, kdims, vdims])	Reindexes data given new key and value dimensions.
unpack_scalar(dataset, data)	Given a dataset object and data in the appropriate format for the interface, return a simple scalar.
validate(dataset[, vdims])	Validation runs after the Dataset has been constructed and should validate that the Dataset is correctly formed and contains all declared dimensions.
values(dataset, dim[, expanded, flat, ...])	Returns the values along a dimension of the dataset.

aggregate
concat
concat_fn
dimension_type
groupby
index_selection
index_values
indexes
init
isindex
mask
sample
select
sort
sort_depth
sorted_index

Parameter Definitions

---

classmethod add_dimension(dataset, dimension, dim_pos, values, vdim)

Returns a copy of the data with the dimension values added.

Parameters:

datasetDataset

The Dataset to add the dimension to

dimensionDimension

The dimension to add

dim_posint

The position in the data to add it to

valuesarray_like

The array of values to add

vdimbool

Whether the data is a value dimension

Returns:

data

A copy of the data with the new dimension

classmethod applies(obj)

Indicates whether the interface is designed specifically to handle the supplied object’s type. By default simply checks if the object is one of the types declared on the class, however if the type is expensive to import at load time the method may be overridden.

classmethod as_dframe(dataset)

Returns the data of a Dataset as a dataframe avoiding copying if it already a dataframe type.

classmethod assign(dataset, new_data)

Adds a dictionary containing data for multiple new dimensions to a copy of the dataset.data.

Parameters:

datasetDataset

The Dataset to add the dimension to

new_datadict

Dictionary containing new data to add to the Dataset

Returns:

data

A copy of the data with the new data dimensions added

classmethod dframe(dataset, dimensions)

Returns the data as a pandas.DataFrame containing the selected dimensions.

Parameters:

datasetDataset

The dataset to convert

dimensionslist[str]

List of dimensions to include

Returns:

DataFrame

A pandas DataFrame containing the selected dimensions

classmethod dtype(dataset, dimension)

Returns the dtype for the selected dimension.

Parameters:

datasetDataset

The dataset to query

dimensionstr or Dimension

Dimension to return the dtype for

Returns:

numpy.dtype

The dtype of the selected dimension

classmethod iloc(dataset, index)

Implements integer indexing on the rows and columns of the data.

Parameters:

datasetDataset

The dataset to apply the indexing operation on

indextuple or int

Index specification (row_index, col_index) or row_index

Returns:

data

Indexed data

Notes

Only implement for tabular interfaces.

classmethod isscalar(dataset, dim)

Whether the selected dimension is a scalar value.

Parameters:

datasetDataset

The dataset to query

dimstr or Dimension

Dimension to check for scalar value

Returns:

bool

Whether the dimension is scalar

classmethod loaded()

Indicates whether the required dependencies are loaded.

classmethod range(dataset, dimension)

Computes the minimum and maximum value along a dimension.

Parameters:

datasetDataset

The dataset to query

dimensionstr or Dimension

Dimension to compute the range on

Returns:

tuple[Any, Any]

Tuple of (min, max) values

Notes

In the past categorical and string columns were handled by sorting the values and taking the first and last value. This behavior is deprecated and will be removed in 2.0. In future the range for these columns will be returned as (None, None).

classmethod redim(dataset, dimensions)

Renames dimensions in the data.

Parameters:

datasetDataset

The dataset to transform

dimensionsdict[str, str]

Dictionary mapping from old to new dimension names

Returns:

data

Data after the dimension names have been transformed

Notes

Only meaningful for data formats that store dimension names.

classmethod reindex(dataset, kdims=None, vdims=None)

Reindexes data given new key and value dimensions.

classmethod unpack_scalar(dataset, data)

Given a dataset object and data in the appropriate format for the interface, return a simple scalar.

classmethod validate(dataset, vdims=True)

Validation runs after the Dataset has been constructed and should validate that the Dataset is correctly formed and contains all declared dimensions.

classmethod values(dataset, dim, expanded=True, flat=True, compute=True, keep_index=False)

Returns the values along a dimension of the dataset.

Parameters:

datasetDataset

The dataset to query

dimensionstr or Dimension

Dimension to return the values for

expandedbool, default True

When false returns unique values along the dimension

flatbool, default True

Whether to flatten the array

computebool, default True

Whether to load lazy data into memory as a NumPy array

keep_indexbool, default False

Whether to return the data with an index (if present)

Returns:

array_like

Dimension values in the requested format

Notes

The expanded keyword has different behavior for gridded interfaces where it determines whether 1D coordinates are expanded into a multi-dimensional array.