getdist.types

class getdist.types.BestFit(fileName=None, setParamNameFile=None, want_fixed=False, max_posterior=True)

Class holding the result of a likelihood minimization, inheriting from ParamResults. The data is read from a specific formatted text file (.minimum or .bestfit) as output by CosmoMC or Cobaya.

Parameters:

• fileName – text file to load from, assumed to be in CosmoMC’s .minimum format

• setParamNameFile – optional name of .paramnames file listing preferred parameter labels for the parameters

• want_fixed – whether to include values of parameters that are not allowed to vary

• max_posterior – whether the file is a maximum posterior (default) or maximum likelihood

class getdist.types.ConvergeStats(fileName=None, setParamNameFile=None, default=0, names=None, labels=None)

Parameters:

• fileName – name of .paramnames file to load from

• setParamNameFile – override specific parameter names’ labels using another file

• default – set to int>0 to automatically generate that number of default names and labels (param1, p_{1}, etc.)

• names – a list of name strings to use

class getdist.types.LikeStats(fileName=None, setParamNameFile=None, default=0, names=None, labels=None)

Stores likelihood-related statistics, including best-fit sample and extremal values of the N-D confidence region, inheriting from ParamResults. TODO: currently only saves to text, does not load full data from file

Parameters:

• fileName – name of .paramnames file to load from

• setParamNameFile – override specific parameter names’ labels using another file

• default – set to int>0 to automatically generate that number of default names and labels (param1, p_{1}, etc.)

• names – a list of name strings to use

class getdist.types.MargeStats(fileName=None, setParamNameFile=None, default=0, names=None, labels=None)

Stores marginalized 1D parameter statistics, including mean, variance and confidence limits, inheriting from ParamResults.

Values are stored as attributes of the ParamInfo objects stored in self.names. Use par= margeStats.parWithName(‘xxx’) to get the ParamInfo for parameter xxx; Values stored are:

• par.mean: parameter mean

• par.err: standard deviation

• limits: list of ParamLimit objects for the stored number of marginalized limits

For example to get the first and second lower limits (default 68% and 95%) for parameter xxx:

print(margeStats.names.parWithName('xxx').limits[0].lower)
print(margeStats.names.parWithName('xxx').limits[1].lower)

See ParamLimit for details of limits.

Parameters:

• fileName – name of .paramnames file to load from

• setParamNameFile – override specific parameter names’ labels using another file

• default – set to int>0 to automatically generate that number of default names and labels (param1, p_{1}, etc.)

• names – a list of name strings to use

loadFromFile(filename)

Load from a plain text file

Parameters:

filename – file to load from

class getdist.types.ParamLimit(minmax, tag='two')

Class containing information about a marginalized parameter limit.

Variables:

• lower – lower limit

• upper – upper limit

• twotail – True if a two-tail limit, False if one-tail

• onetail_upper – True if one-tail upper limit

• onetail_lower – True if one-tail lower limit

Parameters:

• minmax – a [min,max] tuple with lower and upper limits. Entries be None if no limit.

• tag – a text tag descibing the limit, one of [‘two’ | ‘>’ | ‘<’ | ‘none’]

limitTag()

Returns:

Short text tag describing the type of limit (one-tail or two tail):

• two: two-tail limit

• >: a one-tail upper limit

• <: a one-tail lower limit

• none: no limits (both boundaries have high probability)

limitType()

Returns:

a text description of the type of limit. One of:

• two tail

• one tail upper limit

• one tail lower limit

• none

class getdist.types.ParamResults(fileName=None, setParamNameFile=None, default=0, names=None, labels=None)

Base class for a set of parameter results, inheriting from ParamList, so that self.names is a list of ParamInfo instances for each parameter, which have attribute holding results for the different parameters.

Parameters:

• fileName – name of .paramnames file to load from

• setParamNameFile – override specific parameter names’ labels using another file

• default – set to int>0 to automatically generate that number of default names and labels (param1, p_{1}, etc.)

• names – a list of name strings to use

class getdist.types.ResultTable(ncol, results, limit=2, tableParamNames=None, titles=None, formatter=None, numFormatter=None, blockEndParams=None, paramList=None, refResults=None, shiftSigma_indep=False, shiftSigma_subset=False)

Class for holding a latex table of parameter statistics

Parameters:

• ncol – number of columns

• results – a MargeStats or BestFit instance, or a list of them for comparing different results, or an MCSamples instance for white getMargeStats() will be called.

• limit – which limit to include (1 is first limit calculated, usually 68%, 2 the second, usually 95%)

• tableParamNames – optional ParamNames instance listing particular parameters to include

• titles – optional titles describing different results

• formatter – a table formatting class

• numFormatter – a number formatting class

• blockEndParams – mark parameters in blocks, ending on this list of parameter names

• paramList – a list of parameter names (strings) to include

• refResults – for showing parameter shifts, a reference MargeStats instance to show differences to

• shiftSigma_indep – show parameter shifts in sigma assuming data are independent

• shiftSigma_subset – show parameter shifts in sigma assuming data are a subset of each other

tablePNG(dpi=None, latex_preamble=None, filename=None, bytesIO=False)

Get a .png file image of the table. You must have latex installed to use this.

Parameters:

• dpi – dpi settings for the png

• latex_preamble – any latex preamble

• filename – filename to save to (defaults to file in the temp directory)

• bytesIO – if True, return a BytesIO instance holding the .png data

Returns:

if bytesIO, the BytesIO instance, otherwise name of the output file

tableTex(document=False, latex_preamble=None, packages=('amsmath', 'amssymb', 'bm'))

Get the latex string for the table

Parameters:

• document – if True, make a full latex file, if False just the snippet for including in another file

• latex_preamble – any preamble to include in the latex file

• packages – list of packages to load

write(fname, **kwargs)

Write the latex for the table to a file

Parameters:

• fname – filename to write

• kwargs – arguments for tableTex()

getdist.types.float_to_decimal(f)

Convert a floating point number to a Decimal with no loss of information