mirror of
https://github.com/gwm17/catima.git
synced 2024-11-26 12:08:52 -05:00
306 lines
9.0 KiB
C++
306 lines
9.0 KiB
C++
/*
|
|
* Author: Andrej Prochazka
|
|
* Copyright(C) 2017
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef STRUCTURES_H
|
|
#define STRUCTURES_H
|
|
|
|
#include <vector>
|
|
#include <array>
|
|
#include <initializer_list>
|
|
#include "catima/constants.h"
|
|
|
|
namespace catima{
|
|
|
|
/**
|
|
* Projectile class
|
|
* Example usage:
|
|
* \code{.cpp}
|
|
* Projectile p(12,6);
|
|
* p.T = 1000; // setting energy to 1000 MeV/u
|
|
* p(1000); // setting energy to 1000 MeV/u
|
|
* \endcode
|
|
*/
|
|
struct Projectile{
|
|
double A=0;
|
|
double Z=0;
|
|
double Q=0;
|
|
double T=0;
|
|
|
|
/// constructor
|
|
/// @param a - mass
|
|
/// @param z - proton number
|
|
/// @param q - charge state
|
|
/// @param t - energy in MeV/u
|
|
Projectile(double a, double z, double q=0, double t=0):A(a),Z(z),Q(q),T(t){if(q==0)Q=Z;}
|
|
Projectile& operator()(double e){T=e;return *this;}
|
|
Projectile() = default;
|
|
};
|
|
|
|
bool operator==(const Projectile &a, const Projectile&b);
|
|
|
|
/**
|
|
* Target class is used to store constituents of the Material class
|
|
* its just to hold A,Z data for individual atoms.
|
|
*/
|
|
struct Target{
|
|
double A=0;
|
|
int Z=0;
|
|
double stn=1.0;
|
|
};
|
|
|
|
/**
|
|
* Material
|
|
* class to store Material information
|
|
* This class defines the material with which projectile will interact.
|
|
* The class store nuclei constituents, density, thickness etc.
|
|
*/
|
|
class Material{
|
|
private:
|
|
double rho=1e-5;
|
|
double th=0;
|
|
double molar_mass=0;
|
|
double i_potential=0;
|
|
std::vector<Target>atoms;
|
|
|
|
public:
|
|
Material(){};
|
|
/**
|
|
* constructor to add 1 element into the Material, stn number of the element is set to 1.0
|
|
* @param _a - mass number of the atom, is 0 the atomic weight of element _z is taken
|
|
* @param _z - proton number of the atom
|
|
* @param _rho - density of the material in g/cm3, default 0.0
|
|
* @param _th - thickness of the material in g/cm2, default 0.0
|
|
*/
|
|
Material(double _a, int _z, double _rho=1e-5, double _th=0.0, double _ipot = 0.0);
|
|
|
|
|
|
/**
|
|
* constructor to add 1 or multiple element into the Material
|
|
* \code{.cpp}
|
|
* Maetrial water({
|
|
* {1,1,2},
|
|
* {16,8,1},
|
|
* 1.0, // optional density
|
|
* });
|
|
* \endcode
|
|
*/
|
|
Material(std::initializer_list<std::array<double,3>>list,double _density=1e-5, double ipot = 0.0, double mass=0.0);
|
|
|
|
/**
|
|
* calculates internal variables if needed
|
|
*/
|
|
void calculate();
|
|
|
|
/**
|
|
* add atom with mass number _a and proton number _z to the Material
|
|
* @param _a - mass number of the atom, is 0 the atomic weight of element _z is taken
|
|
* @param _z - proton number of the atom
|
|
* @param _stn - stoichiomatric number
|
|
*/
|
|
void add_element(double _a, int _z, double _stn);
|
|
|
|
/**
|
|
* returns i-th element of the Material as a std::pair of Target and corresponding stoichiometric number
|
|
* @param i - index of element to return
|
|
* @return Target class
|
|
*/
|
|
Target get_element(int i) const {return atoms[i];};
|
|
|
|
/**
|
|
* return weight fraction of i-th element
|
|
* @return weight fraction
|
|
*/
|
|
double weight_fraction(int i) const {return (atoms[i].stn<1.0)?atoms[i].stn:atoms[i].stn*atoms[i].A/M();};
|
|
|
|
/**
|
|
* return molar fraction of i-th element
|
|
* @return molar fraction
|
|
*/
|
|
double molar_fraction(int i) const {return (atoms[i].stn<1.0)?atoms[i].stn*M()/atoms[i].A:atoms[i].stn;};
|
|
|
|
/**
|
|
* @return number of components in Material
|
|
*/
|
|
int ncomponents() const {return atoms.size();}
|
|
|
|
/**
|
|
* @return returns Molar Mass of the Material
|
|
*/
|
|
double M() const {return molar_mass;}
|
|
|
|
/**
|
|
* sets molar mass of the Material
|
|
*/
|
|
Material& M(double mass){molar_mass=mass; return *this;}
|
|
|
|
/**
|
|
* @return returns density in g/cm^3
|
|
*/
|
|
double density() const {return rho;};
|
|
|
|
/**
|
|
* sets density in g/cm^3
|
|
*/
|
|
Material& density(double val){rho = val;return *this;};
|
|
|
|
/**
|
|
* @return returns thickness in g/cm^2
|
|
*/
|
|
double thickness() const {return th;};
|
|
|
|
/**
|
|
* @return returns thickness in cm
|
|
*/
|
|
double thickness_cm() const {return th/rho;};
|
|
|
|
/**
|
|
* sets thickness in g/cm^2
|
|
*/
|
|
Material& thickness(double val){th = val;return *this;};
|
|
|
|
/**
|
|
* set length in cm, density should be set before
|
|
*/
|
|
Material& thickness_cm(double l){th = rho*l; return *this;}
|
|
|
|
/**
|
|
* set the mean ionization potential, if non elemental I should be used
|
|
*/
|
|
Material& I(double val){i_potential = val;return *this;};
|
|
|
|
/**
|
|
* 0 if default elemental potential is used
|
|
* @return returns ionisation potential in ev
|
|
*/
|
|
double I() const {return i_potential;};
|
|
|
|
/**
|
|
* return number density of atoms/molecules per cm3 in 10^23 units
|
|
*/
|
|
double number_density()const{
|
|
return Avogadro*rho/molar_mass;
|
|
}
|
|
|
|
/**
|
|
* return number density of atoms of i-th element in 10^23 units
|
|
*/
|
|
double number_density(int i)const{
|
|
if(i>=atoms.size())return 0.0;
|
|
return number_density()*molar_fraction(i);
|
|
}
|
|
|
|
/**
|
|
* return number density of atoms/molecules per cm2 in 10^23 units
|
|
*/
|
|
double number_density_cm2()const{
|
|
return Avogadro*th/molar_mass;
|
|
}
|
|
|
|
/**
|
|
* return number density of atoms per cm2 of i-th element in 10^23 units
|
|
*/
|
|
double number_density_cm2(int i)const{
|
|
if(i>=atoms.size())return 0.0;
|
|
return number_density_cm2()*molar_fraction(i);
|
|
}
|
|
|
|
friend bool operator==(const Material &a, const Material&b);
|
|
};
|
|
|
|
bool operator==(const Material &a, const Material&b);
|
|
|
|
/**
|
|
* structure to store results for calculation per Material
|
|
*/
|
|
struct Result{
|
|
double Ein=0.0;
|
|
double Eout=0.0;
|
|
double Eloss = 0.0;
|
|
double range=0.0;
|
|
double dEdxi=0.0;
|
|
double dEdxo=0.0;
|
|
double sigma_E=0.0;
|
|
double sigma_a=0.0;
|
|
double sigma_r=0.0;
|
|
double sigma_x=0.0;
|
|
double cov = 0.0;
|
|
double tof=0.0;
|
|
#ifdef REACTIONS
|
|
double sp = 1.0;
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* structure to store results for calculation for multiple layers of materials, ie in catima::Layers
|
|
*/
|
|
struct MultiResult{
|
|
std::vector<Result> results;
|
|
Result total_result;
|
|
};
|
|
|
|
|
|
/**
|
|
* Layers
|
|
* class to store multiple material layers
|
|
*/
|
|
|
|
class Layers{
|
|
private:
|
|
std::vector<Material> materials;
|
|
public:
|
|
Layers() = default;
|
|
|
|
/**
|
|
* @return reference to the std::vector of stored Materials
|
|
*/
|
|
const std::vector<Material>& get_materials()const{return materials;}
|
|
|
|
/**
|
|
* add Material m to the Layers
|
|
* @param m Material
|
|
*/
|
|
void add(Material m);
|
|
|
|
/**
|
|
* append Layers
|
|
* @para, l Layers
|
|
*/
|
|
void add(const Layers& l);
|
|
|
|
/**
|
|
* @return number of stored Materials
|
|
*/
|
|
int num()const{return materials.size();};
|
|
|
|
/**
|
|
* @ return total thickness
|
|
*/
|
|
double thickness() const;
|
|
|
|
/**
|
|
* @ return total thickness in cm
|
|
*/
|
|
double thickness_cm() const;
|
|
|
|
Material& operator[](int i){return materials[i];}
|
|
|
|
friend Layers operator+(const Layers &a, const Layers&b);
|
|
|
|
friend Layers operator+(const Layers &a, const Material&b);
|
|
};
|
|
}
|
|
#endif
|