create_adjacency_matrix#

Network.create_adjacency_matrix(weights=None, fmt='coo', triu=False, drop_zeros=False)[source]#

Generates a weighted adjacency matrix in the desired sparse format

Parameters:
  • weights (array_like, optional) –

    An array containing the throat values to enter into the matrix (in graph theory these are known as the ‘weights’).

    If the array is Nt-long, it implies that the matrix is symmetric, so the upper and lower triangular regions are mirror images. If it is 2*Nt-long then it is assumed that the first Nt elements are for the upper triangle, and the last Nt element are for the lower triangular.

    If omitted, ones are used to create a standard adjacency matrix representing connectivity only.

  • fmt (str, optional) –

    The sparse storage format to return. Options are:

    ’coo’ : This is the native format of OpenPNM’s data ‘lil’ : Enables row-wise slice of the matrix ‘csr’ : Favored by most linear algebra routines ‘dok’ : Enables subscript access of locations

  • triu (bool, default is False) – If True, the returned sparse matrix only contains the upper-triangular elements. This argument is ignored if the weights array is 2*Nt-long.

  • drop_zeros (bool, default is False) – If True, applies the eliminate_zeros method of the sparse array to remove all zero locations.

Return type:

An adjacency matrix in the specified Scipy sparse format.

Notes

The adjacency matrix is used by OpenPNM for finding the pores connected to a give pore or set of pores. Specifically, an adjacency matrix has Np rows and Np columns. Each row represents a pore, containing non-zero values at the locations corresponding to the indices of the pores connected to that pore. The weights argument indicates what value to place at each location, with the default being 1’s to simply indicate connections. Another useful option is throat indices, such that the data values on each row indicate which throats are connected to the pore.

Examples

>>> import openpnm as op
>>> pn = op.network.Cubic(shape=[5, 5, 5])
>>> weights = np.random.rand(pn.num_throats(), ) < 0.5
>>> am = pn.create_adjacency_matrix(weights=weights, fmt='csr')