# DMPlexGetJoin
Get an array for the join of the set of points 
## Synopsis
```
#include "petscdmplex.h"   
PetscErrorCode DMPlexGetJoin(DM dm, PetscInt numPoints, const PetscInt points[], PetscInt *numCoveredPoints, const PetscInt **coveredPoints)
```
Not Collective


## Input Parameters

- ***dm -*** The DMPlex object
- ***numPoints -*** The number of input points for the join
- ***points -*** The input points



## Output Parameters

- ***numCoveredPoints -*** The number of points in the join
- ***coveredPoints -*** The points in the join




Note: Currently, this is restricted to a single level join


## Fortran Notes
Since it returns an array, this routine is only available in Fortran 90, and you must
include petsc.h90 in your code.

The numCoveredPoints argument is not present in the Fortran 90 binding since it is internal to the array.


## See Also
 `DMPlexRestoreJoin()`, `DMPlexGetMeet()`

## Level
intermediate

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/plex/plex.c.html#DMPlexGetJoin">src/dm/impls/plex/plex.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/ts/tutorials/ex11.c.html">src/ts/tutorials/ex11.c.html</A><BR>
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/ts/tutorials/ex11_sa.c.html">src/ts/tutorials/ex11_sa.c.html</A><BR>


---
[Edit on GitLab](https://gitlab.com/petsc/petsc/-/edit/release/src/dm/impls/plex/plex.c)


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