PIO  1.7.1
 All Classes Files Functions Groups Pages
Functions/Subroutines
PIO_init

initializes the pio subsystem More...

Functions/Subroutines

subroutine piolib_mod::init_intracom (comp_rank, comp_comm, num_iotasks, num_aggregator, stride, rearr, iosystem, base)
 initialize the pio subsystem. More...
 
subroutine piolib_mod::init_intercom (component_count, peer_comm, comp_comms, io_comm, iosystem)
 Initialize the pio subsystem. More...
 

Detailed Description

initializes the pio subsystem

Function/Subroutine Documentation

subroutine piolib_mod::init_intercom ( integer, intent(in)  component_count,
integer, intent(in)  peer_comm,
integer, dimension(component_count), intent(in)  comp_comms,
integer, intent(in)  io_comm,
type (iosystem_desc_t), dimension(component_count), intent(out)  iosystem 
)

Initialize the pio subsystem.

This is a collective call. Input parameters are read on comp_rank=0 values on other tasks are ignored. This variation of PIO_init sets up a distinct set of tasks to handle IO, these tasks do not return from this call. Instead they go to an internal loop and wait to receive further instructions from the computational tasks

Parameters
component_countThe number of computational components to associate with this IO component
peer_commThe communicator from which all other communicator arguments are derived
comp_commsThe computational communicator for each of the computational components
io_commThe io communicator
iosystema derived type which can be used in subsequent pio operations (defined in PIO_types).
subroutine piolib_mod::init_intracom ( integer(i4), intent(in)  comp_rank,
integer(i4), intent(in)  comp_comm,
integer(i4), intent(in)  num_iotasks,
integer(i4), intent(in)  num_aggregator,
integer(i4), intent(in)  stride,
integer(i4), intent(in)  rearr,
type (iosystem_desc_t), intent(out)  iosystem,
integer(i4), intent(in), optional  base 
)

initialize the pio subsystem.

This is a collective call. Input parameters are read on comp_rank=0 values on other tasks are ignored. This variation of PIO_init locates the IO tasks on a subset of the compute tasks.

Parameters
comp_rankmpi rank of each participating task,
comp_commthe mpi communicator which defines the collective.
num_iotasksthe number of iotasks to define.
num_aggregatorthe mpi aggregator count
stridethe stride in the mpi rank between io tasks.
rearr\copybriefPIO_rearr_method
  • PIO_rearr_none : Do not use any form of rearrangement
  • PIO_rearr_box : Use a PIO internal box rearrangement
Parameters
iosystema derived type which can be used in subsequent pio operations (defined in PIO_types).
baseoptional argument can be used to offset the first io task - default base is task 1.