Class UnresoStats

Initializing an instance of UnresoStats.

Parameters:

• star_name (string) - Star name from Star.dat
• code (string) - the code used for producing your output

  (default: 'GASTRoNOoM')

• path_code (string) - Output folder in the code's home folder

  (default: 'codeSep2010')

Overrides: object.__init__

Set an instrument, see Statistics.py.

Parameters:

• instrument_name (string) - The instrument (such as 'PACS', 'SPIRE')

Overrides: cc.statistics.Statistics.Statistics.setInstrument

Find the peak to peak ratios of data versus model.

The result are saved in the self.peak_ratios dictionary, see __init__.__doc__()

Calculate the chi_squared value for given models and data.

If integrated fluxes are available, they are used without the line blends. LINES FLAGGED AS A BLEND ARE EXCLUDED FROM THE CHI2 CALCULATION.

If not, the modeled, convolved spectrum is compared directly with the data, where the model is not just 0 flux.

Parameters:

• chi2_method (string) - The type of chi-squared calculated for integrated fluxes. 'diff' for standard chi^2 kind, 'log' for redistributing the data/model ratios on an absolute logarithmic scale before calculating the chi2

  (default: 'diff')

• ndf (int) - Number of degrees of freedom. Default in case of calculating for one single model. Typically the number of variable grid parameters in a grid calculation.

  (default: 0)

• filename (string) - the filename for which you want to return the list, if None, all filenames are used and the lists are merged into one

  (default: None)

Return all ratios for all filenames, including only the values that are not None.

Selection type helps to filter out blended lines (negative values for the ratios), or unavailable ratios (None). Can only be int_ratios or peak_ratios when this_id is not None.

The data type that is returned can be any of the dictionaries tracking stuff in this object.

Parameters:

• this_id (string) - The requested instrument id. Can be None in case both sel_type and data_type point to dictionaries that are not sorted per model.

  (default: None)

• sel_type (string) - The type of data used to select values, one of 'peak_ratios' or 'int_ratios'

  (default: 'peak_ratios')

• data_type (string) - the type of data returned, one of 'peak_ratios', 'int_ratios', 'central_mwav', '*_bands'

  (default: 'peak_ratios')

• return_negative (bool) - only return the negative peak ratios or equivalent (lower limits).

  (default: 0)

• filename (string) - the filename for which you want to return the list, if None, all filenames are used and the lists are merged into one

  (default: None)

Returns: array

The ratios requested

Plot ratios as a function of their central wavelength.

In blue and green, the peak-to-peak ratios are plotted. Blue for normal peak-to-peak ratios, green for ratios that involve a data point that is in the noise. Plotting peak-to-peak ratios can be turned off with the no_peak keyword.

In red and magenta, the integrated line strengths are plotted. Red for isolated lines that are not tagged as a blend, magenta for lines that are tagged as a blend due to 1) too wide lines with respect to the PACS resolution, or 2) multiple sample transitions in the width of an observed line.

Parameters:

• inputfilename (string) - the input filename for the grid, which will be attached to the final plot filename
• no_peak (bool) - Hide the peak ratios.

  (default: False)

Return a sorted list of the star grid in this instance according to the chi^2 value. If a chi^2 based on integrated line fluxes is available, it is used. Otherwise the chi^2 determined from convolved model vs data is taken.

Returns: list[Star]

A sorted list of models according to chi^2