Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
HPL_pdinfo(3)		      HPL Library Functions		   HPL_pdinfo(3)

NAME
     HPL_pdinfo - Read input parameter file.

SYNOPSIS
     #include "hpl.h"

     void HPL_pdinfo( HPL_T_test * TEST, int * NS, int * N, int * NBS, int * NB,
     HPL_T_ORDER * PMAPPIN, int * NPQS, int * P, int * Q, int * NPFS, HPL_T_FACT
     *	PF, int * NBMS, int * NBM, int * NDVS, int * NDV, int * NRFS, HPL_T_FACT
     * RF, int * NTPS, HPL_T_TOP * TP, int * NDHS, int * DH, HPL_T_SWAP * FSWAP,
     int * TSWAP, int * L1NOTRAN, int * UNOTRAN, int * EQUIL, int * ALIGN );

DESCRIPTION
     HPL_pdinfo reads  the  startup   information  for	the  various  tests  and
     transmits it to all processes.

ARGUMENTS
     TEST    (global output)	     HPL_T_test *
	     On  entry,  TEST  points to a testing data structure.  On exit, the
	     fields  of  this  data  structure	are  initialized   as	follows:
	     TEST->outfp   specifies  the  output file where the results will be
	     printed.  It is only defined and used by	the  process  0  of  the
	     grid.   TEST->thrsh specifies the threshhold value for the test ra-
	     tio.  TEST->epsil is the relative machine precision of the distrib-
	     uted computer.  Finally  the test counters,  kfail,  kpass,  kskip,
	     ktest are initialized to zero.

     NS      (global output)	     int *
	     On exit,  NS  specifies the number of different problem sizes to be
	     tested. NS is less than or equal to HPL_MAX_PARAM.

     N	     (global output)	     int *
	     On  entry,  N is an array of dimension HPL_MAX_PARAM.  On exit, the
	     first NS entries of this array contain the  problem  sizes  to  run
	     the code with.

     NBS     (global output)	     int *
	     On  exit,	 NBS   specifies  the  number  of different distribution
	     blocking factors to be tested. NBS must be less than  or  equal  to
	     HPL_MAX_PARAM.

     NB      (global output)	     int *
	     On  exit,	 PMAPPIN  specifies the process mapping onto the no- des
	     of the  MPI machine configuration.  PMAPPIN  defaults  to row-major
	     ordering.

     PMAPPIN (global output)	     HPL_T_ORDER *
	     On entry, NB is an array of dimension HPL_MAX_PARAM. On  exit,  the
	     first  NBS  entries of this array contain the values of the various
	     distribution blocking factors, to run the code with.

     NPQS    (global output)	     int *
	     On exit, NPQS  specifies the  number of different values  that  can
	     be  used for P and Q, i.e., the number of process grids to run  the
	     code with.  NPQS must be  less  than  or  equal  to HPL_MAX_PARAM.

     P	     (global output)	     int *
	     On entry, P  is an array of dimension HPL_MAX_PARAM. On  exit,  the
	     first  NPQS entries of this array contain the values of P, the num-
	     ber of process rows of the  NPQS grids to run the code with.

     Q	     (global output)	     int *
	     On entry, Q  is an array of dimension HPL_MAX_PARAM. On  exit,  the
	     first  NPQS entries of this array contain the values of Q, the num-
	     ber of process columns of the  NPQS  grids to  run the code with.

     NPFS    (global output)	     int *
	     On exit, NPFS  specifies the  number of different values  that  can
	     be  used for PF : the panel factorization algorithm to run the code
	     with. NPFS is less than or equal to HPL_MAX_PARAM.

     PF      (global output)	     HPL_T_FACT *
	     On entry, PF is an array of dimension HPL_MAX_PARAM. On  exit,  the
	     first   NPFS   entries   of  this array  contain  the various panel
	     factorization algorithms to run the code with.

     NBMS    (global output)	     int *
	     On exit,  NBMS  specifies	the  number  of  various recursive stop-
	     ping criteria  to be tested.  NBMS  must be  less than or equal  to
	     HPL_MAX_PARAM.

     NBM     (global output)	     int *
	     On entry,	NBM  is an array of  dimension	HPL_MAX_PARAM.	On exit,
	     the first NBMS entries of this array contain the values of the var-
	     ious recursive stopping criteria to be tested.

     NDVS    (global output)	     int *
	     On  exit,	NDVS  specifies  the number  of various numbers  of pan-
	     els in recursion to be tested.  NDVS  is  less  than  or  equal  to
	     HPL_MAX_PARAM.

     NDV     (global output)	     int *
	     On entry,	NDV  is an array of  dimension	HPL_MAX_PARAM.	On exit,
	     the first NDVS entries of this array contain the values of the var-
	     ious numbers of panels in recursion to be tested.

     NRFS    (global output)	     int *
	     On  exit,	NRFS  specifies the  number of different values that can
	     be used for RF  :	the  recursive	factorization  algorithm  to  be
	     tested. NRFS is less than or equal to HPL_MAX_PARAM.

     RF      (global output)	     HPL_T_FACT *
	     On  entry,  RF is an array of dimension HPL_MAX_PARAM. On exit, the
	     first  NRFS  entries  of  this array contain  the various recursive
	     factorization algorithms to run the code with.

     NTPS    (global output)	     int *
	     On exit, NTPS  specifies the  number of different values  that  can
	     be  used  for the	broadcast topologies  to be tested. NTPS is less
	     than or equal to HPL_MAX_PARAM.

     TP      (global output)	     HPL_T_TOP *
	     On entry, TP is an array of dimension HPL_MAX_PARAM. On  exit,  the
	     first  NTPS  entries of this  array  contain  the various broadcast
	     (along rows) topologies to run the code with.

     NDHS    (global output)	     int *
	     On exit, NDHS  specifies the  number of different values  that  can
	     be used for the  lookahead depths to be  tested.  NDHS is less than
	     or equal to HPL_MAX_PARAM.

     DH      (global output)	     int *
	     On entry,	DH  is	an array of  dimension	HPL_MAX_PARAM.	On exit,
	     the  first  NDHS entries of this array contain the values of looka-
	     head depths to run the code with.	Such a value is at least 0  (no-
	     lookahead) or greater than zero.

     FSWAP   (global output)	     HPL_T_SWAP *
	     On  exit,	FSWAP specifies the swapping algorithm to be used in all
	     tests.

     TSWAP   (global output)	     int *
	     On exit,  TSWAP  specifies the swapping threshold as  a  number  of
	     columns when the mixed swapping algorithm was chosen.

     L1NOTRA (global output)	     int *
	     On  exit, L1NOTRAN specifies whether the upper triangle of the pan-
	     els of columns  should  be stored	in  no-transposed   form  (L1NO-
	     TRAN=1) or in transposed form (L1NOTRAN=0).

     UNOTRAN (global output)	     int *
	     On  exit,	UNOTRAN   specifies whether the panels of rows should be
	     stored in	no-transposed form   (UNOTRAN=1)   or	transposed  form
	     (UNOTRAN=0) during their broadcast.

     EQUIL   (global output)	     int *
	     On exit,  EQUIL  specifies  whether  equilibration during the swap-
	     broadcast	 of  the  panel of rows  should  be  performed (EQUIL=1)
	     or not (EQUIL=0).

     ALIGN   (global output)	     int *
	     On exit,  ALIGN  specifies the alignment  of  the dynamically allo-
	     cated buffers in double precision	words.	ALIGN  is  greater  than
	     zero.

SEE ALSO
     HPL_pddriver (3), HPL_pdtest (3).

HPL 2.3 			December 2, 2018		   HPL_pdinfo(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=HPL_pdinfo&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help