Next:
Contents
Contents
PSBLAS
User's and Reference Guide
A reference guide for the Parallel Sparse BLAS library
Salvatore Filippone
Alfredo Buttari
University of Rome ``Tor Vergata'', Italy
Software version: 3.0-beta
April 16, 2012.
Contents
Introduction
General overview
Basic Nomenclature
Library contents
Application structure
User-defined index mappings
Programming model
Data Structures and Classes
Descriptor data structure
Methods
get_local_rows -- Get number of local rows
get_local_cols -- Get number of local cols
get_global_rows -- Get number of global rows
get_global_cols -- Get number of global cols
get_context--Get communication context
psb_cd_get_large_threshold -- Get threshold for index mapping switch
psb_cd_set_large_threshold -- Set threshold for index mapping switch
Named Constants
Sparse Matrix class
Methods
get_nrows -- Get number of rows in a sparse matrix
get_ncols -- Get number of columns in a sparse matrix
get_nnzeros -- Get number of nonzero elements in a sparse matrix
get_size -- Get maximum number of nonzero elements in a sparse matrix
sizeof -- Get memory occupation in bytes of a sparse matrix
get_fmt -- Short description of the dynamic type
is_bld, is_upd, is_asb -- Status check
Named Constants
Dense Vector Data Structure
Methods
get_nrows -- Get number of rows in a dense vector
get_ncols -- Get number of columns in a sparse matrix
sizeof -- Get memory occupation in bytes of a dense vector matrix
get_vect -- Get a copy of the vector contents
Preconditioner data structure
Computational routines
psb_geaxpby -- General Dense Matrix Sum
psb_gedot -- Dot Product
psb_gedots -- Generalized Dot Product
psb_geamax -- Infinity-Norm of Vector
psb_geamaxs -- Generalized Infinity Norm
psb_geasum -- 1-Norm of Vector
psb_geasums -- Generalized 1-Norm of Vector
psb_genrm2 -- 2-Norm of Vector
psb_genrm2s -- Generalized 2-Norm of Vector
psb_spnrm1 -- 1-Norm of Sparse Matrix
psb_spnrmi -- Infinity Norm of Sparse Matrix
psb_spmm -- Sparse Matrix by Dense Matrix Product
psb_spsm -- Triangular System Solve
Communication routines
psb_halo -- Halo Data Communication
psb_ovrl -- Overlap Update
psb_gather -- Gather Global Dense Matrix
psb_scatter -- Scatter Global Dense Matrix
Data management routines
psb_cdall -- Allocates a communication descriptor
psb_cdins -- Communication descriptor insert routine
psb_cdasb -- Communication descriptor assembly routine
psb_cdcpy -- Copies a communication descriptor
psb_cdfree -- Frees a communication descriptor
psb_cdbldext -- Build an extended communication descriptor
psb_spall -- Allocates a sparse matrix
psb_spins -- Insert a cloud of elements into a sparse matrix
psb_spasb -- Sparse matrix assembly routine
psb_spfree -- Frees a sparse matrix
psb_sprn -- Reinit sparse matrix structure for psblas routines.
psb_geall -- Allocates a dense matrix
psb_geins -- Dense matrix insertion routine
psb_geasb -- Assembly a dense matrix
psb_gefree -- Frees a dense matrix
psb_gelp -- Applies a left permutation to a dense matrix
psb_glob_to_loc -- Global to local indices convertion
psb_loc_to_glob -- Local to global indices conversion
psb_is_owned
psb_owned_index
psb_is_local
psb_local_index
psb_get_boundary -- Extract list of boundary elements
psb_get_overlap -- Extract list of overlap elements
psb_sp_getrow -- Extract row(s) from a sparse matrix
psb_sizeof -- Memory occupation
Sorting utilities
Parallel environment routines
psb_init -- Initializes PSBLAS parallel environment
psb_info -- Return information about PSBLAS parallel environment
psb_exit -- Exit from PSBLAS parallel environment
psb_get_mpicomm -- Get the MPI communicator
psb_get_rank -- Get the MPI rank
psb_wtime -- Wall clock timing
psb_barrier -- Sinchronization point parallel environment
psb_abort -- Abort a computation
psb_bcast -- Broadcast data
psb_sum -- Global sum
psb_max -- Global maximum
psb_min -- Global minimum
psb_amx -- Global maximum absolute value
psb_amn -- Global minimum absolute value
psb_snd -- Send data
psb_rcv -- Receive data
Error handling
psb_errpush -- Pushes an error code onto the error stack
psb_error -- Prints the error stack content and aborts execution
psb_set_errverbosity -- Sets the verbosity of error messages.
psb_set_erraction -- Set the type of action to be taken upon error condition.
Utilities
hb_read -- Read a sparse matrix from a file in the Harwell-Boeing format
hb_write -- Write a sparse matrix to a file in the Harwell-Boeing format
mm_mat_read -- Read a sparse matrix from a file in the MatrixMarket format
mm_vet_read -- Read a dense vector from a file in the MatrixMarket format
mm_mat_write -- Write a sparse matrix to a file in the MatrixMarket format
Preconditioner routines
psb_precinit -- Initialize a preconditioner
psb_precbld -- Builds a preconditioner
psb_precaply -- Preconditioner application routine
psb_precdescr -- Prints a description of current preconditioner
Iterative Methods
psb_krylov -- Krylov Methods Driver Routine
Bibliography
About this document ...