# PetscMatlabEngineCreate
Creates a MATLAB engine object 
## Synopsis
```
#include "petscmatlab.h"  
PetscErrorCode PetscMatlabEngineCreate(MPI_Comm comm, const char host[], PetscMatlabEngine *mengine)
```
Not Collective


## Input Parameters

- ***comm -*** a separate MATLAB engine is started for each process in the communicator
- ***host -*** name of machine where MATLAB engine is to be run (usually NULL)



## Output Parameter

- ***mengine -*** the resulting object



## Options Database Keys

- ***-matlab_engine_graphics -*** allow the MATLAB engine to display graphics
- ***-matlab_engine_host -*** hostname, machine to run the MATLAB engine on
- ***-info -*** print out all requests to MATLAB and all if its responses (for debugging)



## Notes
If a host string is passed in, any MATLAB scripts that need to run in the
engine must be available via MATLABPATH on that machine.

One must `./configure` PETSc with  `--with-matlab [-with-matlab-dir=matlab_root_directory]` to
use this capability




## See Also
 `PetscMatlabEngineDestroy()`, `PetscMatlabEnginePut()`, `PetscMatlabEngineGet()`,
`PetscMatlabEngineEvaluate()`, `PetscMatlabEngineGetOutput()`, `PetscMatlabEnginePrintOutput()`,
`PETSC_MATLAB_ENGINE_()`, `PetscMatlabEnginePutArray()`, `PetscMatlabEngineGetArray()`, `PetscMatlabEngine`

## Level
advanced

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/sys/classes/matlabengine/matlab.c.html#PetscMatlabEngineCreate">src/sys/classes/matlabengine/matlab.c</A>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/sys/classes/matlabengine/matlab.c)


[Index of all Sys routines](index.md)  
[Table of Contents for all manual pages](/docs/manualpages/index.md)  
[Index of all manual pages](/docs/manualpages/singleindex.md)  
