petsc-3.7.7 2017-09-25

MatAssemblyEnd

Completes assembling the matrix. This routine should be called after MatAssemblyBegin().

Synopsis

#include "petscmat.h" 
PetscErrorCode MatAssemblyEnd(Mat mat,MatAssemblyType type)

Collective on Mat

Input Parameters

	mat	- the matrix
	type	- type of assembly, either MAT_FLUSH_ASSEMBLY or MAT_FINAL_ASSEMBLY

Options Database Keys

	-mat_view ::ascii_info	- Prints info on matrix at conclusion of MatEndAssembly()
	-mat_view ::ascii_info_detail	- Prints more detailed info
	-mat_view	- Prints matrix in ASCII format
	-mat_view ::ascii_matlab	- Prints matrix in Matlab format
	-mat_view draw	- PetscDraws nonzero structure of matrix, using MatView() and PetscDrawOpenX().
	-display <name>	- Sets display name (default is host)
	-draw_pause <sec>	- Sets number of seconds to pause after display
	-mat_view socket	- Sends matrix to socket, can be accessed from Matlab (See Users-Manual: Chapter 11 Using MATLAB with PETSc )
	-viewer_socket_machine <machine>	- Machine to use for socket
	-viewer_socket_port <port>	- Port number to use for socket
	-mat_view binary:filename[:append]	- Save matrix to file in binary format

Notes

MatSetValues() generally caches the values. The matrix is ready to use only after MatAssemblyBegin() and MatAssemblyEnd() have been called. Use MAT_FLUSH_ASSEMBLY when switching between ADD_VALUES and INSERT_VALUES in MatSetValues(); use MAT_FINAL_ASSEMBLY for the final assembly before using the matrix.

Space for preallocated nonzeros that is not filled by a call to MatSetValues() or a related routine are compressed out by assembly. If you intend to use that extra space on a subsequent assembly, be sure to insert explicit zeros before MAT_FINAL_ASSEMBLY so the space is not compressed out.

Examples