SCORPIO  1.8.0
Functions/Subroutines
PIO_readdof

Write/Save the I/O decomposition. More...

Functions/Subroutines

subroutine spio_decomp::pio_readdof_int (fname, ndims, gdims, map, comm, ierr)
 Read an I/O decomposition from a file (saved using PIO_writedof()) More...
 
subroutine spio_decomp::pio_readdof_offset (fname, ndims, gdims, map, comm, ierr)
 Read an I/O decomposition from a file (saved using PIO_writedof()) More...
 

Detailed Description

Write/Save the I/O decomposition.

Function/Subroutine Documentation

◆ pio_readdof_int()

subroutine spio_decomp::pio_readdof_int ( character(len=*), intent(in)  fname,
integer, intent(out)  ndims,
integer, dimension(:), intent(out), pointer  gdims,
integer(i4), dimension(:), intent(out), pointer  map,
integer, intent(in)  comm,
integer, intent(out), optional  ierr 
)

Read an I/O decomposition from a file (saved using PIO_writedof())

Parameters
[in]fnameThe name of the input file with the I/O decomposition
[out]ndimsThe number of dimensions in the I/O decomposition is returned in this arg
[out]gdimsPointer to a 1D array where the global dimensions of the I/O decomposition will be saved. The array is allocated by the library
[out]mapPointer to a 1D array where the I/O decomposition mapping (between the local data index and the global linearized index for each local data element) will be saved. The array is allocated by the library e.g. If after partitioning the local array contains A(2,3) and A(3,3) of an array A[4x4], the map will contain [10, 11] corrsponding to the linearized indices of A(2,3) & A(3,3)
[in]commThe MPI communicator (that contains the MPI processes in the I/O system associated with the I/O decomposition)
[out]ierr(Optional) : The error return code. Set to PIO_NOERR on success, or an error code otherwise (See PIO_seterrorhandling for more information on how to customize/set error handling)

◆ pio_readdof_offset()

subroutine spio_decomp::pio_readdof_offset ( character(len=*), intent(in)  fname,
integer, intent(out)  ndims,
integer, dimension(:), intent(out), pointer  gdims,
integer(pio_offset_kind), dimension(:), intent(out), pointer  map,
integer, intent(in)  comm,
integer, intent(out), optional  ierr 
)

Read an I/O decomposition from a file (saved using PIO_writedof())

Parameters
[in]fnameThe name of the input file with the I/O decomposition
[out]ndimsThe number of dimensions in the I/O decomposition is returned in this arg
[out]gdimsPointer to a 1D array where the global dimensions of the I/O decomposition will be saved. The array is allocated by the library
[out]mapPointer to a 1D array where the I/O decomposition mapping (between the local data index and the global linearized index for each local data element) will be saved. The array is allocated by the library e.g. If after partitioning the local array contains A(2,3) and A(3,3) of an array A[4x4], the map will contain [10, 11] corrsponding to the linearized indices of A(2,3) & A(3,3)
[in]commThe MPI communicator (that contains the MPI processes in the I/O system associated with the I/O decomposition)
[out]ierr(Optional) : The error return code. Set to PIO_NOERR on success, or an error code otherwise (See PIO_seterrorhandling for more information on how to customize/set error handling)