cfdm.RaggedContiguousArray


class cfdm.RaggedContiguousArray(compressed_array=None, shape=None, size=None, ndim=None, count_variable=None)[source]

Bases: cfdm.data.mixin.raggedcontiguous.RaggedContiguous, cfdm.data.abstract.compressedarray.CompressedArray

An underlying contiguous ragged array.

A collection of features stored using a contiguous ragged array combines all features along a single dimension (the “sample dimension”) such that each feature in the collection occupies a contiguous block.

The information needed to uncompress the data is stored in a “count variable” that gives the size of each block.

It is assumed that the compressed dimension is the left-most dimension in the compressed array.

New in version (cfdm): 1.7.0

Initialisation

Parameters
compressed_array: Data

The compressed data.

shape: tuple

The uncompressed array dimension sizes.

size: int

Number of elements in the uncompressed array.

ndim: int

The number of uncompressed array dimensions

count_variable: Count

The count variable required to uncompress the data, corresponding to a CF-netCDF count variable.

Inspection

Methods

get_compressed_axes

Return axes that are compressed in the underlying array.

get_compressed_dimension

Returns the compressed dimension’s position in the array.

get_compression_type

Returns the array’s compression type.

get_count

Return the count variable for a compressed array.

Attributes

array

Returns a numpy array containing the uncompressed data.

compressed_array

Returns an independent numpy array with the compressed data.

dtype

Data-type of the data elements.

ndim

The number of dimensions of the uncompressed data.

shape

Shape of the uncompressed data.

size

Number of elements in the uncompressed data.

Miscellaneous

Methods

copy

Return a deep copy of the array.

get_subspace

Return a subspace, defined by indices, of a numpy array.

source

Return the underlying array object.

to_memory

Bring an array on disk into memory and retain it there.

Special

Methods

__array__

The numpy array interface.

__deepcopy__

Called by the copy.deepcopy function.

__getitem__

Returns a subspace of the array defined by the given indices.

__repr__

Called by the repr built-in function.

__str__

Called by the str built-in function.

Docstring substitutions

Methods

_docstring_special_substitutions

Return the special docstring substitutions.

_docstring_substitutions

Returns the substitutions that apply to methods of the class.

_docstring_package_depth

Returns the class {{package}} substitutions package depth.

_docstring_method_exclusions

Returns method names excluded in the class substitutions.