#include <SolidBox.hh>

Inheritance diagram for Garfield::SolidBox:

Public Member Functions
	SolidBox (const double cx, const double cy, const double cz, const double lx, const double ly, const double lz)
	Constructor from centre and half-widths.

	SolidBox (const double cx, const double cy, const double cz, const double lx, const double ly, const double lz, const double dx, const double dy, const double dz)
	Constructor from centre, half-widths, and orientation.

	~SolidBox ()
	Destructor.

bool	IsInside (const double x, const double y, const double z) const override
	Check whether a given point is inside the solid.

bool	GetBoundingBox (double &xmin, double &ymin, double &zmin, double &xmax, double &ymax, double &zmax) const override
	Return the bounding box of the solid.

bool	IsBox () const override
	Return true if the solid is a box.

double	GetHalfLengthX () const override
	Return the half-length along x.

double	GetHalfLengthY () const override
	Return the half-length along y.

double	GetHalfLengthZ () const override
	Return the half-length along z.

void	SetHalfLengthX (const double lx)

void	SetHalfLengthY (const double ly)

void	SetHalfLengthZ (const double lz)

bool	SolidPanels (std::vector< Panel > &panels) override
	Retrieve the surface panels of the solid.

double	GetDiscretisationLevel (const Panel &panel) override
	Retrieve the discretization level of a panel.

Public Member Functions inherited from Garfield::Solid
	Solid ()=delete
	Default constructor.

	Solid (const double cx, const double cy, const double cz, const std::string &name)
	Constructor.

virtual	~Solid ()
	Destructor.

virtual bool	IsInside (const double x, const double y, const double z) const =0
	Check whether a given point is inside the solid.

virtual bool	GetBoundingBox (double &xmin, double &ymin, double &zmin, double &xmax, double &ymax, double &zmax) const =0
	Return the bounding box of the solid.

virtual bool	IsBox () const
	Return true if the solid is a box.

virtual bool	IsTube () const
	Return true if the solid is a tube.

virtual bool	IsSphere () const
	Return true if the solid is a sphere.

virtual bool	IsHole () const
	Return true if the solid is a hole.

virtual bool	IsRidge () const
	Return true if the solid is a ridge.

bool	GetCentre (double &x, double &y, double &z) const
	Retrieve the centre point of the solid.

bool	GetOrientation (double &ctheta, double &stheta, double &cphi, double &sphi) const
	Retrieve the orientation (azimuthal and polar angles) of the solid.

virtual double	GetHalfLengthX () const
	Return the half-length along x.

virtual double	GetHalfLengthY () const
	Return the half-length along y.

virtual double	GetHalfLengthZ () const
	Return the half-length along z.

virtual double	GetInnerRadius () const
	Return the inner radius.

virtual double	GetOuterRadius () const
	Return the outer radius.

virtual double	GetRadius () const
	Return the radius.

virtual double	GetLowerRadius () const
	Return the lower radius (of a hole).

virtual double	GetUpperRadius () const
	Return the upper radius (of a hole).

virtual double	GetRidgeOffset () const
	Return the x-offset of a ridge.

virtual double	GetRidgeHeight () const
	Return the height of a ridge.

unsigned int	GetId () const
	Get the ID of the solid.

virtual bool	SolidPanels (std::vector< Panel > &panels)=0
	Retrieve the surface panels of the solid.

virtual double	GetDiscretisationLevel (const Panel &panel)=0
	Retrieve the discretization level of a panel.

void	SetBoundaryPotential (const double v)
	Apply Dirichlet boundary conditions (fixed voltage).

void	SetBoundaryChargeDensity (const double q)
	Apply fixed-charge boundary conditions.

void	SetBoundaryFloat ()
	Make the potential at the surface of the solid floating.

void	SetBoundaryDielectric ()
	Make the surfaces of the solid dielectric-dielectric interfaces.

void	SetBoundaryParallelField ()

void	SetBoundaryPerpendicularField ()

BoundaryCondition	GetBoundaryConditionType () const
	Retrieve the type of boundary condition.

double	GetBoundaryPotential () const
	Retrieve the potential.

double	GetBoundaryChargeDensity () const
	Retrieve the surface charge density.

void	EnableDebugging (const bool on=true)
	Switch debugging messages on/off.

Additional Inherited Members
Public Types inherited from Garfield::Solid
enum	BoundaryCondition { Voltage = 1 , Charge , Float , Dielectric , DielectricCharge , ParallelField , PerpendicularField }

Protected Member Functions inherited from Garfield::Solid
void	ToLocal (const double x, const double y, const double z, double &u, double &v, double &w) const

void	ToGlobal (const double u, const double v, const double w, double &x, double &y, double &z) const

void	VectorToLocal (const double x, const double y, const double z, double &u, double &v, double &w)
	Transform a vector from global to local coordinates.

void	SetDirection (const double dx, const double dy, const double dz)

Protected Attributes inherited from Garfield::Solid
double	m_cX = 0.
	Centre of the solid.

double	m_cY = 0.

double	m_cZ = 0.

double	m_dX = 0.
	Direction vector.

double	m_dY = 0.

double	m_dZ = 1.

double	m_cPhi = 1.
	Azimuthal angle.

double	m_sPhi = 0.

double	m_cTheta = 1.
	Polar angle.

double	m_sTheta = 0.

std::string	m_className = "Solid"
	Class name.

bool	m_debug = false
	Debug flag.

BoundaryCondition	m_bctype = Voltage
	Type of boundary condition.

double	m_volt = 0.
	Potential at the surface.

double	m_charge = 0.
	Surface charge density.

double	m_eps = 0.
	Dielectric constant.

Detailed Description

Box.

Definition at line 10 of file SolidBox.hh.

Constructor & Destructor Documentation

◆ SolidBox() [1/2]

Garfield::SolidBox::SolidBox	(	const double	cx,
		const double	cy,
		const double	cz,
		const double	lx,
		const double	ly,
		const double	lz
	)

Constructor from centre and half-widths.

Definition at line 10 of file SolidBox.cc.

12 : Solid(cx, cy, cz, "SolidBox"), m_lX(lx), m_lY(ly), m_lZ(lz) {}

Garfield::Solid::Solid

Solid()=delete

Default constructor.

◆ SolidBox() [2/2]

Garfield::SolidBox::SolidBox	(	const double	cx,
		const double	cy,
		const double	cz,
		const double	lx,
		const double	ly,
		const double	lz,
		const double	dx,
		const double	dy,
		const double	dz
	)

Constructor from centre, half-widths, and orientation.

Definition at line 14 of file SolidBox.cc.

    : SolidBox(cx, cy, cz, lx, ly, lz) {
  SetDirection(dx, dy, dz);
}

◆ ~SolidBox()

Garfield::SolidBox::~SolidBox ( )

inline

Destructor.

Definition at line 20 of file SolidBox.hh.

20{}

Member Function Documentation

◆ GetBoundingBox()

bool Garfield::SolidBox::GetBoundingBox	(	double &	xmin,
		double &	ymin,
		double &	zmin,
		double &	xmax,
		double &	ymax,
		double &	zmax
	)		const

overridevirtual

Return the bounding box of the solid.

Implements Garfield::Solid.

Definition at line 43 of file SolidBox.cc.

                                                                              {
  if (m_cTheta == 1. && m_cPhi == 1.) {
    xmin = m_cX - m_lX;
    xmax = m_cX + m_lX;
    ymin = m_cY - m_lY;
    ymax = m_cY + m_lY;
    zmin = m_cZ - m_lZ;
    zmax = m_cZ + m_lZ;
    return true;
  }
 
  const double dd = sqrt(m_lX * m_lX + m_lY * m_lY + m_lZ * m_lZ);
  xmin = m_cX - dd;
  xmax = m_cX + dd;
  ymin = m_cY - dd;
  ymax = m_cY + dd;
  zmin = m_cZ - dd;
  zmax = m_cZ + dd;
  return true;
}

◆ GetDiscretisationLevel()

double Garfield::SolidBox::GetDiscretisationLevel ( const Panel & panel )

overridevirtual

Retrieve the discretization level of a panel.

Implements Garfield::Solid.

Definition at line 205 of file SolidBox.cc.

                                                          {
 
  // Transform the normal vector to local coordinates.
  double u = 0., v = 0., w = 0.;
  VectorToLocal(panel.a, panel.b, panel.c, u, v, w);
  // Identify the vector.
  if (u > std::max(std::abs(v), std::abs(w))) {
    return m_dis[0];
  } else if (u < -std::max(std::abs(v), std::abs(w))) {
    return m_dis[1];
  } else if (v > std::max(std::abs(u), std::abs(w))) {
    return m_dis[2];
  } else if (v < -std::max(std::abs(u), std::abs(w))) {
    return m_dis[3];
  } else if (w > std::max(std::abs(u), std::abs(v))) {
    return m_dis[4];
  } else if (w < -std::max(std::abs(u), std::abs(v))) {
    return m_dis[5];
  }
  if (m_debug) {
    std::cout << m_className << "::GetDiscretisationLevel:\n"
              << "    Found no match for the panel; return first value.\n";
  }
  return m_dis[0];
}

◆ GetHalfLengthX()

double Garfield::SolidBox::GetHalfLengthX ( ) const

inlineoverridevirtual

Return the half-length along x.

Reimplemented from Garfield::Solid.

Definition at line 27 of file SolidBox.hh.

27{ return m_lX; }

◆ GetHalfLengthY()

double Garfield::SolidBox::GetHalfLengthY ( ) const

inlineoverridevirtual

Return the half-length along y.

Reimplemented from Garfield::Solid.

Definition at line 28 of file SolidBox.hh.

28{ return m_lY; }

◆ GetHalfLengthZ()

double Garfield::SolidBox::GetHalfLengthZ ( ) const

inlineoverridevirtual

Return the half-length along z.

Reimplemented from Garfield::Solid.

Definition at line 29 of file SolidBox.hh.

29{ return m_lZ; }

◆ IsBox()

bool Garfield::SolidBox::IsBox ( ) const

inlineoverridevirtual

Return true if the solid is a box.

Reimplemented from Garfield::Solid.

Definition at line 25 of file SolidBox.hh.

25{ return true; }

◆ IsInside()

bool Garfield::SolidBox::IsInside	(	const double	x,
		const double	y,
		const double	z
	)		const

overridevirtual

Check whether a given point is inside the solid.

Implements Garfield::Solid.

Definition at line 21 of file SolidBox.cc.

                                                                            {
  // Transform the point to local coordinates.
  double u = x, v = y, w = z;
  ToLocal(x, y, z, u, v, w);
 
  // See whether the point is inside.
  if (fabs(u) > m_lX || fabs(v) > m_lY || fabs(w) > m_lZ) {
    if (m_debug) {
      std::cout << "SolidBox::IsInside: (" << x << ", " << y << ", " << z
                << ") is outside.\n";
    }
    return false;
  }
 
  if (m_debug) {
    std::cout << "SolidBox::IsInside: (" << x << ", " << y << ", " << z
              << ") is inside.\n";
  }
 
  return true;
}

◆ SetHalfLengthX()

void Garfield::SolidBox::SetHalfLengthX ( const double lx )

Definition at line 65 of file SolidBox.cc.

                                             {
  if (lx > 0.) {
    m_lX = lx;
  } else {
    std::cerr << "SolidBox::SetHalfLengthX: Half-length must be > 0.\n";
  }
}

◆ SetHalfLengthY()

void Garfield::SolidBox::SetHalfLengthY ( const double ly )

Definition at line 73 of file SolidBox.cc.

                                             {
  if (ly > 0.) {
    m_lY = ly;
  } else {
    std::cerr << "SolidBox::SetHalfLengthY: Half-length must be > 0.\n";
  }
}

◆ SetHalfLengthZ()

void Garfield::SolidBox::SetHalfLengthZ ( const double lz )

Definition at line 81 of file SolidBox.cc.

                                             {
  if (lz > 0.) {
    m_lZ = lz;
  } else {
    std::cerr << "SolidBox::SetHalfLengthZ: Half-length must be > 0.\n";
  }
}

◆ SolidPanels()

bool Garfield::SolidBox::SolidPanels ( std::vector< Panel > & panels )

overridevirtual

Retrieve the surface panels of the solid.

Implements Garfield::Solid.

Definition at line 89 of file SolidBox.cc.

                                                   {
  const auto id = GetId();
  const auto nPanels = panels.size();
  double xv0, yv0, zv0;
  double xv1, yv1, zv1;
  double xv2, yv2, zv2;
  double xv3, yv3, zv3;
  // Draw the 6 sides of the box, start with the x = xmin face.
  if (m_lY > 0 && m_lZ > 0) {
    ToGlobal(-m_lX, -m_lY, -m_lZ, xv0, yv0, zv0);
    ToGlobal(-m_lX, +m_lY, -m_lZ, xv1, yv1, zv1);
    ToGlobal(-m_lX, +m_lY, +m_lZ, xv2, yv2, zv2);
    ToGlobal(-m_lX, -m_lY, +m_lZ, xv3, yv3, zv3);
    // Colour(-m_cPhi * m_cTheta, -m_sPhi * m_cTheta, +m_sTheta, wcol);
    Panel newpanel;
    newpanel.a = -m_cPhi * m_cTheta;
    newpanel.b = -m_sPhi * m_cTheta;
    newpanel.c = +m_sTheta;
    newpanel.xv = {xv0, xv1, xv2, xv3};
    newpanel.yv = {yv0, yv1, yv2, yv3};
    newpanel.zv = {zv0, zv1, zv2, zv3};
    newpanel.colour = 0;
    newpanel.volume = id;
    panels.push_back(std::move(newpanel));
  }
  // The x = xmax face.
  if (m_lX > 0 && m_lY > 0 && m_lZ > 0) {
    ToGlobal(+m_lX, -m_lY, -m_lZ, xv0, yv0, zv0);
    ToGlobal(+m_lX, +m_lY, -m_lZ, xv1, yv1, zv1);
    ToGlobal(+m_lX, +m_lY, +m_lZ, xv2, yv2, zv2);
    ToGlobal(+m_lX, -m_lY, +m_lZ, xv3, yv3, zv3);
    Panel newpanel;
    newpanel.a = m_cPhi * m_cTheta;
    newpanel.b = m_sPhi * m_cTheta;
    newpanel.c = -m_sTheta;
    newpanel.xv = {xv0, xv1, xv2, xv3};
    newpanel.yv = {yv0, yv1, yv2, yv3};
    newpanel.zv = {zv0, zv1, zv2, zv3};
    newpanel.colour = 0;
    newpanel.volume = id;
    panels.push_back(std::move(newpanel));
  }
  // The y = ymin face.
  if (m_lX > 0 && m_lZ > 0) {
    ToGlobal(-m_lX, -m_lY, -m_lZ, xv0, yv0, zv0);
    ToGlobal(+m_lX, -m_lY, -m_lZ, xv1, yv1, zv1);
    ToGlobal(+m_lX, -m_lY, +m_lZ, xv2, yv2, zv2);
    ToGlobal(-m_lX, -m_lY, +m_lZ, xv3, yv3, zv3);
    Panel newpanel;
    newpanel.a = m_sPhi;
    newpanel.b = -m_cPhi;
    newpanel.c = 0;
    newpanel.xv = {xv0, xv1, xv2, xv3};
    newpanel.yv = {yv0, yv1, yv2, yv3};
    newpanel.zv = {zv0, zv1, zv2, zv3};
    newpanel.colour = 0;
    newpanel.volume = id;
    panels.push_back(std::move(newpanel));
  }
  // The y = ymax face.
  if (m_lX > 0 && m_lY > 0 && m_lZ > 0) {
    ToGlobal(-m_lX, +m_lY, -m_lZ, xv0, yv0, zv0);
    ToGlobal(+m_lX, +m_lY, -m_lZ, xv1, yv1, zv1);
    ToGlobal(+m_lX, +m_lY, +m_lZ, xv2, yv2, zv2);
    ToGlobal(-m_lX, +m_lY, +m_lZ, xv3, yv3, zv3);
    Panel newpanel;
    newpanel.a = -m_sPhi;
    newpanel.b = +m_cPhi;
    newpanel.c = 0;
    newpanel.xv = {xv0, xv1, xv2, xv3};
    newpanel.yv = {yv0, yv1, yv2, yv3};
    newpanel.zv = {zv0, zv1, zv2, zv3};
    newpanel.colour = 0;
    newpanel.volume = id;
    panels.push_back(std::move(newpanel));
  }
  // The z = zmin face.
  if (m_lX > 0 && m_lY > 0) {
    ToGlobal(-m_lX, -m_lY, -m_lZ, xv0, yv0, zv0);
    ToGlobal(-m_lX, +m_lY, -m_lZ, xv1, yv1, zv1);
    ToGlobal(+m_lX, +m_lY, -m_lZ, xv2, yv2, zv2);
    ToGlobal(+m_lX, -m_lY, -m_lZ, xv3, yv3, zv3);
    Panel newpanel;
    newpanel.a = -m_cPhi * m_sTheta;
    newpanel.b = -m_sPhi * m_sTheta;
    newpanel.c = -m_cTheta;
    newpanel.xv = {xv0, xv1, xv2, xv3};
    newpanel.yv = {yv0, yv1, yv2, yv3};
    newpanel.zv = {zv0, zv1, zv2, zv3};
    newpanel.colour = 0;
    newpanel.volume = id;
    panels.push_back(std::move(newpanel));
  }
  // The z = zmax face.
  if (m_lX > 0 && m_lY > 0 && m_lZ > 0) {
    ToGlobal(-m_lX, -m_lY, +m_lZ, xv0, yv0, zv0);
    ToGlobal(-m_lX, +m_lY, +m_lZ, xv1, yv1, zv1);
    ToGlobal(+m_lX, +m_lY, +m_lZ, xv2, yv2, zv2);
    ToGlobal(+m_lX, -m_lY, +m_lZ, xv3, yv3, zv3);
    Panel newpanel;
    newpanel.a = +m_cPhi * m_sTheta;
    newpanel.b = +m_sPhi * m_sTheta;
    newpanel.c = +m_cTheta;
    newpanel.xv = {xv0, xv1, xv2, xv3};
    newpanel.yv = {yv0, yv1, yv2, yv3};
    newpanel.zv = {zv0, zv1, zv2, zv3};
    newpanel.colour = 0;
    newpanel.volume = id;
    panels.push_back(std::move(newpanel));
  }
  // Done, check panel count.
  std::cout << "SolidBox::SolidPanels: " << panels.size() - nPanels
            << " panels.\n";
  return true;
}

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

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SolidBox() [1/2]

◆ SolidBox() [2/2]

◆ ~SolidBox()

Member Function Documentation

◆ GetBoundingBox()

◆ GetDiscretisationLevel()

◆ GetHalfLengthX()

◆ GetHalfLengthY()

◆ GetHalfLengthZ()

◆ IsBox()

◆ IsInside()

◆ SetHalfLengthX()

◆ SetHalfLengthY()

◆ SetHalfLengthZ()

◆ SolidPanels()