Rpc::AmCompressor

The AmCompressor classes used by both the pscf_pc and pscf_pg programs implements a linear-response Anderson mixing (LRAM) algorithm as described in this publication.

Two closely analogous classes named Pscf::Rpc::AmCompressor and Pscf::Rpg::AmCompressor implement this algorithm for the pscf_pc CPU and program and the pscf_pg GPU-accelerated program, respectively. These two classes implement the same step algorithm and use the same parameter file format, which are documented below.

Step Algorithm

A general discussion of compressor algorithms for PS-FTS is given here.

The AmCompressor algorithm ...

Parameter File

The only required parameter for this algorithm is the error threshhold "epsilon"

AmCompressor{
  epsilon      1.0E-4
}

The full parameter file format, including all optional parameters, is shown below:

AmCompressor{
  epsilon           float
  maxItr*           int     (default 200)
  maxHist           int     (default 50)
  verbose           int     (default 0)
  correctionRamp*   float   (default 0.9)
  errorType*        string  ("norm", "rms", "max", or "relNorm")
}

Meanings of all parameters are described briefly below:

Label	Description
epsilon	error threshhold
maxItr*	maximum number of iterations to attempt before declaring failure
maxHist*	maximum number of previous states to retain in history
verbose*	verbosity level (lower values are less verbose. Default level = 0)
errorType*	????