SphericalCoords Class Reference

Description

ICoordSystem class that handles the unit translations for spherical detectors Its default units are radians for both axes.

Definition at line 69 of file CoordSystem2D.h.

Inheritance diagram for SphericalCoords:

Collaboration diagram for SphericalCoords:

Public Member Functions
	SphericalCoords (const OwningVector< IAxis > &axes, const Direction &direction, double wavelength)
	~SphericalCoords () override
std::vector< Coords >	availableUnits () const override
	Returns list of units that are available for all 2D detectors. Further units may be added by child classes. More...
std::string	axisName (size_t i_axis, Coords units=Coords::UNDEFINED) const
size_t	axisSize (size_t i_axis) const override
double	calculateMax (size_t i_axis, Coords units) const override
double	calculateMin (size_t i_axis, Coords units) const override
SphericalCoords *	clone () const override
std::vector< IAxis * >	convertedAxes (Coords units) const
IAxis *	createConvertedAxis (size_t i_axis, Coords units) const override
virtual Datafield *	createConvertedData (const Datafield &data, Coords units) const
	Creates Datafield array in converter units. More...
std::vector< IAxis * >	defaultAxes () const
Coords	defaultUnits () const override
size_t	rank () const override
virtual void	transferToCPP ()
	Used for Python overriding of clone (see swig/tweaks.py) More...

Protected Member Functions
void	addAxisData (std::string name, double min, double max, size_t nbins)
Coords	substituteDefaultUnits (Coords units) const
void	throwUnitsError (std::string method, std::vector< Coords > available) const

Protected Attributes
double	m_alpha_i
OwningVector< IAxis >	m_axes
double	m_phi_i
double	m_wavelength

Private Member Functions
	SphericalCoords (const SphericalCoords &other)
	used by clone() More...
double	calculateValue (size_t i_axis, Coords units, double value) const override
std::vector< std::map< Coords, std::string > >	createNameMaps () const override

Constructor & Destructor Documentation

SphericalCoords() [1/2]

SphericalCoords::SphericalCoords	(	const OwningVector< IAxis > &	axes,
		const Direction &	direction,
		double	wavelength
	)

Definition at line 117 of file CoordSystem2D.cpp.

    : CoordSystem2D(axes, direction, wavelength)
{
    ASSERT(axes.size() == 2);
}

References ASSERT, and OwningVector< T >::size().

Referenced by clone().

Here is the call graph for this function:

~SphericalCoords()

SphericalCoords::~SphericalCoords ( )

overridedefault

SphericalCoords() [2/2]

SphericalCoords::SphericalCoords ( const SphericalCoords &  other )

private

used by clone()

Definition at line 124 of file CoordSystem2D.cpp.

    : CoordSystem2D(other)
{
}

Member Function Documentation

addAxisData()

void CoordSystem2D::addAxisData ( std::string  name, double  min, double  max, size_t  nbins  )

protectedinherited

Definition at line 70 of file CoordSystem2D.cpp.

{
    m_axes.emplace_back(new FixedBinAxis(name, min, max, nbins));
}

References OwningVector< T >::emplace_back(), and CoordSystem2D::m_axes.

Here is the call graph for this function:

availableUnits()

std::vector< Coords > SphericalCoords::availableUnits ( ) const

overridevirtual

Returns list of units that are available for all 2D detectors. Further units may be added by child classes.

Reimplemented from CoordSystem2D.

Definition at line 136 of file CoordSystem2D.cpp.

{
    auto result = CoordSystem2D::availableUnits();
    result.push_back(Coords::QSPACE);
    return result;
}

References CoordSystem2D::availableUnits(), and QSPACE.

Here is the call graph for this function:

axisName()

std::string ICoordSystem::axisName ( size_t  i_axis, Coords  units = Coords::UNDEFINED  ) const

inherited

Definition at line 36 of file ICoordSystem.cpp.

{
    const auto& name_maps = createNameMaps();
    ASSERT(i_axis < name_maps.size());
    const auto& name_map = name_maps[i_axis];
    const auto& it = name_map.find(units == Coords::UNDEFINED ? defaultUnits() : units);
    ASSERT(it != name_map.cend());
    return it->second;
}

References ASSERT, ICoordSystem::createNameMaps(), ICoordSystem::defaultUnits(), and UNDEFINED.

Referenced by CoordSystem1D::createConvertedAxis(), and CoordSystem2D::createConvertedAxis().

Here is the call graph for this function:

axisSize()

size_t CoordSystem2D::axisSize ( size_t  i_axis ) const

overridevirtualinherited

Implements ICoordSystem.

Definition at line 93 of file CoordSystem2D.cpp.

{
    ASSERT(i_axis < rank());
    return m_axes[i_axis]->size();
}

References ASSERT, CoordSystem2D::m_axes, CoordSystem2D::rank(), and OwningVector< T >::size().

Referenced by CoordSystem2D::createConvertedAxis().

Here is the call graph for this function:

calculateMax()

double CoordSystem2D::calculateMax ( size_t  i_axis, Coords  units  ) const

overridevirtualinherited

Implements ICoordSystem.

Definition at line 84 of file CoordSystem2D.cpp.

{
    ASSERT(i_axis < rank());
    units = substituteDefaultUnits(units);
    if (units == Coords::NBINS)
        return m_axes[i_axis]->size();
    return calculateValue(i_axis, units, m_axes[i_axis]->max());
}

References ASSERT, CoordSystem2D::calculateValue(), CoordSystem2D::m_axes, NBINS, CoordSystem2D::rank(), OwningVector< T >::size(), and ICoordSystem::substituteDefaultUnits().

Referenced by CoordSystem2D::createConvertedAxis().

Here is the call graph for this function:

calculateMin()

double CoordSystem2D::calculateMin ( size_t  i_axis, Coords  units  ) const

overridevirtualinherited

Implements ICoordSystem.

Definition at line 75 of file CoordSystem2D.cpp.

{
    ASSERT(i_axis < rank());
    units = substituteDefaultUnits(units);
    if (units == Coords::NBINS)
        return 0.0;
    return calculateValue(i_axis, units, m_axes[i_axis]->min());
}

References ASSERT, CoordSystem2D::calculateValue(), CoordSystem2D::m_axes, NBINS, CoordSystem2D::rank(), and ICoordSystem::substituteDefaultUnits().

Referenced by CoordSystem2D::createConvertedAxis().

Here is the call graph for this function:

calculateValue()

double SphericalCoords::calculateValue ( size_t  i_axis, Coords  units, double  value  ) const

overrideprivatevirtual

Implements CoordSystem2D.

Definition at line 143 of file CoordSystem2D.cpp.

{
    switch (units) {
    case Coords::RADIANS:
        return value;
    case Coords::DEGREES:
        return Units::rad2deg(value);
    case Coords::QSPACE: {
        const R3 k_i = vecOfLambdaAlphaPhi(m_wavelength, m_alpha_i, m_phi_i);
        if (i_axis == 0) {
            const R3 k_f = vecOfLambdaAlphaPhi(m_wavelength, 0.0, value);
            return (k_i - k_f).y();
        }
        if (i_axis == 1) {
            const R3 k_f = vecOfLambdaAlphaPhi(m_wavelength, value, 0.0);
            return (k_f - k_i).z();
        }
        ASSERT(0);
    }
    case Coords::QXQY: {
        const R3 k_i = vecOfLambdaAlphaPhi(m_wavelength, m_alpha_i, m_phi_i);
        if (i_axis == 0) {
            const R3 k_f = vecOfLambdaAlphaPhi(m_wavelength, 0.0, value);
            return (k_i - k_f).y();
        }
        if (i_axis == 1) {
            const R3 k_f = vecOfLambdaAlphaPhi(m_wavelength, value, 0.0);
            return (k_f - k_i).x();
        }
        ASSERT(0);
    }
    default:
        ASSERT(0);
    }
}

References ASSERT, DEGREES, CoordSystem2D::m_alpha_i, CoordSystem2D::m_phi_i, CoordSystem2D::m_wavelength, QSPACE, QXQY, Units::rad2deg(), RADIANS, and vecOfLambdaAlphaPhi().

Here is the call graph for this function:

clone()

SphericalCoords * SphericalCoords::clone ( ) const

overridevirtual

Implements ICoordSystem.

Definition at line 131 of file CoordSystem2D.cpp.

{
    return new SphericalCoords(*this);
}

References SphericalCoords().

Here is the call graph for this function:

convertedAxes()

std::vector< IAxis * > ICoordSystem::convertedAxes ( Coords  units ) const

inherited

Definition at line 28 of file ICoordSystem.cpp.

{
    std::vector<IAxis*> result;
    for (size_t i = 0; i < rank(); ++i)
        result.emplace_back(createConvertedAxis(i, units));
    return result;
}

References ICoordSystem::createConvertedAxis(), and ICoordSystem::rank().

Referenced by ICoordSystem::defaultAxes().

Here is the call graph for this function:

createConvertedAxis()

IAxis * CoordSystem2D::createConvertedAxis ( size_t  i_axis, Coords  units  ) const

overridevirtualinherited

Implements ICoordSystem.

Definition at line 104 of file CoordSystem2D.cpp.

{
    const double min = calculateMin(i_axis, units);
    const double max = calculateMax(i_axis, units);
    const auto& axis_name = axisName(i_axis, units);
    const auto axis_size = axisSize(i_axis);
    return new FixedBinAxis(axis_name, axis_size, min, max);
}

References ICoordSystem::axisName(), CoordSystem2D::axisSize(), CoordSystem2D::calculateMax(), and CoordSystem2D::calculateMin().

Here is the call graph for this function:

createConvertedData()

Datafield * ICoordSystem::createConvertedData ( const Datafield &  data, Coords  units  ) const

virtualinherited

Creates Datafield array in converter units.

Reimplemented in CoordSystem1D.

Definition at line 46 of file ICoordSystem.cpp.

{
    std::vector<IAxis*> axes;
    for (size_t i = 0; i < rank(); ++i)
        axes.emplace_back(createConvertedAxis(i, units));
 
    Datafield* result = new Datafield(axes);
 
    result->setVector(data.flatVector());
    return result;
}

References ICoordSystem::createConvertedAxis(), Datafield::flatVector(), ICoordSystem::rank(), and Datafield::setVector().

Here is the call graph for this function:

createNameMaps()

std::vector< std::map< Coords, std::string > > SphericalCoords::createNameMaps ( ) const

overrideprivatevirtual

Implements ICoordSystem.

Definition at line 179 of file CoordSystem2D.cpp.

{
    return {DataUtils::AxisNames::sphericalAxis0, DataUtils::AxisNames::sphericalAxis1};
}

References DataUtils::AxisNames::sphericalAxis0, and DataUtils::AxisNames::sphericalAxis1.

defaultAxes()

std::vector< IAxis * > ICoordSystem::defaultAxes ( ) const

inherited

Definition at line 23 of file ICoordSystem.cpp.

{
    return convertedAxes(defaultUnits());
}

References ICoordSystem::convertedAxes(), and ICoordSystem::defaultUnits().

Referenced by SimDataPair::execSimulation().

Here is the call graph for this function:

defaultUnits()

Coords SphericalCoords::defaultUnits ( ) const

inlineoverridevirtual

Implements ICoordSystem.

Definition at line 78 of file CoordSystem2D.h.

{ return Coords::DEGREES; }

References DEGREES.

rank()

size_t CoordSystem2D::rank ( ) const

inlineoverridevirtualinherited

Implements ICoordSystem.

Definition at line 39 of file CoordSystem2D.h.

{ return m_axes.size(); }

References CoordSystem2D::m_axes, and OwningVector< T >::size().

Referenced by CoordSystem2D::axisSize(), CoordSystem2D::calculateMax(), and CoordSystem2D::calculateMin().

Here is the call graph for this function:

substituteDefaultUnits()

Coords ICoordSystem::substituteDefaultUnits ( Coords  units ) const

protectedinherited

Definition at line 69 of file ICoordSystem.cpp.

{
    return units == Coords::UNDEFINED ? defaultUnits() : units;
}

References ICoordSystem::defaultUnits(), and UNDEFINED.

Referenced by CoordSystem1D::calculateMax(), CoordSystem2D::calculateMax(), CoordSystem1D::calculateMin(), CoordSystem2D::calculateMin(), and CoordSystem1D::createConvertedAxis().

Here is the call graph for this function:

throwUnitsError()

void ICoordSystem::throwUnitsError ( std::string  method, std::vector< Coords >  available  ) const

protectedinherited

Definition at line 58 of file ICoordSystem.cpp.

{
    std::stringstream ss;
    ss << "Unit type error in " << method
       << ": unknown or unsupported unit type. Available units "
          "are:\n";
    for (auto unit : available)
        ss << axisUnitLabel.at(unit) << "\n";
    throw std::runtime_error(ss.str());
}

References axisUnitLabel.

transferToCPP()

virtual void ICloneable::transferToCPP ( )

inlinevirtualinherited

Used for Python overriding of clone (see swig/tweaks.py)

Definition at line 32 of file ICloneable.h.

Member Data Documentation

m_alpha_i

double CoordSystem2D::m_alpha_i

protectedinherited

Definition at line 58 of file CoordSystem2D.h.

Referenced by calculateValue(), and ImageCoords::calculateValue().

m_axes

OwningVector<IAxis> CoordSystem2D::m_axes

protectedinherited

Definition at line 56 of file CoordSystem2D.h.

Referenced by CoordSystem2D::addAxisData(), CoordSystem2D::axisSize(), CoordSystem2D::calculateMax(), CoordSystem2D::calculateMin(), ImageCoords::calculateValue(), and CoordSystem2D::rank().

m_phi_i

double CoordSystem2D::m_phi_i

protectedinherited

Definition at line 59 of file CoordSystem2D.h.

Referenced by calculateValue(), and ImageCoords::calculateValue().

m_wavelength

double CoordSystem2D::m_wavelength

protectedinherited

Definition at line 57 of file CoordSystem2D.h.

Referenced by calculateValue(), ImageCoords::calculateValue(), and DepthProbeCoordinates::calculateValue().

---

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

• /home/build/builds/o5h8MZZm/0/mlz/bornagain/Device/Coord/CoordSystem2D.h
• /home/build/builds/o5h8MZZm/0/mlz/bornagain/Device/Coord/CoordSystem2D.cpp