pts.storedtable.convert_singlegrain Namespace Reference

Functions for converting single-grain dust mix properties to stored table format. More...

Functions
def	convertMeanDraineLiOpticalProps (inFilePaths, outFilePaths)
	This function converts the column text data for the single-grain MeanDraineLiDustMix to stored table format. More...
def	convertMeanInterstellarOpticalProps (inFilePaths, outFilePaths)
	This function converts the column text data for the single-grain MeanInterstellarDustMix to stored table format. More...
def	convertMeanPascucciBenchmarkOpticalProps (inFilePaths, outFilePaths)
	This function converts the column text data for the single-grain MeanPascucciBenchmarkDustMix to stored table format. More...
def	convertMeanPinteBenchmarkMuellerMatrix (inFilePaths, outFilePaths)
	This function converts the column text file with Mueller matrix coefficients for the single-grain MeanPolarizedPinteBenchmarkDustMix to stored table format. More...
def	convertMeanPinteBenchmarkOpticalProps (inFilePaths, outFilePaths)
	This function converts the column text file with basic optical properties for the single-grain MeanPinteBenchmarkDustMix to stored table format. More...
def	convertMeanTrustBenchmarkMuellerMatrix (inFilePaths, outFilePaths)
	This function converts the set of column text files with Mueller matrix coefficients for the single-grain MeanPolarizedTrustBenchmarkDustMix to stored table format. More...
def	convertMeanTrustBenchmarkOpticalProps (inFilePaths, outFilePaths)
	This function converts the column text file with basic optical properties for the single-grain MeanTrustBenchmarkDustMix to stored table format. More...
def	convertMeanZubkoOpticalProps (inFilePaths, outFilePaths)
	This function converts the column text data for the single-grain MeanZubkoDustMix to stored table format. More...
def	createMeanIvezicBenchmarkOpticalProps (inFilePaths, outFilePaths)
	This function creates the power-laws for the single-grain MeanIvezicBenchmarkDustMix in stored table format. More...

Detailed Description

Functions for converting single-grain dust mix properties to stored table format.

The functions in this module can convert various kinds of single-grain dust mix properties to SKIRT stored table format. Single-grain dust mixes define the complete dust mix through the optical properties of just a single "representative" grain. These dust mixes cannot be used to calculate NLTE dust emission.

The stored tables for basic optical properties produced by the functions in this module have a single wavelength axis and the following quantities:

• sigmaabs (m2/H): absorption cross section per hydrogen nucleon (count, not mass)
• sigmasca (m2/H): scattering cross section per hydrogen nucleon (count, not mass)
• g (1): scattering anisotropy parameter, defined as the average of the scattering angle \(<cos\theta>\)
• mu (kg/H): dust mass per hydrogen nucleon; this is wavelength indepedent so all items have the same value

The stored tables for Mueller matrix coefficients produced by the functions in this module have two axes (wavelength and scattering angle) and four quantities, one for each Mueller matrix coefficient. Because the Mueller matrix coefficients are always used relative to the first coefficient, their values are provided in arbitrary units. We use IAU convebtions for the signs of the coefficients.

Function Documentation

convertMeanDraineLiOpticalProps()

def pts.storedtable.convert_singlegrain.convertMeanDraineLiOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function converts the column text data for the single-grain MeanDraineLiDustMix to stored table format.

The function expects a single input file path and a single output file path. Refer to the notes in the input directory for more information on the data format.

convertMeanInterstellarOpticalProps()

def pts.storedtable.convert_singlegrain.convertMeanInterstellarOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function converts the column text data for the single-grain MeanInterstellarDustMix to stored table format.

The function expects a single input file path and a single output file path. Refer to the notes in the input directory for more information on the data format.

convertMeanPascucciBenchmarkOpticalProps()

def pts.storedtable.convert_singlegrain.convertMeanPascucciBenchmarkOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function converts the column text data for the single-grain MeanPascucciBenchmarkDustMix to stored table format.

The function expects a single input file path and a single output file path. Refer to the notes in the input directory for more information on the data format.

convertMeanPinteBenchmarkMuellerMatrix()

def pts.storedtable.convert_singlegrain.convertMeanPinteBenchmarkMuellerMatrix	(		inFilePaths,
			outFilePaths
	)

This function converts the column text file with Mueller matrix coefficients for the single-grain MeanPolarizedPinteBenchmarkDustMix to stored table format.

The function expects a single input file path and a single output file path. The input file contains data for just a single wavelength (1 micron). To enable the regular interpolation scheme in SKIRT, we actually put three wavelengths (with the same data) at the extreme ends of the wavelength range in the stored table. Refer to the notes in the input directory for more information on the data format.

convertMeanPinteBenchmarkOpticalProps()

def pts.storedtable.convert_singlegrain.convertMeanPinteBenchmarkOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function converts the column text file with basic optical properties for the single-grain MeanPinteBenchmarkDustMix to stored table format.

The function expects a single input file path and a single output file path. Refer to the notes in the input directory for more information on the data format.

convertMeanTrustBenchmarkMuellerMatrix()

def pts.storedtable.convert_singlegrain.convertMeanTrustBenchmarkMuellerMatrix	(		inFilePaths,
			outFilePaths
	)

This function converts the set of column text files with Mueller matrix coefficients for the single-grain MeanPolarizedTrustBenchmarkDustMix to stored table format.

The function expects a single input file path and a single output file path. The input file path is actually interpreted as a template where the asterisk is replaced by the appropriate code for the scattering angle theta. Refer to the notes in the input directory for more information on the data format.

convertMeanTrustBenchmarkOpticalProps()

def pts.storedtable.convert_singlegrain.convertMeanTrustBenchmarkOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function converts the column text file with basic optical properties for the single-grain MeanTrustBenchmarkDustMix to stored table format.

The function expects a single input file path and a single output file path. Refer to the notes in the input directory for more information on the data format.

convertMeanZubkoOpticalProps()

def pts.storedtable.convert_singlegrain.convertMeanZubkoOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function converts the column text data for the single-grain MeanZubkoDustMix to stored table format.

The function expects a single input file path and a single output file path. Refer to the notes in the input directory for more information on the data format.

createMeanIvezicBenchmarkOpticalProps()

def pts.storedtable.convert_singlegrain.createMeanIvezicBenchmarkOpticalProps	(		inFilePaths,
			outFilePaths
	)

This function creates the power-laws for the single-grain MeanIvezicBenchmarkDustMix in stored table format.

The function expects no input file path (because the output is analytically generated) and a single output file path. Refer to the notes in the input directory for more information.