:orphan:
# DMStagSetNumRanks
set ranks in each direction in the global rank grid 
## Synopsis
```
PetscErrorCode DMStagSetNumRanks(DM dm, PetscInt nRanks0, PetscInt nRanks1, PetscInt nRanks2)
```
Logically Collective; `nRanks0`, `nRanks1`, and `nRanks2` must contain common values


## Input Parameters

- ***dm -*** the `DMSTAG` object
- ***nRanks0 -*** number of ranks in the x direction
- ***nRanks1 -*** number of ranks in the y direction
- ***nRanks2 -*** number of ranks in the z direction





## Note
Arguments corresponding to higher dimensions are ignored for 1D and 2D grids.


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

## Level
developer

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


---
[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)  
