org.lcsim.detector.material

Class MaterialMixture

java.lang.Object

org.lcsim.detector.material.MaterialElement

org.lcsim.detector.material.MaterialMixture

All Implemented Interfaces:

IMaterial

public class MaterialMixture
extends MaterialElement

This class implements the @see IMaterialMixture interface.

Version:

$Id: MaterialMixture.java,v 1.7 2010/04/14 18:24:53 jeremy Exp $

Author:

Jeremy McCormick

Nested Class Summary

Nested classes/interfaces inherited from interface org.lcsim.detector.material.IMaterial

IMaterial.State

Field Summary

Fields

Modifier and Type	Field and Description
private double	Aeff
private List<Integer>	atomCountList
private List<MaterialElement>	elementList
private List<Double>	massFractionList
static double	MAX_NUCLEAR_INTERACTION_LENGTH
static double	MAX_RADIATION_LENGTH
private int	nComponentsAdded
private int	nComponentsMax
private int	nElements
private double	Zeff

Fields inherited from class org.lcsim.detector.material.MaterialElement

A, criticalEnergy, density, moliereRadius, N, name, nuclearInteractionLength, nuclearInteractionLengthWithDensity, pressure, radiationLength, radiationLengthWithDensity, state, temperature, Z

Fields inherited from interface org.lcsim.detector.material.IMaterial

defaultIonizationPotential, defaultPressure, defaultState, defaultTemperature, Gas, Liquid, Solid, Unknown

Constructor Summary

Constructors

Constructor and Description
MaterialMixture(String name, int nComponents, double density, IMaterial.State state) Construct a material with a number of components.

Method Summary

Methods

Modifier and Type	Method and Description
void	addElement(MaterialElement element, double fraction) Add element to the material by fraction of mass.
void	addElement(MaterialElement element, int nAtoms) Add an element to the material by atom count.
void	addMaterial(MaterialMixture material, double fraction) Add material by fraction of mass.
private void	checkMassSum() Check that the massFractions list adds up to 1.0
private double	computeAeff() Compute effective A for this material using element list.
private void	computeDerivedQuantities() Caches computed quantities after all components have been added to the material.
private double	computeNuclearInteractionLengthForMixture()
private double	computeRadiationLengthForMixture() compute X0 (radiation length) based on mass fractions of elements
private double	computeZeff() Compute effective Z for this material using element list.
double	getA() Get the atomic number of this material.
List<Integer>	getAtomCounts()
List<MaterialElement>	getElements()
List<Double>	getMassFractions()
int	getNComponents()
int	getNComponentsMax()
int	getNElements()
int	getNumberOfElements()
double	getZ() Get the atomic mass of this material.
boolean	isFilled()
String	toString() Translate this material to human-readable string.

Methods inherited from class org.lcsim.detector.material.MaterialElement

computeCriticalEnergy, computeMoliereRadius, computeNuclearInteractionLength, computeNuclearInteractionLength, computeRadiationLength, computeRadiationLengthTsai, getDensity, getEffectiveNumberOfNucleons, getMoliereRadius, getName, getNuclearInteractionLength, getNuclearInteractionLengthWithDensity, getPressure, getRadiationLength, getRadiationLengthWithDensity, getState, getTemperature

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

MAX_RADIATION_LENGTH

public static final double MAX_RADIATION_LENGTH

See Also:

Constant Field Values

MAX_NUCLEAR_INTERACTION_LENGTH

public static final double MAX_NUCLEAR_INTERACTION_LENGTH

See Also:

Constant Field Values

Zeff

private double Zeff

Aeff

private double Aeff

nComponentsAdded

private int nComponentsAdded

nComponentsMax

private int nComponentsMax

nElements

private int nElements

elementList

private List<MaterialElement> elementList

massFractionList

private List<Double> massFractionList

atomCountList

private List<Integer> atomCountList

Constructor Detail

MaterialMixture

public MaterialMixture(String name,
               int nComponents,
               double density,
               IMaterial.State state)

Construct a material with a number of components.

Method Detail

getZ

public double getZ()

Description copied from interface: IMaterial

Get the atomic mass of this material.

Specified by:

getZ in interface IMaterial

Overrides:

getZ in class MaterialElement

Returns:

The atomic mass.

getA

public double getA()

Description copied from interface: IMaterial

Get the atomic number of this material.

Specified by:

getA in interface IMaterial

Overrides:

getA in class MaterialElement

Returns:

The atomic number.

getNComponentsMax

public int getNComponentsMax()

Returns:

maximum number of 1st-level (non-recursive) components that can be defined

getNComponents

public int getNComponents()

Returns:

number of components defined so far in this material

getNElements

public int getNElements()

Returns:

number of elements defined in this material

computeNuclearInteractionLengthForMixture

private double computeNuclearInteractionLengthForMixture()

Returns:

lambda (nuclear interaction length) based on mass fractions of elements

computeRadiationLengthForMixture

private double computeRadiationLengthForMixture()

compute X0 (radiation length) based on mass fractions of elements

computeDerivedQuantities

private void computeDerivedQuantities()

Caches computed quantities after all components have been added to the material.

getNumberOfElements

public int getNumberOfElements()

Returns:

total number of (unique) elements in the element list for this material

getElements

public List<MaterialElement> getElements()

Returns:

a list of elements referenced by this material

getAtomCounts

public List<Integer> getAtomCounts()

Returns:

a list of atom counts for each element

getMassFractions

public List<Double> getMassFractions()

Returns:

corresponding mass fractions for each element in the material

addElement

public void addElement(MaterialElement element,
              int nAtoms)

Add an element to the material by atom count. Based on Geant4's G4Material::AddElement() .

addElement

public void addElement(MaterialElement element,
              double fraction)

Add element to the material by fraction of mass. (out of 1.0)

addMaterial

public void addMaterial(MaterialMixture material,
               double fraction)

Add material by fraction of mass.

isFilled

public boolean isFilled()

Returns:

true if all 1st-level (non-recursive) component elements and materials have been added

checkMassSum

private void checkMassSum()

Check that the massFractions list adds up to 1.0

computeZeff

private double computeZeff()

Compute effective Z for this material using element list.

computeAeff

private double computeAeff()

Compute effective A for this material using element list.

toString

public String toString()

Translate this material to human-readable string.

Overrides:

toString in class MaterialElement