Functionality for sparse matrices. More...

#include <cmr/env.h>
#include <stdio.h>

Classes
struct	CMR_SUBMAT
	Row and column indices for a submatrix. More...

struct	CMR_DBLMAT
	Row-wise representation of sparse double matrix. More...

struct	CMR_INTMAT
	Row-wise representation of sparse int matrix. More...

struct	CMR_CHRMAT
	Row-wise representation of sparse char matrix. More...

Functions
CMR_EXPORT CMR_ERROR	CMRsubmatCreate (CMR cmr, size_t numRows, size_t numColumns, CMR_SUBMAT *psubmatrix)
	Creates a submatrix of given size. More...

CMR_EXPORT CMR_ERROR	CMRsubmatCreate1x1 (CMR cmr, size_t row, size_t column, CMR_SUBMAT *psubmatrix)
	Creates a 1-by-1 submatrix. More...

CMR_EXPORT CMR_ERROR	CMRsubmatFree (CMR cmr, CMR_SUBMAT *psubmatrix)
	Frees a submatrix. More...

CMR_EXPORT CMR_ERROR	CMRsubmatTranspose (CMR_SUBMAT *submatrix)
	Transposes a submatrix. More...

CMR_EXPORT CMR_ERROR	CMRsubmatSlice (CMR cmr, CMR_SUBMAT base, CMR_SUBMAT input, CMR_SUBMAT *poutput)
	Returns the submatrix `input` as a submatrix of the `base` submatrix. More...

CMR_EXPORT CMR_ERROR	CMRsubmatUnslice (CMR cmr, CMR_SUBMAT base, CMR_SUBMAT input, CMR_SUBMAT *poutput)
	Returns the sub-submatrix `input` of `base` as a submatrix of its parent. More...

CMR_EXPORT CMR_ERROR	CMRsubmatPrint (CMR cmr, CMR_SUBMAT submatrix, size_t numRows, size_t numColumns, FILE *stream)
	Writes the submatrix `submatrix` to the file `stream` by means of lists of row and column indices. More...

CMR_EXPORT CMR_ERROR	CMRsubmatWriteToFile (CMR cmr, CMR_SUBMAT submatrix, size_t numRows, size_t numColumns, const char *fileName)
	Writes the submatrix `submatrix` to the file `fileName` by means of lists of row and column indices. More...

CMR_EXPORT CMR_ERROR	CMRsubmatReadFromStream (CMR cmr, CMR_SUBMAT psubmatrix, size_t pnumMatrixRows, size_t pnumMatrixColumns, FILE stream)
	Reads the submatrix `*psubmatrix` from the file `stream`. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCreate (CMR cmr, CMR_DBLMAT *presult, int numRows, int numColumns, int numNonzeros)
	Creates a double matrix of with `numRows` rows, `numColumns` columns and `numNonzeros` nonzeros. The actual arrays are allocated but not initialized. More...

CMR_EXPORT CMR_ERROR	CMRintmatCreate (CMR cmr, CMR_INTMAT *presult, int numRows, int numColumns, int numNonzeros)
	Creates an int matrix of with `numRows` rows, `numColumns` columns and `numNonzeros` nonzeros. The actual arrays are allocated but not initialized. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCreate (CMR cmr, CMR_CHRMAT *presult, int numRows, int numColumns, int numNonzeros)
	Creates a char matrix of with `numRows` rows, `numColumns` columns and `numNonzeros` nonzeros. The actual arrays are allocated but not initialized. More...

CMR_EXPORT CMR_ERROR	CMRdblmatFree (CMR cmr, CMR_DBLMAT *pmatrix)
	Frees the memory of a double matrix. More...

CMR_EXPORT CMR_ERROR	CMRintmatFree (CMR cmr, CMR_INTMAT *pmatrix)
	Frees the memory of an int matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatFree (CMR cmr, CMR_CHRMAT *pmatrix)
	Frees the memory of a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRdblmatChangeNumNonzeros (CMR cmr, CMR_DBLMAT matrix, size_t newNumNonzeros)
	Changes the number of nonzeros and reallocates corresponding arrays. More...

CMR_EXPORT CMR_ERROR	CMRintmatChangeNumNonzeros (CMR cmr, CMR_INTMAT matrix, size_t newNumNonzeros)
	Changes the number of nonzeros and reallocates corresponding arrays. More...

CMR_EXPORT CMR_ERROR	CMRchrmatChangeNumNonzeros (CMR cmr, CMR_CHRMAT matrix, size_t newNumNonzeros)
	Changes the number of nonzeros and reallocates corresponding arrays. More...

CMR_EXPORT CMR_ERROR	CMRdblmatSortNonzeros (CMR cmr, CMR_DBLMAT matrix)
	Sorts the nonzeros of a double matrix by column in ascending order. More...

CMR_EXPORT CMR_ERROR	CMRintmatSortNonzeros (CMR cmr, CMR_INTMAT matrix)
	Sorts the nonzeros of an int matrix by column in ascending order. More...

CMR_EXPORT CMR_ERROR	CMRchrmatSortNonzeros (CMR cmr, CMR_CHRMAT matrix)
	Sorts the nonzeros of a char matrix by column in ascending order. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCopy (CMR cmr, CMR_DBLMAT matrix, CMR_DBLMAT **presult)
	Copies a double matrix to a newly allocated one. More...

CMR_EXPORT CMR_ERROR	CMRintmatCopy (CMR cmr, CMR_INTMAT matrix, CMR_INTMAT **presult)
	Copies an int matrix to a newly allocated one. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCopy (CMR cmr, CMR_CHRMAT matrix, CMR_CHRMAT **presult)
	Copies a char matrix to a newly allocated one. More...

CMR_EXPORT CMR_ERROR	CMRdblmatTranspose (CMR cmr, CMR_DBLMAT matrix, CMR_DBLMAT **presult)
	Creates the transpose of a double matrix. More...

CMR_EXPORT CMR_ERROR	CMRintmatTranspose (CMR cmr, CMR_INTMAT matrix, CMR_INTMAT **presult)
	Creates the transpose of an int matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatTranspose (CMR cmr, CMR_CHRMAT matrix, CMR_CHRMAT **presult)
	Creates the transpose of a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRdblmatPermute (CMR cmr, CMR_DBLMAT matrix, size_t rows, size_t columns, CMR_DBLMAT **presult)
	Creates the double matrix obtained from `matrix` by applying row- and column-permutations. More...

CMR_EXPORT CMR_ERROR	CMRintmatPermute (CMR cmr, CMR_INTMAT matrix, size_t rows, size_t columns, CMR_INTMAT **presult)
	Creates the int matrix obtained from `matrix` by applying row- and column-permutations. More...

CMR_EXPORT CMR_ERROR	CMRchrmatPermute (CMR cmr, CMR_CHRMAT matrix, size_t rows, size_t columns, CMR_CHRMAT **presult)
	Creates the char matrix obtained from `matrix` by applying row- and column-permutations. More...

CMR_EXPORT CMR_ERROR	CMRdblmatPrintSparse (CMR cmr, CMR_DBLMAT matrix, FILE *stream)
	Prints a double matrix in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRintmatPrintSparse (CMR cmr, CMR_INTMAT matrix, FILE *stream)
	Prints an int matrix in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRchrmatPrintSparse (CMR cmr, CMR_CHRMAT matrix, FILE *stream)
	Prints a char matrix in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRdblmatPrintDense (CMR cmr, CMR_DBLMAT matrix, FILE *stream, char zeroChar, bool header)
	Prints a double matrix in dense format. More...

CMR_EXPORT CMR_ERROR	CMRintmatPrintDense (CMR cmr, CMR_INTMAT matrix, FILE *stream, char zeroChar, bool header)
	Prints an int matrix in dense format. More...

CMR_EXPORT CMR_ERROR	CMRchrmatPrintDense (CMR cmr, CMR_CHRMAT matrix, FILE *stream, char zeroChar, bool header)
	Prints a char matrix in dense format. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCreateFromSparseStream (CMR cmr, FILE stream, CMR_DBLMAT **presult)
	Reads a double matrix from a file `stream` in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRintmatCreateFromSparseStream (CMR cmr, FILE stream, CMR_INTMAT **presult)
	Reads an int matrix from a file `stream` in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCreateFromSparseStream (CMR cmr, FILE stream, CMR_CHRMAT **presult)
	Reads a char matrix from a file `stream` in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCreateFromSparseFile (CMR cmr, const char fileName, const char stdinName, CMR_DBLMAT *presult)
	Reads a double matrix from a file name `fileName` in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRintmatCreateFromSparseFile (CMR cmr, const char fileName, const char stdinName, CMR_INTMAT *presult)
	Reads an int matrix from a file name `fileName` in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCreateFromSparseFile (CMR cmr, const char fileName, const char stdinName, CMR_CHRMAT *presult)
	Reads a char matrix from a file name `fileName` in sparse format. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCreateFromDenseStream (CMR cmr, FILE stream, CMR_DBLMAT **presult)
	Reads a double matrix from a file `stream` in dense format. More...

CMR_EXPORT CMR_ERROR	CMRintmatCreateFromDenseStream (CMR cmr, FILE stream, CMR_INTMAT **presult)
	Reads an int matrix from a file `stream` in dense format. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCreateFromDenseStream (CMR cmr, FILE stream, CMR_CHRMAT **presult)
	Reads a char matrix from a file `stream` in dense format. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCreateFromDenseFile (CMR cmr, const char fileName, const char stdinName, CMR_DBLMAT *presult)
	Reads a double matrix from a file name `fileName` in dense format. More...

CMR_EXPORT CMR_ERROR	CMRintmatCreateFromDenseFile (CMR cmr, const char fileName, const char stdinName, CMR_INTMAT *presult)
	Reads an int matrix from a file name `fileName` in dense format. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCreateFromDenseFile (CMR cmr, const char fileName, const char stdinName, CMR_CHRMAT *presult)
	Reads a char matrix from a file name `fileName` in dense format. More...

CMR_EXPORT bool	CMRdblmatCheckEqual (CMR_DBLMAT matrix1, CMR_DBLMAT matrix2)
	Checks whether two double matrices are equal. More...

CMR_EXPORT bool	CMRintmatCheckEqual (CMR_INTMAT matrix1, CMR_INTMAT matrix2)
	Checks whether two int matrices are equal. More...

CMR_EXPORT bool	CMRchrmatCheckEqual (CMR_CHRMAT matrix1, CMR_CHRMAT matrix2)
	Checks whether two char matrices are equal. More...

CMR_EXPORT CMR_ERROR	CMRdblmatCheckTranspose (CMR cmr, CMR_DBLMAT matrix1, CMR_DBLMAT matrix2, bool pareTranspose)
	Checks whether two double matrices are transposes of each other. More...

CMR_EXPORT CMR_ERROR	CMRintmatCheckTranspose (CMR cmr, CMR_INTMAT matrix1, CMR_INTMAT matrix2, bool pareTranspose)
	Checks whether two int matrices are transposes of each other. More...

CMR_EXPORT CMR_ERROR	CMRchrmatCheckTranspose (CMR cmr, CMR_CHRMAT matrix1, CMR_CHRMAT matrix2, bool pareTranspose)
	Checks whether two char matrices are transposes of each other. More...

CMR_EXPORT char *	CMRdblmatConsistency (CMR_DBLMAT *matrix)
	Checks a double matrix for consistency. More...

CMR_EXPORT char *	CMRintmatConsistency (CMR_INTMAT *matrix)
	Checks an int matrix for consistency. More...

CMR_EXPORT char *	CMRchrmatConsistency (CMR_CHRMAT *matrix)
	Checks a char matrix for consistency. More...

CMR_EXPORT CMR_ERROR	CMRdblmatSlice (CMR cmr, CMR_DBLMAT matrix, CMR_SUBMAT submatrix, CMR_DBLMAT *presult)
	Slices a `submatrix` of a double matrix. More...

CMR_EXPORT CMR_ERROR	CMRintmatSlice (CMR cmr, CMR_INTMAT matrix, CMR_SUBMAT submatrix, CMR_INTMAT *presult)
	Slices a `submatrix` of an int matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatSlice (CMR cmr, CMR_CHRMAT matrix, CMR_SUBMAT submatrix, CMR_CHRMAT *presult)
	Slices a `submatrix` of a char matrix. More...

CMR_EXPORT bool	CMRdblmatIsBinary (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_SUBMAT **psubmatrix)
	Checks if a double matrix has only entries in \( \{0,1\} \) with absolute error tolerance `epsilon`. More...

CMR_EXPORT CMR_ERROR	CMRdblmatFindBinarySubmatrix (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_SUBMAT **psubmatrix)
	Finds a large binary submatrix with absolute error tolerance `epsilon`. More...

CMR_EXPORT bool	CMRintmatIsBinary (CMR cmr, CMR_INTMAT matrix, CMR_SUBMAT **psubmatrix)
	Checks if an int matrix has only entries in \( \{0,1\} \). More...

CMR_EXPORT bool	CMRchrmatIsBinary (CMR cmr, CMR_CHRMAT matrix, CMR_SUBMAT **psubmatrix)
	Checks if a char matrix has only entries in \( \{0,1\} \). More...

CMR_EXPORT bool	CMRdblmatIsTernary (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_SUBMAT **psubmatrix)
	Checks if a double matrix has only entries in \( \{-1,0,+1\} \) with absolute error tolerance `epsilon`. More...

CMR_EXPORT CMR_ERROR	CMRdblmatFindTernarySubmatrix (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_SUBMAT **psubmatrix)
	Finds a large ternary submatrix with absolute error tolerance `epsilon`. More...

CMR_EXPORT bool	CMRintmatIsTernary (CMR cmr, CMR_INTMAT matrix, CMR_SUBMAT **psubmatrix)
	Checks if an int matrix has only entries in \( \{-1,0,+1\} \). More...

CMR_EXPORT bool	CMRchrmatIsTernary (CMR cmr, CMR_CHRMAT matrix, CMR_SUBMAT **psubmatrix)
	Checks if a double matrix has only entries in \( \{-1,0,+1\} \). More...

CMR_EXPORT CMR_ERROR	CMRdblmatSupport (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_CHRMAT **presult)
	Creates the (binary) support matrix of a double matrix as a char matrix with absolute error tolerance `epsilon`. More...

CMR_EXPORT CMR_ERROR	CMRintmatSupport (CMR cmr, CMR_INTMAT matrix, CMR_CHRMAT **presult)
	Creates the (binary) support matrix of an int matrix as a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatSupport (CMR cmr, CMR_CHRMAT matrix, CMR_CHRMAT **presult)
	Creates the (binary) support matrix of a char matrix as a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRdblmatSignedSupport (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_CHRMAT **presult)
	Creates the (ternary) signed support matrix of a double matrix as a char matrix with absolute error tolerance `epsilon`. More...

CMR_EXPORT CMR_ERROR	CMRintmatSignedSupport (CMR cmr, CMR_INTMAT matrix, CMR_CHRMAT **presult)
	Creates the (ternary) signed support matrix of an int matrix as a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatSignedSupport (CMR cmr, CMR_CHRMAT matrix, CMR_CHRMAT **presult)
	Creates the (ternary) signed support matrix of a char matrix as a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatToInt (CMR cmr, CMR_CHRMAT matrix, CMR_INTMAT **presult)
	Converts a char matrix to an int matrix. More...

CMR_EXPORT CMR_ERROR	CMRintmatToChr (CMR cmr, CMR_INTMAT matrix, CMR_CHRMAT **presult)
	Converts an int matrix to a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRdblmatToChr (CMR cmr, CMR_DBLMAT matrix, double epsilon, CMR_CHRMAT **presult)
	Converts a double matrix to a char matrix. More...

CMR_EXPORT CMR_ERROR	CMRdblmatFindEntry (CMR_DBLMAT matrix, size_t row, size_t column, size_t pentry)
	Finds a specific entry of a double matrix. More...

CMR_EXPORT CMR_ERROR	CMRintmatFindEntry (CMR_INTMAT matrix, size_t row, size_t column, size_t pentry)
	Finds a specific entry of an int matrix. More...

CMR_EXPORT CMR_ERROR	CMRchrmatFindEntry (CMR_CHRMAT matrix, size_t row, size_t column, size_t pentry)
	Finds a specific entry of a char matrix. More...

Detailed Description

Functionality for sparse matrices.

Author: Matthias Walter

Function Documentation

◆ CMRchrmatChangeNumNonzeros()

CMR_EXPORT CMR_ERROR CMRchrmatChangeNumNonzeros	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		size_t	newNumNonzeros
	)

Changes the number of nonzeros and reallocates corresponding arrays.

Parameters

cmr	CMR environment.
matrix	A matrix.
newNumNonzeros	New number of nonzeros.

◆ CMRchrmatCheckEqual()

CMR_EXPORT bool CMRchrmatCheckEqual	(	CMR_CHRMAT *	matrix1,
		CMR_CHRMAT *	matrix2
	)

Checks whether two char matrices are equal.

Parameters

matrix1	First matrix.
matrix2	Second matrix.

◆ CMRchrmatCheckTranspose()

CMR_EXPORT CMR_ERROR CMRchrmatCheckTranspose	(	CMR *	cmr,
		CMR_CHRMAT *	matrix1,
		CMR_CHRMAT *	matrix2,
		bool *	pareTranspose
	)

Checks whether two char matrices are transposes of each other.

Parameters

cmr	CMR environment.
matrix1	First matrix
matrix2	Second matrix
pareTranspose	Pointer for storing whether `matrix1` and `matrix2` are tranposes of each other.

◆ CMRchrmatConsistency()

CMR_EXPORT char* CMRchrmatConsistency ( CMR_CHRMAT * matrix )

Checks a char matrix for consistency.

Checks whether the entries of a row are sorted by column in ascending order. Checks for duplicate entries. Checks for zero entries.

Returns: NULL if consistent. Otherwise, an explanation string is returned, which must free'd with free().

See also: CMRdbgConsistencyAssert() for checking the returned string and aborting in case of inconsistency.

Parameters

matrix A matrix.

◆ CMRchrmatCopy()

CMR_EXPORT CMR_ERROR CMRchrmatCopy	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Copies a char matrix to a newly allocated one.

Parameters

cmr	CMR environment.
matrix	A matrix.
presult	Pointer for storing a copy of `matrix`.

◆ CMRchrmatCreate()

CMR_EXPORT CMR_ERROR CMRchrmatCreate	(	CMR *	cmr,
		CMR_CHRMAT **	presult,
		int	numRows,
		int	numColumns,
		int	numNonzeros
	)

Creates a char matrix of with numRows rows, numColumns columns and numNonzeros nonzeros. The actual arrays are allocated but not initialized.

Parameters

cmr	CMR environment.
presult	Pointer for storing the created matrix.
numRows	Number of rows.
numColumns	Number of columns.
numNonzeros	Number of nonzeros.

◆ CMRchrmatCreateFromDenseFile()

CMR_EXPORT CMR_ERROR CMRchrmatCreateFromDenseFile	(	CMR *	cmr,
		const char *	fileName,
		const char *	stdinName,
		CMR_CHRMAT **	presult
	)

Reads a char matrix from a file name fileName in dense format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL. Expects that the file contains only the matrix and no additional data.

Parameters

cmr	CMR environment.
fileName	File stream to read from.
stdinName	If not `NULL`, indicates which file name represents stdin.
presult	Pointer for storing the matrix.

◆ CMRchrmatCreateFromDenseStream()

CMR_EXPORT CMR_ERROR CMRchrmatCreateFromDenseStream	(	CMR *	cmr,
		FILE *	stream,
		CMR_CHRMAT **	presult
	)

Reads a char matrix from a file stream in dense format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL.

Parameters

cmr	CMR environment.
stream	File stream to read from.
presult	Pointer for storing the matrix.

◆ CMRchrmatCreateFromSparseFile()

CMR_EXPORT CMR_ERROR CMRchrmatCreateFromSparseFile	(	CMR *	cmr,
		const char *	fileName,
		const char *	stdinName,
		CMR_CHRMAT **	presult
	)

Reads a char matrix from a file name fileName in sparse format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL. Expects that the file contains only the matrix and no additional data.

Parameters

cmr	CMR environment.
fileName	File stream to read from.
stdinName	If not `NULL`, indicates which file name represents stdin.
presult	Pointer for storing the matrix.

◆ CMRchrmatCreateFromSparseStream()

CMR_EXPORT CMR_ERROR CMRchrmatCreateFromSparseStream	(	CMR *	cmr,
		FILE *	stream,
		CMR_CHRMAT **	presult
	)

Reads a char matrix from a file stream in sparse format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL.

Parameters

cmr	CMR environment.
stream	File stream to read from.
presult	Pointer for storing the matrix.

◆ CMRchrmatFindEntry()

CMR_EXPORT CMR_ERROR CMRchrmatFindEntry	(	CMR_CHRMAT *	matrix,
		size_t	row,
		size_t	column,
		size_t *	pentry
	)

Finds a specific entry of a char matrix.

Searches for the entry at (row, column) using binary search. If an entry is zero, then *pentry is set to SIZE_MAX.

Parameters

matrix	Input matrix.
row	A row.
column	A column.
pentry	Pointer for storing the entry at `row`, `column`, or `SIZE_MAX` if it is zero.

◆ CMRchrmatFree()

CMR_EXPORT CMR_ERROR CMRchrmatFree	(	CMR *	cmr,
		CMR_CHRMAT **	pmatrix
	)

Frees the memory of a char matrix.

Parameters

cmr	CMR environment.
pmatrix	Pointer to matrix.

◆ CMRchrmatIsBinary()

CMR_EXPORT bool CMRchrmatIsBinary	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_SUBMAT **	psubmatrix
	)

Checks if a char matrix has only entries in \( \{0,1\} \).

Parameters

cmr	CMR environment.
matrix	A matrix.
psubmatrix	Pointer for storing a non-binary entry as a submatrix (may be `NULL`).

◆ CMRchrmatIsTernary()

CMR_EXPORT bool CMRchrmatIsTernary	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_SUBMAT **	psubmatrix
	)

Checks if a double matrix has only entries in \( \{-1,0,+1\} \).

Parameters

cmr	CMR environment.
matrix	A matrix.
psubmatrix	Pointer for storing a non-ternary entry as a submatrix (may be `NULL`).

◆ CMRchrmatPermute()

CMR_EXPORT CMR_ERROR CMRchrmatPermute	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		size_t *	rows,
		size_t *	columns,
		CMR_CHRMAT **	presult
	)

Creates the char matrix obtained from matrix by applying row- and column-permutations.

Parameters

cmr	CMR environment.
matrix	Given matrix.
rows	Mapping from new rows to rows of `matrix` (may be `NULL` for identity).
columns	Mapping from new columns to columns of `matrix` (may be `NULL` for identity).
presult	Pointer for storing the permuted matrix.

◆ CMRchrmatPrintDense()

CMR_EXPORT CMR_ERROR CMRchrmatPrintDense	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		FILE *	stream,
		char	zeroChar,
		bool	header
	)

Prints a char matrix in dense format.

Parameters

cmr	CMR environment.
matrix	A matrix.
stream	File stream to print to.
zeroChar	Character to print for a zero.
header	Whether to print row and column indices.

◆ CMRchrmatPrintSparse()

CMR_EXPORT CMR_ERROR CMRchrmatPrintSparse	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		FILE *	stream
	)

Prints a char matrix in sparse format.

Parameters

cmr	CMR environment.
matrix	A matrix.
stream	File stream to print to.

◆ CMRchrmatSignedSupport()

CMR_EXPORT CMR_ERROR CMRchrmatSignedSupport	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Creates the (ternary) signed support matrix of a char matrix as a char matrix.

Parameters

cmr	CMR environment.
matrix	Double matrix
presult	Pointer for storing the signed support matrix of `matrix`.

◆ CMRchrmatSlice()

CMR_EXPORT CMR_ERROR CMRchrmatSlice	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_SUBMAT *	submatrix,
		CMR_CHRMAT **	presult
	)

Slices a submatrix of a char matrix.

Parameters

cmr	CMR environment.
matrix	A matrix
submatrix	A submatrix of `matrix`.
presult	Pointer for storing the resulting double matrix.

◆ CMRchrmatSortNonzeros()

CMR_EXPORT CMR_ERROR CMRchrmatSortNonzeros	(	CMR *	cmr,
		CMR_CHRMAT *	matrix
	)

Sorts the nonzeros of a char matrix by column in ascending order.

Parameters

cmr	CMR environment.
matrix	A matrix.

◆ CMRchrmatSupport()

CMR_EXPORT CMR_ERROR CMRchrmatSupport	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Creates the (binary) support matrix of a char matrix as a char matrix.

Parameters

cmr	CMR environment.
matrix	Double matrix
presult	Pointer for storing the support matrix of `matrix`.

◆ CMRchrmatToInt()

CMR_EXPORT CMR_ERROR CMRchrmatToInt	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_INTMAT **	presult
	)

Converts a char matrix to an int matrix.

Parameters

cmr	CMR environment.
matrix	Input matrix.
presult	Pointer for storing the output matrix.

◆ CMRchrmatTranspose()

CMR_EXPORT CMR_ERROR CMRchrmatTranspose	(	CMR *	cmr,
		CMR_CHRMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Creates the transpose of a char matrix.

Parameters

cmr	CMR environment.
matrix	Given matrix.
presult	Pointer for storing the transpose of `matrix`.

◆ CMRdblmatChangeNumNonzeros()

CMR_EXPORT CMR_ERROR CMRdblmatChangeNumNonzeros	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		size_t	newNumNonzeros
	)

Changes the number of nonzeros and reallocates corresponding arrays.

Parameters

cmr	CMR environment.
matrix	Given matrix.
newNumNonzeros	New number of nonzeros.

◆ CMRdblmatCheckEqual()

CMR_EXPORT bool CMRdblmatCheckEqual	(	CMR_DBLMAT *	matrix1,
		CMR_DBLMAT *	matrix2
	)

Checks whether two double matrices are equal.

Parameters

matrix1	First matrix.
matrix2	Second matrix.

◆ CMRdblmatCheckTranspose()

CMR_EXPORT CMR_ERROR CMRdblmatCheckTranspose	(	CMR *	cmr,
		CMR_DBLMAT *	matrix1,
		CMR_DBLMAT *	matrix2,
		bool *	pareTranspose
	)

Checks whether two double matrices are transposes of each other.

Parameters

cmr	CMR environment.
matrix1	First matrix.
matrix2	Second matrix.
pareTranspose	Pointer for storing whether `matrix1` and `matrix2` are tranposes of each other.

◆ CMRdblmatConsistency()

CMR_EXPORT char* CMRdblmatConsistency ( CMR_DBLMAT * matrix )

Checks a double matrix for consistency.

Checks whether the entries of a row are sorted by column in ascending order. Checks for duplicate entries. Checks for zero entries.

Returns: NULL if consistent. Otherwise, an explanation string is returned, which must free'd with free().

See also: CMRdbgConsistencyAssert() for checking the returned string and aborting in case of inconsistency.

Parameters

matrix A matrix.

◆ CMRdblmatCopy()

CMR_EXPORT CMR_ERROR CMRdblmatCopy	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		CMR_DBLMAT **	presult
	)

Copies a double matrix to a newly allocated one.

Parameters

cmr	CMR environment.
matrix	A matrix.
presult	Pointer for storing a copy of `matrix`.

◆ CMRdblmatCreate()

CMR_EXPORT CMR_ERROR CMRdblmatCreate	(	CMR *	cmr,
		CMR_DBLMAT **	presult,
		int	numRows,
		int	numColumns,
		int	numNonzeros
	)

Creates a double matrix of with numRows rows, numColumns columns and numNonzeros nonzeros. The actual arrays are allocated but not initialized.

Parameters

cmr	CMR environment.
presult	Pointer for storing the created matrix.
numRows	Number of rows.
numColumns	Number of columns.
numNonzeros	Number of nonzeros.

◆ CMRdblmatCreateFromDenseFile()

CMR_EXPORT CMR_ERROR CMRdblmatCreateFromDenseFile	(	CMR *	cmr,
		const char *	fileName,
		const char *	stdinName,
		CMR_DBLMAT **	presult
	)

Reads a double matrix from a file name fileName in dense format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL. Expects that the file contains only the matrix and no additional data.

Parameters

cmr	CMR environment.
fileName	File stream to read from.
stdinName	If not `NULL`, indicates which file name represents stdin.
presult	Pointer for storing the matrix.

◆ CMRdblmatCreateFromDenseStream()

CMR_EXPORT CMR_ERROR CMRdblmatCreateFromDenseStream	(	CMR *	cmr,
		FILE *	stream,
		CMR_DBLMAT **	presult
	)

Reads a double matrix from a file stream in dense format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL.

Parameters

cmr	CMR environment.
stream	File stream to read from.
presult	Pointer for storing the matrix.

◆ CMRdblmatCreateFromSparseFile()

CMR_EXPORT CMR_ERROR CMRdblmatCreateFromSparseFile	(	CMR *	cmr,
		const char *	fileName,
		const char *	stdinName,
		CMR_DBLMAT **	presult
	)

Reads a double matrix from a file name fileName in sparse format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL. Expects that the file contains only the matrix and no additional data.

Parameters

cmr	CMR environment.
fileName	File stream to read from.
stdinName	If not `NULL`, indicates which file name represents stdin.
presult	Pointer for storing the matrix.

◆ CMRdblmatCreateFromSparseStream()

CMR_EXPORT CMR_ERROR CMRdblmatCreateFromSparseStream	(	CMR *	cmr,
		FILE *	stream,
		CMR_DBLMAT **	presult
	)

Reads a double matrix from a file stream in sparse format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL.

Parameters

cmr	CMR environment.
stream	File stream to read from.
presult	Pointer for storing the matrix.

◆ CMRdblmatFindBinarySubmatrix()

CMR_EXPORT CMR_ERROR CMRdblmatFindBinarySubmatrix	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_SUBMAT **	psubmatrix
	)

Finds a large binary submatrix with absolute error tolerance epsilon.

Parameters

cmr	CMR environment.
matrix	A matrix.
epsilon	Absolute error tolerance.
psubmatrix	Pointer for storing a large binary submatrix.

◆ CMRdblmatFindEntry()

CMR_EXPORT CMR_ERROR CMRdblmatFindEntry	(	CMR_DBLMAT *	matrix,
		size_t	row,
		size_t	column,
		size_t *	pentry
	)

Finds a specific entry of a double matrix.

Searches for the entry at (row, column) using binary search.

Parameters

matrix	Input matrix.
row	A row.
column	A column.
pentry	Pointer for storing the entry at `row`, `column`, or `SIZE_MAX` if it is zero.

◆ CMRdblmatFindTernarySubmatrix()

CMR_EXPORT CMR_ERROR CMRdblmatFindTernarySubmatrix	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_SUBMAT **	psubmatrix
	)

Finds a large ternary submatrix with absolute error tolerance epsilon.

Parameters

cmr	CMR environment.
matrix	A matrix.
epsilon	Absolute error tolerance.
psubmatrix	Pointer for storing a large binary submatrix.

◆ CMRdblmatFree()

CMR_EXPORT CMR_ERROR CMRdblmatFree	(	CMR *	cmr,
		CMR_DBLMAT **	pmatrix
	)

Frees the memory of a double matrix.

Parameters

cmr	CMR environment.
pmatrix	Pointer to matrix.

◆ CMRdblmatIsBinary()

CMR_EXPORT bool CMRdblmatIsBinary	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_SUBMAT **	psubmatrix
	)

Checks if a double matrix has only entries in \( \{0,1\} \) with absolute error tolerance epsilon.

Parameters

cmr	CMR environment.
matrix	A matrix.
epsilon	Absolute error tolerance.
psubmatrix	Pointer for storing a non-binary entry as a submatrix (may be `NULL`).

◆ CMRdblmatIsTernary()

CMR_EXPORT bool CMRdblmatIsTernary	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_SUBMAT **	psubmatrix
	)

Checks if a double matrix has only entries in \( \{-1,0,+1\} \) with absolute error tolerance epsilon.

Parameters

cmr	CMR environment.
matrix	A matrix.
epsilon	Absolute error tolerance.
psubmatrix	Pointer for storing a non-ternary entry as a submatrix (may be `NULL`).

◆ CMRdblmatPermute()

CMR_EXPORT CMR_ERROR CMRdblmatPermute	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		size_t *	rows,
		size_t *	columns,
		CMR_DBLMAT **	presult
	)

Creates the double matrix obtained from matrix by applying row- and column-permutations.

Parameters

cmr	CMR environment.
matrix	Given matrix.
rows	Mapping from new rows to rows of `matrix` (may be `NULL` for identity).
columns	Mapping from new columns to columns of `matrix` (may be `NULL` for identity).
presult	Pointer for storing the permuted matrix.

◆ CMRdblmatPrintDense()

CMR_EXPORT CMR_ERROR CMRdblmatPrintDense	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		FILE *	stream,
		char	zeroChar,
		bool	header
	)

Prints a double matrix in dense format.

Parameters

cmr	CMR environment.
matrix	A matrix.
stream	File stream to print to.
zeroChar	Character to print for a zero.
header	Whether to print row and column indices.

◆ CMRdblmatPrintSparse()

CMR_EXPORT CMR_ERROR CMRdblmatPrintSparse	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		FILE *	stream
	)

Prints a double matrix in sparse format.

Parameters

cmr	CMR environment.
matrix	A matrix.
stream	File stream to print to.

◆ CMRdblmatSignedSupport()

CMR_EXPORT CMR_ERROR CMRdblmatSignedSupport	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_CHRMAT **	presult
	)

Creates the (ternary) signed support matrix of a double matrix as a char matrix with absolute error tolerance epsilon.

Parameters

cmr	CMR environment.
matrix	Double matrix
epsilon	Absolute error tolerance.
presult	Pointer for storing the support matrix of `matrix`.

◆ CMRdblmatSlice()

CMR_EXPORT CMR_ERROR CMRdblmatSlice	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		CMR_SUBMAT *	submatrix,
		CMR_DBLMAT **	presult
	)

Slices a submatrix of a double matrix.

Parameters

cmr	CMR environment.
matrix	A matrix
submatrix	A submatrix of `matrix`.
presult	Pointer for storing the resulting matrix.

◆ CMRdblmatSortNonzeros()

CMR_EXPORT CMR_ERROR CMRdblmatSortNonzeros	(	CMR *	cmr,
		CMR_DBLMAT *	matrix
	)

Sorts the nonzeros of a double matrix by column in ascending order.

Parameters

cmr	CMR environment.
matrix	A matrix.

◆ CMRdblmatSupport()

CMR_EXPORT CMR_ERROR CMRdblmatSupport	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_CHRMAT **	presult
	)

Creates the (binary) support matrix of a double matrix as a char matrix with absolute error tolerance epsilon.

Parameters

cmr	CMR environment.
matrix	Double matrix
epsilon	Absolute error tolerance.
presult	Pointer for storing the support matrix of `matrix`.

◆ CMRdblmatToChr()

CMR_EXPORT CMR_ERROR CMRdblmatToChr	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		double	epsilon,
		CMR_CHRMAT **	presult
	)

Converts a double matrix to a char matrix.

Returns: CMR_ERROR_OVERFLOW in case of overflow.

Parameters

cmr	CMR environment.
matrix	Input matrix.
epsilon	Expected accuracy.
presult	Pointer for storing the output matrix.

◆ CMRdblmatTranspose()

CMR_EXPORT CMR_ERROR CMRdblmatTranspose	(	CMR *	cmr,
		CMR_DBLMAT *	matrix,
		CMR_DBLMAT **	presult
	)

Creates the transpose of a double matrix.

Parameters

cmr	CMR environment.
matrix	A matrix.
presult	Pointer for storing the transpose of `matrix`.

◆ CMRintmatChangeNumNonzeros()

CMR_EXPORT CMR_ERROR CMRintmatChangeNumNonzeros	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		size_t	newNumNonzeros
	)

Changes the number of nonzeros and reallocates corresponding arrays.

Parameters

cmr	CMR environment.
matrix	A matrix.
newNumNonzeros	New number of nonzeros.

◆ CMRintmatCheckEqual()

CMR_EXPORT bool CMRintmatCheckEqual	(	CMR_INTMAT *	matrix1,
		CMR_INTMAT *	matrix2
	)

Checks whether two int matrices are equal.

Parameters

matrix1	First matrix.
matrix2	Second matrix.

◆ CMRintmatCheckTranspose()

CMR_EXPORT CMR_ERROR CMRintmatCheckTranspose	(	CMR *	cmr,
		CMR_INTMAT *	matrix1,
		CMR_INTMAT *	matrix2,
		bool *	pareTranspose
	)

Checks whether two int matrices are transposes of each other.

Parameters

cmr	CMR environment.
matrix1	First matrix
matrix2	Second matrix
pareTranspose	Pointer for storing whether `matrix1` and `matrix2` are tranposes of each other.

◆ CMRintmatConsistency()

CMR_EXPORT char* CMRintmatConsistency ( CMR_INTMAT * matrix )

Checks an int matrix for consistency.

Checks whether the entries of a row are sorted by column in ascending order. Checks for duplicate entries. Checks for zero entries.

Returns: NULL if consistent. Otherwise, an explanation string is returned, which must free'd with free().

See also: CMRdbgConsistencyAssert() for checking the returned string and aborting in case of inconsistency.

Parameters

matrix A matrix.

◆ CMRintmatCopy()

CMR_EXPORT CMR_ERROR CMRintmatCopy	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_INTMAT **	presult
	)

Copies an int matrix to a newly allocated one.

Parameters

cmr	CMR environment.
matrix	A matrix.
presult	Pointer for storing a copy of `matrix`.

◆ CMRintmatCreate()

CMR_EXPORT CMR_ERROR CMRintmatCreate	(	CMR *	cmr,
		CMR_INTMAT **	presult,
		int	numRows,
		int	numColumns,
		int	numNonzeros
	)

Creates an int matrix of with numRows rows, numColumns columns and numNonzeros nonzeros. The actual arrays are allocated but not initialized.

Parameters

cmr	CMR environment.
presult	Pointer for storing the created matrix.
numRows	Number of rows.
numColumns	Number of columns.
numNonzeros	Number of nonzeros.

◆ CMRintmatCreateFromDenseFile()

CMR_EXPORT CMR_ERROR CMRintmatCreateFromDenseFile	(	CMR *	cmr,
		const char *	fileName,
		const char *	stdinName,
		CMR_INTMAT **	presult
	)

Reads an int matrix from a file name fileName in dense format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL. Expects that the file contains only the matrix and no additional data.

Parameters

cmr	CMR environment.
fileName	File stream to read from.
stdinName	If not `NULL`, indicates which file name represents stdin.
presult	Pointer for storing the matrix.

◆ CMRintmatCreateFromDenseStream()

CMR_EXPORT CMR_ERROR CMRintmatCreateFromDenseStream	(	CMR *	cmr,
		FILE *	stream,
		CMR_INTMAT **	presult
	)

Reads an int matrix from a file stream in dense format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL.

Parameters

cmr	CMR environment.
stream	File stream to read from.
presult	Pointer for storing the matrix.

◆ CMRintmatCreateFromSparseFile()

CMR_EXPORT CMR_ERROR CMRintmatCreateFromSparseFile	(	CMR *	cmr,
		const char *	fileName,
		const char *	stdinName,
		CMR_INTMAT **	presult
	)

Reads an int matrix from a file name fileName in sparse format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL. Expects that the file contains only the matrix and no additional data.

Parameters

cmr	CMR environment.
fileName	File stream to read from.
stdinName	If not `NULL`, indicates which file name represents stdin.
presult	Pointer for storing the matrix.

◆ CMRintmatCreateFromSparseStream()

CMR_EXPORT CMR_ERROR CMRintmatCreateFromSparseStream	(	CMR *	cmr,
		FILE *	stream,
		CMR_INTMAT **	presult
	)

Reads an int matrix from a file stream in sparse format.

Returns CMR_ERROR_INPUT in case of errors. In this case, *presult will be NULL.

Parameters

cmr	CMR environment.
stream	File stream to read from.
presult	Pointer for storing the matrix.

◆ CMRintmatFindEntry()

CMR_EXPORT CMR_ERROR CMRintmatFindEntry	(	CMR_INTMAT *	matrix,
		size_t	row,
		size_t	column,
		size_t *	pentry
	)

Finds a specific entry of an int matrix.

Searches for the entry at (row, column) using binary search.

Parameters

matrix	Input matrix.
row	A row.
column	A column.
pentry	Pointer for storing the entry at `row`, `column`, or `SIZE_MAX` if it is zero.

◆ CMRintmatFree()

CMR_EXPORT CMR_ERROR CMRintmatFree	(	CMR *	cmr,
		CMR_INTMAT **	pmatrix
	)

Frees the memory of an int matrix.

Parameters

cmr	CMR environment.
pmatrix	Pointer to matrix.

◆ CMRintmatIsBinary()

CMR_EXPORT bool CMRintmatIsBinary	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_SUBMAT **	psubmatrix
	)

Checks if an int matrix has only entries in \( \{0,1\} \).

Parameters

cmr	CMR environment.
matrix	A matrix.
psubmatrix	Pointer for storing a non-binary entry as a submatrix (may be `NULL`).

◆ CMRintmatIsTernary()

CMR_EXPORT bool CMRintmatIsTernary	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_SUBMAT **	psubmatrix
	)

Checks if an int matrix has only entries in \( \{-1,0,+1\} \).

Parameters

cmr	CMR environment.
matrix	A matrix.
psubmatrix	Pointer for storing a non-ternary entry as a submatrix (may be `NULL`).

◆ CMRintmatPermute()

CMR_EXPORT CMR_ERROR CMRintmatPermute	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		size_t *	rows,
		size_t *	columns,
		CMR_INTMAT **	presult
	)

Creates the int matrix obtained from matrix by applying row- and column-permutations.

Parameters

cmr	CMR environment.
matrix	Given matrix.
rows	Mapping from new rows to rows of `matrix` (may be `NULL` for identity).
columns	Mapping from new columns to columns of `matrix` (may be `NULL` for identity).
presult	Pointer for storing the permuted matrix.

◆ CMRintmatPrintDense()

CMR_EXPORT CMR_ERROR CMRintmatPrintDense	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		FILE *	stream,
		char	zeroChar,
		bool	header
	)

Prints an int matrix in dense format.

Parameters

cmr	CMR environment.
matrix	A matrix.
stream	File stream to print to.
zeroChar	Character to print for a zero.
header	Whether to print row and column indices.

◆ CMRintmatPrintSparse()

CMR_EXPORT CMR_ERROR CMRintmatPrintSparse	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		FILE *	stream
	)

Prints an int matrix in sparse format.

Parameters

cmr	CMR environment.
matrix	A matrix.
stream	File stream to print to.

◆ CMRintmatSignedSupport()

CMR_EXPORT CMR_ERROR CMRintmatSignedSupport	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Creates the (ternary) signed support matrix of an int matrix as a char matrix.

Parameters

cmr	CMR environment.
matrix	Double matrix
presult	Pointer for storing the signed support matrix of `matrix`.

◆ CMRintmatSlice()

CMR_EXPORT CMR_ERROR CMRintmatSlice	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_SUBMAT *	submatrix,
		CMR_INTMAT **	presult
	)

Slices a submatrix of an int matrix.

Parameters

cmr	CMR environment.
matrix	A matrix
submatrix	A submatrix of `matrix`.
presult	Pointer for storing the resulting matrix.

◆ CMRintmatSortNonzeros()

CMR_EXPORT CMR_ERROR CMRintmatSortNonzeros	(	CMR *	cmr,
		CMR_INTMAT *	matrix
	)

Sorts the nonzeros of an int matrix by column in ascending order.

Parameters

cmr	CMR environment.
matrix	A matrix.

◆ CMRintmatSupport()

CMR_EXPORT CMR_ERROR CMRintmatSupport	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Creates the (binary) support matrix of an int matrix as a char matrix.

Parameters

cmr	CMR environment.
matrix	Double matrix
presult	Pointer for storing the support matrix of `matrix`.

◆ CMRintmatToChr()

CMR_EXPORT CMR_ERROR CMRintmatToChr	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_CHRMAT **	presult
	)

Converts an int matrix to a char matrix.

Returns: CMR_ERROR_OVERFLOW in case of overflow.

Parameters

cmr	CMR environment.
matrix	Input matrix.
presult	Pointer for storing the output matrix.

◆ CMRintmatTranspose()

CMR_EXPORT CMR_ERROR CMRintmatTranspose	(	CMR *	cmr,
		CMR_INTMAT *	matrix,
		CMR_INTMAT **	presult
	)

Creates the transpose of an int matrix.

Parameters

cmr	CMR environment.
matrix	Given matrix.
presult	Pointer for storing the transpose of `matrix`.

◆ CMRsubmatCreate()

CMR_EXPORT CMR_ERROR CMRsubmatCreate	(	CMR *	cmr,
		size_t	numRows,
		size_t	numColumns,
		CMR_SUBMAT **	psubmatrix
	)

Creates a submatrix of given size.

Only allocates the memory. Use rows and columns attributes of *psubmatrix to actually set the row and column indices, respectively.

Parameters

cmr	CMR environment.
numRows	Number of rows
numColumns	Number of columns
psubmatrix	Pointer to where the submatrix is to be stored.

◆ CMRsubmatCreate1x1()

CMR_EXPORT CMR_ERROR CMRsubmatCreate1x1	(	CMR *	cmr,
		size_t	row,
		size_t	column,
		CMR_SUBMAT **	psubmatrix
	)

Creates a 1-by-1 submatrix.

Parameters

cmr	CMR environment.
row	Row of entry
column	Column of entry
psubmatrix	Pointer to submatrix

◆ CMRsubmatFree()

CMR_EXPORT CMR_ERROR CMRsubmatFree	(	CMR *	cmr,
		CMR_SUBMAT **	psubmatrix
	)

Frees a submatrix.

Parameters

cmr	CMR environment.
psubmatrix	Pointer to submatrix.

◆ CMRsubmatPrint()

CMR_EXPORT CMR_ERROR CMRsubmatPrint	(	CMR *	cmr,
		CMR_SUBMAT *	submatrix,
		size_t	numRows,
		size_t	numColumns,
		FILE *	stream
	)

Writes the submatrix submatrix to the file stream by means of lists of row and column indices.

In the stream, row and column indices start at 1 while they start at 0 in submatrix.

Parameters

cmr	CMR environment.
submatrix	Reference submatrix.
numRows	Number of rows of original matrix.
numColumns	Number of columns of original matrix.
stream	File stream to save submatrix to.

◆ CMRsubmatReadFromStream()

CMR_EXPORT CMR_ERROR CMRsubmatReadFromStream	(	CMR *	cmr,
		CMR_SUBMAT **	psubmatrix,
		size_t *	pnumMatrixRows,
		size_t *	pnumMatrixColumns,
		FILE *	stream
	)

Reads the submatrix *psubmatrix from the file stream.

In the stream, row and column indices start at 1 while they start at 0 in submatrix.

Parameters

cmr	CMR environment.
psubmatrix	Pointer for storing the submatrix.
pnumMatrixRows	Pointer for storing the number of rows of the original matrix; may be `NULL`.
pnumMatrixColumns	Pointer for storing the number of rows of the original matrix; may be `NULL`.
stream	File stream to save submatrix to.

◆ CMRsubmatSlice()

CMR_EXPORT CMR_ERROR CMRsubmatSlice	(	CMR *	cmr,
		CMR_SUBMAT *	base,
		CMR_SUBMAT *	input,
		CMR_SUBMAT **	poutput
	)

Returns the submatrix input as a submatrix of the base submatrix.

Assumes that each row/column of input also appear inbase. After the call *poutput will refer to the same rows/columns but from the viewpoint of base. Otherwise, CMR_ERROR_INPUT is returned.

Parameters

cmr	CMR environment.
base	Reference submatrix.
input	Input submatrix.
poutput	Pointer for storing the output submatrix.

◆ CMRsubmatTranspose()

CMR_EXPORT CMR_ERROR CMRsubmatTranspose ( CMR_SUBMAT * submatrix )

Transposes a submatrix.

Parameters

submatrix Submatrix to transpose.

◆ CMRsubmatUnslice()

CMR_EXPORT CMR_ERROR CMRsubmatUnslice	(	CMR *	cmr,
		CMR_SUBMAT *	base,
		CMR_SUBMAT *	input,
		CMR_SUBMAT **	poutput
	)

Returns the sub-submatrix input of base as a submatrix of its parent.

The rows/columns of input are interpreted as those of base. After the call *poutput will refer to the saem rows/columns but as those of the parent.

Parameters

cmr	CMR environment.
base	Reference submatrix.
input	Input submatrix.
poutput	Pointer for storing the output submatrix.

◆ CMRsubmatWriteToFile()

CMR_EXPORT CMR_ERROR CMRsubmatWriteToFile	(	CMR *	cmr,
		CMR_SUBMAT *	submatrix,
		size_t	numRows,
		size_t	numColumns,
		const char *	fileName
	)

Writes the submatrix submatrix to the file fileName by means of lists of row and column indices.

In the file, row and column indices start at 1 while they start at 0 in submatrix.

Parameters

cmr	CMR environment.
submatrix	Reference submatrix.
numRows	Number of rows of original matrix.
numColumns	Number of columns of original matrix.
fileName	File name to save submatrix to; `NULL` indicates stdout.

Classes

Functions

Detailed Description

Function Documentation

◆ CMRchrmatChangeNumNonzeros()

◆ CMRchrmatCheckEqual()

◆ CMRchrmatCheckTranspose()

◆ CMRchrmatConsistency()

◆ CMRchrmatCopy()

◆ CMRchrmatCreate()

◆ CMRchrmatCreateFromDenseFile()

◆ CMRchrmatCreateFromDenseStream()

◆ CMRchrmatCreateFromSparseFile()

◆ CMRchrmatCreateFromSparseStream()

◆ CMRchrmatFindEntry()

◆ CMRchrmatFree()

◆ CMRchrmatIsBinary()

◆ CMRchrmatIsTernary()

◆ CMRchrmatPermute()

◆ CMRchrmatPrintDense()

◆ CMRchrmatPrintSparse()

◆ CMRchrmatSignedSupport()

◆ CMRchrmatSlice()

◆ CMRchrmatSortNonzeros()

◆ CMRchrmatSupport()

◆ CMRchrmatToInt()

◆ CMRchrmatTranspose()

◆ CMRdblmatChangeNumNonzeros()

◆ CMRdblmatCheckEqual()

◆ CMRdblmatCheckTranspose()

◆ CMRdblmatConsistency()

◆ CMRdblmatCopy()

◆ CMRdblmatCreate()

◆ CMRdblmatCreateFromDenseFile()

◆ CMRdblmatCreateFromDenseStream()

◆ CMRdblmatCreateFromSparseFile()

◆ CMRdblmatCreateFromSparseStream()

◆ CMRdblmatFindBinarySubmatrix()

◆ CMRdblmatFindEntry()

◆ CMRdblmatFindTernarySubmatrix()

◆ CMRdblmatFree()

◆ CMRdblmatIsBinary()

◆ CMRdblmatIsTernary()

◆ CMRdblmatPermute()

◆ CMRdblmatPrintDense()

◆ CMRdblmatPrintSparse()

◆ CMRdblmatSignedSupport()

◆ CMRdblmatSlice()

◆ CMRdblmatSortNonzeros()

◆ CMRdblmatSupport()

◆ CMRdblmatToChr()

◆ CMRdblmatTranspose()

◆ CMRintmatChangeNumNonzeros()

◆ CMRintmatCheckEqual()

◆ CMRintmatCheckTranspose()

◆ CMRintmatConsistency()

◆ CMRintmatCopy()

◆ CMRintmatCreate()

◆ CMRintmatCreateFromDenseFile()

◆ CMRintmatCreateFromDenseStream()

◆ CMRintmatCreateFromSparseFile()

◆ CMRintmatCreateFromSparseStream()

◆ CMRintmatFindEntry()

◆ CMRintmatFree()

◆ CMRintmatIsBinary()

◆ CMRintmatIsTernary()

◆ CMRintmatPermute()

◆ CMRintmatPrintDense()

◆ CMRintmatPrintSparse()

◆ CMRintmatSignedSupport()

◆ CMRintmatSlice()

◆ CMRintmatSortNonzeros()

◆ CMRintmatSupport()

◆ CMRintmatToChr()

◆ CMRintmatTranspose()

◆ CMRsubmatCreate()

◆ CMRsubmatCreate1x1()

◆ CMRsubmatFree()

◆ CMRsubmatPrint()

◆ CMRsubmatReadFromStream()