ScaledMatrix#

class pybrops.core.mat.ScaledMatrix.ScaledMatrix[source]#

Bases: Matrix

An abstract class for scaled matrix wrapper objects.

The purpose of this abstract class is to provide base functionality for:

Matrix in-place matrix scaling/unscaling routines.
Matrix scaling/unscaling routines

Methods

`adjoin`	Add additional elements to the end of the Matrix along an axis.
`concat`	Concatenate matrices together along an axis.
`copy`	Make a shallow copy of the Matrix.
`deepcopy`	Make a deep copy of the Matrix.
`delete`	Delete sub-arrays along an axis.
`from_hdf5`	Read an object from an HDF5 file.
`insert`	Insert values along the given axis before the given indices.
`rescale`	Transform matrix values within the ScaledMatrix to have centered and scaled values.
`select`	Select certain values from the matrix.
`to_hdf5`	Write an object to an HDF5 file.
`transform`	Transform a provided matrix using location and scale parameters within the ScaledMatrix.
`unscale`	Transform matrix values within the ScaledMatrix back to their unscaled and decentered values.
`untransform`	Untransform a provided matrix using location and scale parameters within the ScaledMatrix.

Attributes

`location`	Location of the matrix data.
`mat`	Pointer to raw matrix object.
`mat_ndim`	Number of dimensions of the raw matrix.
`mat_shape`	Shape of the raw matrix.
`scale`	Scale of the matrix data.

abstract __add__(value)#

Elementwise add matrices

Parameters:: value (object) – Object which to add.
Returns:: out – An object resulting from the addition.
Return type:: object

abstract __mul__(value)#

Elementwise multiply matrices

Parameters:: value (object) – Object which to multiply.
Returns:: out – An object resulting from the multiplication.
Return type:: object

abstract adjoin(values, axis, **kwargs)#

Add additional elements to the end of the Matrix along an axis.

Parameters:

values (Matrix or numpy.ndarray) – Values are appended to append to the Matrix.
axis (int) – The axis along which values are adjoined.
kwargs (dict) – Additional keyword arguments.

Returns:

out – A copy of mat with values appended to axis. Note that adjoin does not occur in-place: a new Matrix is allocated and filled.

Return type:

Matrix

abstract classmethod concat(mats, axis, **kwargs)#

Concatenate matrices together along an axis.

Parameters:

mats (Sequence of Matrix) – List of Matrix to concatenate. The matrices must have the same shape, except in the dimension corresponding to axis.
axis (int) – The axis along which the arrays will be joined.
kwargs (dict) – Additional keyword arguments

Returns:

out – The concatenated matrix. Note that concat does not occur in-place: a new Matrix is allocated and filled.

Return type:

Matrix

abstract copy()#

Make a shallow copy of the Matrix.

Returns:: out – A shallow copy of the original Matrix.
Return type:: Matrix

abstract deepcopy(memo)#

Make a deep copy of the Matrix.

Parameters:: memo (dict) – Dictionary of memo metadata.
Returns:: out – A deep copy of the original Matrix.
Return type:: Matrix

abstract delete(obj, axis, **kwargs)#

Delete sub-arrays along an axis.

Parameters:

obj (int, slice, or Sequence of ints) – Indicate indices of sub-arrays to remove along the specified axis.
axis (int) – The axis along which to delete the subarray defined by obj.
kwargs (dict) – Additional keyword arguments.

Returns:

out – A Matrix with deleted elements. Note that concat does not occur in-place: a new Matrix is allocated and filled.

Return type:

Matrix

abstract classmethod from_hdf5(filename, groupname)#

Read an object from an HDF5 file.

Parameters:

filename (str, Path, h5py.File) – If str, an HDF5 file name from which to read. If Path, an HDF5 file name from which to read. If h5py.File, an opened HDF5 file from which to read.
groupname (str, None) – If str, an HDF5 group name under which object data is stored. If None, object is read from base HDF5 group.

Returns:

out – An object read from an HDF5 file.

Return type:

HDF5InputOutput

abstract insert(obj, values, axis, **kwargs)#

Insert values along the given axis before the given indices.

Parameters:

obj (int, slice, or Sequence of ints) – Object that defines the index or indices before which values is inserted.
values (ArrayLike) – Values to insert into the matrix.
axis (int) – The axis along which values are inserted.
kwargs (dict) – Additional keyword arguments.

Returns:

out – A Matrix with values inserted. Note that insert does not occur in-place: a new Matrix is allocated and filled.

Return type:

Matrix

abstract property location: ndarray#: Location of the matrix data.

abstract property mat: object#: Pointer to raw matrix object.

abstract property mat_ndim: int#: Number of dimensions of the raw matrix.

abstract property mat_shape: tuple#: Shape of the raw matrix.

abstract rescale(inplace)[source]#

Transform matrix values within the ScaledMatrix to have centered and scaled values.

Parameters:: inplace (bool) – Whether to modify matrix values in-place.
Returns:: out – A matrix of centered and scaled values. If inplace == True, then a pointer to the raw matrix is returned.
Return type:: numpy.ndarray

abstract property scale: ndarray#: Scale of the matrix data.

abstract select(indices, axis, **kwargs)#

Select certain values from the matrix.

Parameters:

indices (ArrayLike (Nj, ...)) – The indices of the values to select.
axis (int) – The axis along which values are selected.
kwargs (dict) – Additional keyword arguments.

Returns:

out – The output matrix with values selected. Note that select does not occur in-place: a new Matrix is allocated and filled.

Return type:

Matrix

abstract to_hdf5(filename, groupname, overwrite)#

Write an object to an HDF5 file.

Parameters:

filename (str, Path, h5py.File) – If str, an HDF5 file name to which to write. If Path, an HDF5 file path to which to write. If h5py.File, an opened HDF5 file to which to write.
groupname (str, None) – If str, an HDF5 group name under which object data is stored. If None, object is written to the base HDF5 group.
overwrite (bool) – Whether to overwrite values in an HDF5 file if a field already exists.

Return type:

None

abstract transform(mat, copy)[source]#

Transform a provided matrix using location and scale parameters within the ScaledMatrix.

Parameters:

mat (numpy.ndarray) – An array to be centered and scaled.
copy (bool) – Whether to copy the input mat or not.

Returns:

out – A transformed array.

Return type:

numpy.ndarray

abstract unscale(inplace)[source]#

Transform matrix values within the ScaledMatrix back to their unscaled and decentered values.

Parameters:: inplace (bool) – Whether to modify matrix values in-place.
Returns:: out – A matrix of unscaled and decentered values. If inplace == True, then a pointer to the raw matrix is returned.
Return type:: numpy.ndarray

abstract untransform(mat, copy)[source]#

Untransform a provided matrix using location and scale parameters within the ScaledMatrix.

Parameters:

mat (numpy.ndarray) – An array to be unscaled and decentered.
copy (bool) – Whether to copy the input mat or not.

Returns:

out – A transformed array.

Return type:

numpy.ndarray