:orphan:
# DMStagGetIsFirstRank
get boolean value for whether this rank is first in each direction in the rank grid 
## Synopsis
```
PetscErrorCode DMStagGetIsFirstRank(DM dm, PetscBool *isFirstRank0, PetscBool *isFirstRank1, PetscBool *isFirstRank2)
```
Not Collective


## Input Parameter

- ***dm -*** the `DMSTAG` object



## Output Parameters

- ***isFirstRank0 -*** whether this rank is first in the x direction
- ***isFirstRank1 -*** whether this rank is first in the y direction
- ***isFirstRank2 -*** whether this rank is first in the z direction





## Note
Arguments corresponding to higher dimensions are ignored for 1D and 2D grids. These arguments may be set to `NULL` in this case.


## See Also
 [](ch_stag), `DMSTAG`, `DMStagGetIsLastRank()`

## Level
intermediate

## Location
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/stag/stagutils.c.html#DMStagGetIsFirstRank">src/dm/impls/stag/stagutils.c</A>

## Examples
<A HREF="PETSC_DOC_OUT_ROOT_PLACEHOLDER/src/dm/impls/stag/tutorials/ex1.c.html">src/dm/impls/stag/tutorials/ex1.c</A><BR>


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


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