Class Sector3D

java.lang.Object
org.jlab.geom.prim.Sector3D
All Implemented Interfaces:
Face3D, Transformable, Showable
public final class Sector3D extends Object implements Face3D
A sector represented by an arc and a radial thickness. Sectors are regions of a plane bounded by two angles and two radii relative to some reference point.
Author:
jnhankins

  • Constructor Summary

    Constructors
    Constructor
    Description
    Sector3D()
    Constructs a new Sector3D such that the sector is bounded by two arcs such that the origin points of the inner and outer arcs begin at begin at (1, 0, 0) and (2, 0, 0) and end at (0, 1, 0) and (0, 2, 0) respectively.
    Sector3D(Arc3D outerArc, double dR)
    Constructs a new Sector3D from the given outer arc and the given radial thickness.
    Sector3D(Sector3D sector)
    Constructs a new Sector3D that is identical to the given sector.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    copy(Sector3D sector)
    Copies the parameters of the given sector so that this sector is identical to the given sector.
    double
    distanceFromEdge(Point3D p)
    Computes the minimum distance of the given point from the edges of this Sector3D.
    Arc3D
    innerArc()
    Constructs the inner arc of this sector.
    double
    innerRadius()
    Returns the inner radius of this sector.
    int
    intersection(Line3D line, List<Point3D> intersections)
    Finds the intersections of the given infinite line with this Face3D.
    int
    intersectionRay(Line3D line, List<Point3D> intersections)
    Finds the intersections of the given ray with this Face3D.
    int
    intersectionSegment(Line3D line, List<Point3D> intersections)
    Finds the intersections of the given line segment with this Face3D.
    boolean
    isInside(Point3D p)
    Test whether the given point is inside the area of this Sector3D.
    Vector3D
    normal()
     
    Arc3D
    outerArc()
    Returns the outer arc of this sector.
    double
    outerRadius()
    Returns the outer radius of this sector.
    Plane3D
    plane()
     
    Point3D
    point(int index)
    Returns the point from this Face3D with corresponding index.
    double
    radialThickness()
    Returns the radial thickness of this sector, that is the positive difference between the inner and outer radii.
    void
    rotateX(double angle)
    Rotates this object clockwise around the x axis.
    void
    rotateY(double angle)
    Rotates this object clockwise around the y axis.
    void
    rotateZ(double angle)
    Rotates this object clockwise around the z axis.
    void
    set(Arc3D outerArc, double dR)
    Sets the outer arc of this sector and the radial thickness.
    void
    setInnerArc(Arc3D outerArc)
    Sets the outer arc of this sector.
    void
    setRadialThickness(double dR)
    Sets the radial thickness of this sector, that is the positive difference between the inner and outer radii.
    void
    show()
    Invokes System.out.println(this).
    String
    toString()
     
    void
    translateXYZ(double dx, double dy, double dz)
    Translates this object linearly by the amounts specified.

    Methods inherited from class Object

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

  • Constructor Details

    • Sector3D

      public Sector3D()
      Constructs a new Sector3D such that the sector is bounded by two arcs such that the origin points of the inner and outer arcs begin at begin at (1, 0, 0) and (2, 0, 0) and end at (0, 1, 0) and (0, 2, 0) respectively.

      This sector is coplanar with the xy-plane. The inner and outer radius of this sector will differ by one unit. This sector has a coverage of 90 degrees.

    • Sector3D

      public Sector3D(Arc3D outerArc, double dR)
      Constructs a new Sector3D from the given outer arc and the given radial thickness.
      Parameters:
      outerArc - the outer arc
      dR - the radial thickness

    • Sector3D

      public Sector3D(Sector3D sector)
      Constructs a new Sector3D that is identical to the given sector.
      Parameters:
      sector - the sector to copy

  • Method Details

    • copy

      public void copy(Sector3D sector)
      Copies the parameters of the given sector so that this sector is identical to the given sector.
      Parameters:
      sector - the sector to copy

    • set

      public void set(Arc3D outerArc, double dR)
      Sets the outer arc of this sector and the radial thickness.
      Parameters:
      outerArc - the outer arc
      dR - the radial thickness

    • setInnerArc

      public void setInnerArc(Arc3D outerArc)
      Sets the outer arc of this sector.
      Parameters:
      outerArc - the outer arc

    • setRadialThickness

      public void setRadialThickness(double dR)
      Sets the radial thickness of this sector, that is the positive difference between the inner and outer radii.
      Parameters:
      dR - the radial thickness

    • outerArc

      public Arc3D outerArc()
      Returns the outer arc of this sector.
      Returns:
      the outer arc

    • innerArc

      public Arc3D innerArc()
      Constructs the inner arc of this sector.
      Returns:
      the inner arc.

    • radialThickness

      public double radialThickness()
      Returns the radial thickness of this sector, that is the positive difference between the inner and outer radii.
      Returns:
      the radial thickness

    • innerRadius

      public double innerRadius()
      Returns the inner radius of this sector.
      Returns:
      the inner radius

    • outerRadius

      public double outerRadius()
      Returns the outer radius of this sector.
      Returns:
      the outer radius

    • isInside

      public boolean isInside(Point3D p)
      Test whether the given point is inside the area of this Sector3D.
      Parameters:
      p - the given point
      Returns:
      true if inside or false if outside

    • distanceFromEdge

      public double distanceFromEdge(Point3D p)
      Computes the minimum distance of the given point from the edges of this Sector3D.
      Parameters:
      p - the given point
      Returns:
      the signed distance to the Sector3D edges, positive if inside or negative if outside

    • point

      public Point3D point(int index)
      Description copied from interface: Face3D
      Returns the point from this Face3D with corresponding index. If an invalid index is given, then null is returned.
      Specified by:
      point in interface Face3D
      Parameters:
      index - index of the point
      Returns:
      the point at the corresponding index, otherwise null

    • normal

      public Vector3D normal()

    • plane

      public Plane3D plane()

    • intersection

      public int intersection(Line3D line, List<Point3D> intersections)
      Description copied from interface: Face3D
      Finds the intersections of the given infinite line with this Face3D. If intersections are found they will be appended to the given list. The return value will indicate the number of intersections that were found.
      Specified by:
      intersection in interface Face3D
      Parameters:
      line - the infinite line
      intersections - the list to store the intersections in
      Returns:
      the number of intersections found

    • intersectionRay

      public int intersectionRay(Line3D line, List<Point3D> intersections)
      Description copied from interface: Face3D
      Finds the intersections of the given ray with this Face3D. If intersections are found they will be appended to the given list. The return value will indicate the number of intersections that were found.
      Specified by:
      intersectionRay in interface Face3D
      Parameters:
      line - the ray
      intersections - the list to store the intersections in
      Returns:
      the number of intersections found

    • intersectionSegment

      public int intersectionSegment(Line3D line, List<Point3D> intersections)
      Description copied from interface: Face3D
      Finds the intersections of the given line segment with this Face3D. If intersections are found they will be appended to the given list. The return value will indicate the number of intersections that were found.
      Specified by:
      intersectionSegment in interface Face3D
      Parameters:
      line - the line segment
      intersections - the list to store the intersections in
      Returns:
      the number of intersections found

    • translateXYZ

      public void translateXYZ(double dx, double dy, double dz)
      Description copied from interface: Transformable
      Translates this object linearly by the amounts specified.
      Specified by:
      translateXYZ in interface Transformable
      Parameters:
      dx - amount to translate along the x axis
      dy - amount to translate along the y axis
      dz - amount to translate along the z axis

    • rotateX

      public void rotateX(double angle)
      Description copied from interface: Transformable
      Rotates this object clockwise around the x axis.
      Specified by:
      rotateX in interface Transformable
      Parameters:
      angle - rotation angle in radians

    • rotateY

      public void rotateY(double angle)
      Description copied from interface: Transformable
      Rotates this object clockwise around the y axis.
      Specified by:
      rotateY in interface Transformable
      Parameters:
      angle - rotation angle in radians

    • rotateZ

      public void rotateZ(double angle)
      Description copied from interface: Transformable
      Rotates this object clockwise around the z axis.
      Specified by:
      rotateZ in interface Transformable
      Parameters:
      angle - rotation angle in radians

    • show

      public void show()
      Invokes System.out.println(this).
      Specified by:
      show in interface Showable

    • toString

      public String toString()
      Overrides:
      toString in class Object