The SKIRT project
advanced radiative transfer for astrophysics
Public Types | Public Member Functions | Protected Member Functions | Private Types | Private Attributes | Friends | List of all members
DensityProbe Class Reference

#include <DensityProbe.hpp>

Inheritance diagram for DensityProbe:
Inheritance graph
[legend]

Public Types

enum class  Aggregation : int { Fragment , Component , Type }
 
- Public Types inherited from SpatialGridWhenFormProbe
enum class  ProbeAfter : int { Setup , Run , Primary , Secondary }
 

Public Member Functions

Aggregation aggregation () const
 
void probe () override
 
- Public Member Functions inherited from SpatialGridWhenFormProbe
ProbeAfter probeAfter () const
 
- Public Member Functions inherited from SpatialGridFormProbe
Formform () const
 
- Public Member Functions inherited from Probe
string itemName () const override
 
int iter () const
 
string probeName () const
 
void probePrimary (int iter)
 
void probeRun ()
 
void probeSecondary (int iter)
 
void probeSetup ()
 
- Public Member Functions inherited from SimulationItem
template<class T >
T * find (bool setup=true) const
 
template<class T >
T * interface (int levels=-999999, bool setup=true) const
 
virtual string itemName () const
 
void setup ()
 
string typeAndName () const
 
- Public Member Functions inherited from Item
 Item (const Item &)=delete
 
virtual ~Item ()
 
void addChild (Item *child)
 
const vector< Item * > & children () const
 
virtual void clearItemListProperty (const PropertyDef *property)
 
void destroyChild (Item *child)
 
virtual bool getBoolProperty (const PropertyDef *property) const
 
virtual vector< double > getDoubleListProperty (const PropertyDef *property) const
 
virtual double getDoubleProperty (const PropertyDef *property) const
 
virtual string getEnumProperty (const PropertyDef *property) const
 
virtual int getIntProperty (const PropertyDef *property) const
 
virtual vector< Item * > getItemListProperty (const PropertyDef *property) const
 
virtual ItemgetItemProperty (const PropertyDef *property) const
 
virtual string getStringProperty (const PropertyDef *property) const
 
int getUtilityProperty (string name) const
 
virtual void insertIntoItemListProperty (const PropertyDef *property, int index, Item *item)
 
Itemoperator= (const Item &)=delete
 
Itemparent () const
 
virtual void removeFromItemListProperty (const PropertyDef *property, int index)
 
virtual void setBoolProperty (const PropertyDef *property, bool value)
 
virtual void setDoubleListProperty (const PropertyDef *property, vector< double > value)
 
virtual void setDoubleProperty (const PropertyDef *property, double value)
 
virtual void setEnumProperty (const PropertyDef *property, string value)
 
virtual void setIntProperty (const PropertyDef *property, int value)
 
virtual void setItemProperty (const PropertyDef *property, Item *item)
 
virtual void setStringProperty (const PropertyDef *property, string value)
 
void setUtilityProperty (string name, int value)
 
virtual string type () const
 

Protected Member Functions

 DensityProbe ()
 
- Protected Member Functions inherited from SpatialGridWhenFormProbe
 SpatialGridWhenFormProbe ()
 
When when () const override
 
- Protected Member Functions inherited from SpatialGridFormProbe
 SpatialGridFormProbe ()
 
- Protected Member Functions inherited from Probe
 Probe ()
 
virtual void initialize ()
 
virtual void probe ()=0
 
virtual When when () const
 
- Protected Member Functions inherited from SimulationItem
 SimulationItem ()
 
virtual bool offersInterface (const std::type_info &interfaceTypeInfo) const
 
virtual void setupSelfAfter ()
 
virtual void setupSelfBefore ()
 
- Protected Member Functions inherited from Item
 Item ()
 

Private Types

using BaseType = SpatialGridWhenFormProbe
 
using ItemType = DensityProbe
 

Private Attributes

Aggregation _aggregation
 

Friends

class ItemRegistry
 

Additional Inherited Members

- Protected Types inherited from Probe
enum class  When { Setup , Run , Primary , Secondary }
 

Detailed Description

DensityProbe probes the density of the medium as discretized on the spatial grid of the simulation. For dust components, the probe outputs mass density, while for electron and gas components it outputs number density. The probe can be used with any Form subclass. When associated with a form that projects the quantity along a path, the probe outputs mass surface density or number surface density (column density) depending on the material type.

The user can select the aggregation level, i.e. whether to produce an output file per medium component or per medium type (dust, electrons, gas). If one or more medium components in the simulation are equipped with a FragmentDustMixDecorator, the probe can provide the mass density for each of the dust grain populations represented by the decorator. Depending on the value of the fragmentSizeBins flag on the decorator, there are fragments for each of the grain material types or even for each of the grain size bins defined by the underlying dust mixture. The probed information is written in a separate file for each fragment, identified by a zero-based fragment index in addition to the zero-based component index.

There is also an option to decide whether the probe should be performed after setup or after the full simulation run. The latter option is meaningful if the density of the media may change during the simulation.

This item type is displayed only if the Boolean expression "Medium&SpatialGrid" evaluates to true after replacing the names by true or false depending on their presence.

Member Enumeration Documentation

◆ Aggregation

enum class DensityProbe::Aggregation : int
strong

The enumeration type indicating how to aggregate the output: per medium component or per medium type (dust, electrons, gas).

Fragment : "per fragment (dust grain material type and/or size bin)" .

Component : "per medium component" .

Type : "per medium type (dust, electrons, gas)" .

Constructor & Destructor Documentation

◆ DensityProbe()

DensityProbe::DensityProbe ( )
inlineprotected

Default constructor for concrete Item subclass DensityProbe : "internal spatial grid: density of the medium" .

Member Function Documentation

◆ aggregation()

DensityProbe::aggregation ( ) const
inline

This function returns the value of the discoverable Aggregation enumeration property aggregation : "how to aggregate the density" .

The default value for this property is given by the conditional value expression "Type" .

This property is displayed only if the Boolean expression "Level2" evaluates to true after replacing the names by true or false depending on their presence.

◆ probe()

void DensityProbe::probe ( )
overridevirtual

This function performs probing.

Implements Probe.


The documentation for this class was generated from the following file: