Geometry (LSST CCS - Image Utilities 1.5.2 API)

java.lang.Object
- org.lsst.ccs.geometry.Geometry<T>

Type Parameters:

T - The template of the classes that can be added to this Geometry

Direct Known Subclasses:

CCD, Raft, Reb, Segment
```
public class Geometry<T extends Geometry>
extends Object
```
Base Geometry: a rectangle inside which it is possible to add other Geometries. Note on coordinate system and dimensions. The (x,y) coordinate system refers to Java Image/Component convention. (0,0) is the upper left corner with x increasing to the right and y increasing downward. For simplicity (x,y) cannot be negative. The "width" of a Geometry is its maximum extent along the x direction and the "height" is along the y direction. A Geometry upper left corner is ALWAYS (0,0). This point will be always used when evaluating dimensions. This class is not thread safe.

Author:

turri

Field Summary

Fields
Modifier and Type Field and Description

protected int parallelChildrenCount

protected int parallelPosition

protected int serialChildrenCount

protected int serialPosition

Fields
Modifier and Type	Field and Description
`protected int`	`parallelChildrenCount`
`protected int`	`parallelPosition`
`protected int`	`serialChildrenCount`
`protected int`	`serialPosition`

Constructor Summary

Constructors
Constructor and Description
`Geometry(String name)` Create a new Geometry with no boundaries.
`Geometry(String name, int s, int p)` Create a new Geometry given a width and a height.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addChildGeometry(T child, int s, int p)` Add a child to the grid to a given position.
`protected void`	`addGeometry(T child, int x, int y)` Add a Geometry to this Geometry at a given (x,y) location.
`protected void`	`addGeometryToGrid(T child, int s, int p)`
`static void`	`convertToExpandedView(Geometry<?> geometry, boolean expandedView)` Convert this geometry to its expanded version.
`Geometry`	`findGeometry(String geometryUniqueId)` Find a Geometry by name.
`Point`	`getAbsolutePoint(Point p)`
`T`	`getChild(int s, int p)` Get child at position (s,p).
`List<T>`	`getChildrenList()` Get the list of children for this Geometry.
`Map<Geometry,Point>`	`getChildrenWithAbsoluteCoordinates()` Get the children for this Geometry.
`Dimension`	`getDimension()` Get the Dimension of this Geometry.
`Point`	`getGeometryAbsolutePosition()`
`Point`	`getGeometryPoint(Geometry geometry)` Get the location Point of a component within its parent.
`int`	`getHeight()` Get the Geometry height;
`String`	`getName()` Get the Geometry name
`int`	`getNumberOfChildren()` Get the number of children in this Geometry.
`int`	`getParallelChildrenCount()`
`int`	`getParallelPosition()`
`Geometry`	`getParent()` Get the parent of this Geometry.
`int`	`getSerialChildrenCount()`
`int`	`getSerialPosition()`
`String`	`getUniqueId()` Get this Geometry unique id.
`int`	`getWidth()` Get the Geometry width.
`boolean`	`hasChildren()` Check if this Geometry has children.
`boolean`	`hasParent()` Check if this Geometry has a Parent.
`protected void`	`setDimension(int width, int height)` Set a fixed dimension for this Geometry.
`protected void`	`setExpandedView(boolean expandedView)`
`protected void`	`setParent(Geometry parent)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - serialChildrenCount
```
protected final int serialChildrenCount
```
  - parallelChildrenCount
```
protected final int parallelChildrenCount
```
  - serialPosition
```
protected int serialPosition
```
  - parallelPosition
```
protected int parallelPosition
```
- Constructor Detail
  - Geometry
```
public Geometry(String name,
                int s,
                int p)
```
    Create a new Geometry given a width and a height. This geometry has a fixed size and it cannot be changed. Geometries must be added within its boundaries.
    
    Parameters:
    
    s - The number of allowed components in the serial direction
    
    p - The number of allowed components in the parallel direction.
    
    name - The name of this Geometry
  - Geometry
```
public Geometry(String name)
```
    Create a new Geometry with no boundaries. The dimension will be updated every time other Geometries are added.
    
    Parameters:
    
    name - The name of this Geometry
- Method Detail
  - setDimension
```
protected void setDimension(int width,
                            int height)
```
    Set a fixed dimension for this Geometry.
    
    Parameters:
    
    width - The width of this Geometry
    
    height - The height of this Geometry
  - getName
```
public String getName()
```
    Get the Geometry name
    
    Returns:
    
    The Geometry name.
  - getWidth
```
public int getWidth()
```
    Get the Geometry width.
    
    Returns:
    
    The width of the Geometry;
  - getHeight
```
public int getHeight()
```
    Get the Geometry height;
    
    Returns:
    
    The height of the Geometry;
  - getDimension
```
public Dimension getDimension()
```
    Get the Dimension of this Geometry.
    
    Returns:
    
    The Dimension of this Geometry.
  - getParent
```
public Geometry getParent()
```
    Get the parent of this Geometry. Null will be returned if this is an orphan.
    
    Returns:
    
    The parent (null if this is an orphan).
  - hasParent
```
public boolean hasParent()
```
    Check if this Geometry has a Parent.
    
    Returns:
    
    true if this Geometry has a parent.
  - setParent
```
protected final void setParent(Geometry parent)
```
  - addGeometry
```
protected void addGeometry(T child,
                           int x,
                           int y)
```
    Add a Geometry to this Geometry at a given (x,y) location. The convention is the the new Geometry upper left corner will be placed at (x,y). Child Geometries cannot be added to a Geometry that already has a parent AND does not have a fixed dimension. The reason for this choice is to simplify the logic of boundaries breaking. Coordinate x and y must be positive otherwise an exception will be thrown. If the this parent Geometry has fixed boundaries an exception will be thrown if the child Geometry to be added does not fit inside its boundaries. An exception will be thrown if the child Geometry being added already belongs to another Geometry.
    
    Parameters:
    
    child - The Geometry to be added
    
    x - The x coordinate of the child Geometry location
    
    y - The y coordinate of the child Geometry location
  - getSerialChildrenCount
```
public int getSerialChildrenCount()
```
  - getParallelChildrenCount
```
public int getParallelChildrenCount()
```
  - getSerialPosition
```
public int getSerialPosition()
```
  - getParallelPosition
```
public int getParallelPosition()
```
  - addChildGeometry
```
public void addChildGeometry(T child,
                             int s,
                             int p)
```
    Add a child to the grid to a given position.
    
    Parameters:
    
    child - The child to be added
    
    s - The serial position to add it to
    
    p - The parallel position to add it to
  - addGeometryToGrid
```
protected void addGeometryToGrid(T child,
                                 int s,
                                 int p)
```
  - getChild
```
public T getChild(int s,
                  int p)
```
    Get child at position (s,p).
    
    Parameters:
    
    s - The serial position to add it to
    
    p - The parallel position to add it to
    
    Returns:
    
    The child at the given position.
  - hasChildren
```
public boolean hasChildren()
```
    Check if this Geometry has children.
    
    Returns:
    
    true if this Geometry has children.
  - getChildrenWithAbsoluteCoordinates
```
public final Map<Geometry,Point> getChildrenWithAbsoluteCoordinates()
```
    Get the children for this Geometry. It returns a map of Geometry, Point where the Point is the location of the child Geometry in the topmost geometry.
    
    Returns:
    
    A map of Geometry, Point
  - getChildrenList
```
public final List<T> getChildrenList()
```
    Get the list of children for this Geometry.
    
    Returns:
    
    A list of children Geometry objects
  - getUniqueId
```
public final String getUniqueId()
```
    Get this Geometry unique id. This is built by going over the parents and concatenating their name separated by columns.
    
    Returns:
    
    The Geometry unique id.
  - findGeometry
```
public final Geometry findGeometry(String geometryUniqueId)
```
    Find a Geometry by name.
    
    Parameters:
    
    geometryUniqueId - The unique id of the geometry to be found.
    
    Returns:
    
    The geometry or null if the geometry is not found
  - getNumberOfChildren
```
public final int getNumberOfChildren()
```
    Get the number of children in this Geometry.
    
    Returns:
    
    the number of children in the geometry.
  - getGeometryAbsolutePosition
```
public Point getGeometryAbsolutePosition()
```
  - getAbsolutePoint
```
public Point getAbsolutePoint(Point p)
```
  - getGeometryPoint
```
public Point getGeometryPoint(Geometry geometry)
```
    Get the location Point of a component within its parent.
  - setExpandedView
```
protected void setExpandedView(boolean expandedView)
```
  - convertToExpandedView
```
public static void convertToExpandedView(Geometry<?> geometry,
                                         boolean expandedView)
```
    Convert this geometry to its expanded version. This takes into account the electronic view of segments (overscans and understans).

Class Geometry<T extends Geometry>

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

serialChildrenCount

parallelChildrenCount

serialPosition

parallelPosition

Constructor Detail

Geometry

Geometry

Method Detail

setDimension

getName

getWidth

getHeight

getDimension

getParent

hasParent

setParent

addGeometry

getSerialChildrenCount

getParallelChildrenCount

getSerialPosition

getParallelPosition

addChildGeometry

addGeometryToGrid

getChild

hasChildren

getChildrenWithAbsoluteCoordinates

getChildrenList

getUniqueId

findGeometry

getNumberOfChildren

getGeometryAbsolutePosition

getAbsolutePoint

getGeometryPoint

setExpandedView

convertToExpandedView