petsc-3.14.6 2021-03-30

PetscViewerSocketOpen

Opens a connection to a MATLAB or other socket based server.

PetscErrorCode  PetscViewerSocketOpen(MPI_Comm comm,const char machine[],int port,PetscViewer *lab)

Collective

	comm	- the MPI communicator
	machine	- the machine the server is running on,, use NULL for the local machine, use "server" to passively wait for a connection from elsewhere
	port	- the port to connect to, use PETSC_DEFAULT for the default

lab

- a context to use when communicating with the server

Most users should employ the following commands to access the MATLAB PetscViewers

   PetscViewerSocketOpen(MPI_Comm comm, char *machine,int port,PetscViewer &viewer)

   MatView(Mat matrix,PetscViewer viewer)

or

   PetscViewerSocketOpen(MPI_Comm comm,char *machine,int port,PetscViewer &viewer)

   VecView(Vec vector,PetscViewer viewer)

   -viewer_socket_machine <machine>

   -viewer_socket_port <port>

	PETSC_VIEWER_SOCKET_PORT	- portnumber
	PETSC_VIEWER_SOCKET_MACHINE	- machine name

Currently the only socket client available is MATLAB. See src/dm/tests/ex12.c and ex12.m for an example of usage.

The socket viewer is in some sense a subclass of the binary viewer, to read and write to the socket use PetscViewerBinaryRead(), PetscViewerBinaryWrite(), PetscViewerBinarWriteStringArray(), PetscViewerBinaryGetDescriptor().

Use this for communicating with an interactive MATLAB session, see PETSC_VIEWER_MATLAB_() for writing output to a .mat file. Use PetscMatlabEngineCreate() or PETSC_MATLAB_ENGINE_(), PETSC_MATLAB_ENGINE_SELF, or PETSC_MATLAB_ENGINE_WORLD for communicating with a MATLAB Engine

intermediate