LSSTApplications  18.0.0+106,18.0.0+50,19.0.0,19.0.0+1,19.0.0+10,19.0.0+11,19.0.0+13,19.0.0+17,19.0.0+2,19.0.0-1-g20d9b18+6,19.0.0-1-g425ff20,19.0.0-1-g5549ca4,19.0.0-1-g580fafe+6,19.0.0-1-g6fe20d0+1,19.0.0-1-g7011481+9,19.0.0-1-g8c57eb9+6,19.0.0-1-gb5175dc+11,19.0.0-1-gdc0e4a7+9,19.0.0-1-ge272bc4+6,19.0.0-1-ge3aa853,19.0.0-10-g448f008b,19.0.0-12-g6990b2c,19.0.0-2-g0d9f9cd+11,19.0.0-2-g3d9e4fb2+11,19.0.0-2-g5037de4,19.0.0-2-gb96a1c4+3,19.0.0-2-gd955cfd+15,19.0.0-3-g2d13df8,19.0.0-3-g6f3c7dc,19.0.0-4-g725f80e+11,19.0.0-4-ga671dab3b+1,19.0.0-4-gad373c5+3,19.0.0-5-ga2acb9c+2,19.0.0-5-gfe96e6c+2,w.2020.01
LSSTDataManagementBasePackage
Public Member Functions | Public Attributes | Friends | List of all members
lsst::jointcal::Frame Class Reference

rectangle with sides parallel to axes. More...

#include <Frame.h>

Public Member Functions

 Frame ()
 Default constructor. More...
 
 Frame (double xMin, double yMin, double xMax, double yMax)
 this one is dangerous: you may swap the 2 middle arguments. More...
 
 Frame (const Point &lowerLeft, const Point &upperRight)
 typical use: Frame(Point(xmin,ymin),Point(xmax,ymax)) More...
 
double getWidth () const
 size along x axis More...
 
double getHeight () const
 size along y axis More...
 
Point getCenter () const
 Center of the frame. More...
 
Frame operator* (const Frame &right) const
 intersection of Frame's. More...
 
Frameoperator*= (const Frame &right)
 intersection of Frame's More...
 
Frame operator+ (const Frame &right) const
 union of Frames More...
 
Frameoperator+= (const Frame &right)
 union of Frames More...
 
void cutMargin (const double marginSize)
 shrinks the frame (if marginSize>0), enlarges it (if marginSize<0). More...
 
void cutMargin (const double marginX, const double marginY)
 shrinks the frame (if marginSize>0), enlarges it (if marginSize<0). More...
 
bool operator== (const Frame &right) const
 necessary for comparisons (!= is defined from this one implicitely) More...
 
bool operator!= (const Frame &right) const
 comparison More...
 
Frame rescale (const double factor) const
 rescale it. The center does not move. More...
 
double getArea () const
 
bool inFrame (double x, double y) const
 inside? More...
 
bool inFrame (const Point &point) const
 same as above More...
 
double minDistToEdges (const Point &point) const
 distance to closest boundary. More...
 
void dump (std::ostream &stream=std::cout) const
 

Public Attributes

double xMin
 coordinate of boundary. More...
 
double xMax
 
double yMin
 
double yMax
 

Friends

std::ostreamoperator<< (std::ostream &stream, const Frame &right)
 allows More...
 

Detailed Description

rectangle with sides parallel to axes.

when Frame's are used to define subparts of images, xMin and xMax refer to the first and last pixels in the subimage

Definition at line 38 of file Frame.h.

Constructor & Destructor Documentation

◆ Frame() [1/3]

lsst::jointcal::Frame::Frame ( )

Default constructor.

Definition at line 46 of file Frame.cc.

46 { xMin = xMax = yMin = yMax = 0; }
double xMin
coordinate of boundary.
Definition: Frame.h:41

◆ Frame() [2/3]

lsst::jointcal::Frame::Frame ( double  xMin,
double  yMin,
double  xMax,
double  yMax 
)

this one is dangerous: you may swap the 2 middle arguments.

Prefer next one

Definition at line 39 of file Frame.cc.

39  {
40  xMin = min(xmin, xmax);
41  xMax = max(xmin, xmax);
42  yMin = min(ymin, ymax);
43  yMax = max(ymin, ymax);
44 }
int xmax
Definition: SpanSet.cc:49
double xMin
coordinate of boundary.
Definition: Frame.h:41
int min
int max
int xmin
Definition: SpanSet.cc:49

◆ Frame() [3/3]

lsst::jointcal::Frame::Frame ( const Point lowerLeft,
const Point upperRight 
)

typical use: Frame(Point(xmin,ymin),Point(xmax,ymax))

Definition at line 35 of file Frame.cc.

35  {
36  *this = Frame(lowerLeft.x, lowerLeft.y, upperRight.x, upperRight.y);
37 }
Frame()
Default constructor.
Definition: Frame.cc:46

Member Function Documentation

◆ cutMargin() [1/2]

void lsst::jointcal::Frame::cutMargin ( const double  marginSize)

shrinks the frame (if marginSize>0), enlarges it (if marginSize<0).

Definition at line 108 of file Frame.cc.

108 { cutMargin(marginSize, marginSize); }
void cutMargin(const double marginSize)
shrinks the frame (if marginSize>0), enlarges it (if marginSize<0).
Definition: Frame.cc:108

◆ cutMargin() [2/2]

void lsst::jointcal::Frame::cutMargin ( const double  marginX,
const double  marginY 
)

shrinks the frame (if marginSize>0), enlarges it (if marginSize<0).

Definition at line 101 of file Frame.cc.

101  {
102  xMin += marginX;
103  yMin += marginY;
104  xMax -= marginX;
105  yMax -= marginY;
106 }
double xMin
coordinate of boundary.
Definition: Frame.h:41

◆ dump()

void lsst::jointcal::Frame::dump ( std::ostream stream = std::cout) const

Definition at line 124 of file Frame.cc.

124  {
125  stream << "xmin ymin " << xMin << ' ' << yMin << " xmax ymax " << xMax << ' ' << yMax << endl;
126 }
T endl(T... args)
double xMin
coordinate of boundary.
Definition: Frame.h:41

◆ getArea()

double lsst::jointcal::Frame::getArea ( ) const

Definition at line 118 of file Frame.cc.

118 { return fabs((xMax - xMin) * (yMax - yMin)); }
double xMin
coordinate of boundary.
Definition: Frame.h:41
T fabs(T... args)

◆ getCenter()

Point lsst::jointcal::Frame::getCenter ( ) const
inline

Center of the frame.

Definition at line 60 of file Frame.h.

60 { return Point((xMax + xMin) * 0.5, (yMax + yMin) * 0.5); }
double xMin
coordinate of boundary.
Definition: Frame.h:41

◆ getHeight()

double lsst::jointcal::Frame::getHeight ( ) const
inline

size along y axis

Definition at line 57 of file Frame.h.

57 { return yMax - yMin; }

◆ getWidth()

double lsst::jointcal::Frame::getWidth ( ) const
inline

size along x axis

Definition at line 54 of file Frame.h.

54 { return xMax - xMin; }
double xMin
coordinate of boundary.
Definition: Frame.h:41

◆ inFrame() [1/2]

bool lsst::jointcal::Frame::inFrame ( double  x,
double  y 
) const

inside?

Definition at line 120 of file Frame.cc.

120  {
121  return ((x <= xMax) && (y <= yMax) && (x >= xMin) && (y >= yMin));
122 }
int y
Definition: SpanSet.cc:49
double xMin
coordinate of boundary.
Definition: Frame.h:41
double x

◆ inFrame() [2/2]

bool lsst::jointcal::Frame::inFrame ( const Point point) const
inline

same as above

Definition at line 96 of file Frame.h.

96 { return inFrame(point.x, point.y); }
bool inFrame(double x, double y) const
inside?
Definition: Frame.cc:120

◆ minDistToEdges()

double lsst::jointcal::Frame::minDistToEdges ( const Point point) const

distance to closest boundary.

Definition at line 49 of file Frame.cc.

49  {
50  return min(min(point.x - xMin, xMax - point.x) /* minx */,
51  min(point.y - yMin, yMax - point.y) /* miny */);
52 }
double xMin
coordinate of boundary.
Definition: Frame.h:41
int min

◆ operator!=()

bool lsst::jointcal::Frame::operator!= ( const Frame right) const
inline

comparison

Definition at line 84 of file Frame.h.

84 { return !(*this == right); }
T right(T... args)

◆ operator*()

Frame lsst::jointcal::Frame::operator* ( const Frame right) const

intersection of Frame's.

Definition at line 54 of file Frame.cc.

54  {
55  Frame result = *this;
56  result *= right;
57  return result;
58 }
T right(T... args)
Frame()
Default constructor.
Definition: Frame.cc:46
py::object result
Definition: _schema.cc:429

◆ operator*=()

Frame & lsst::jointcal::Frame::operator*= ( const Frame right)

intersection of Frame's

Definition at line 60 of file Frame.cc.

60  {
61  Frame rightCopy = right;
62  // make sure that coordinates are properly ordered
63  order();
64  rightCopy.order();
65  xMin = max(xMin, rightCopy.xMin);
66  xMax = min(xMax, right.xMax);
67  yMin = max(yMin, right.yMin);
68  yMax = min(yMax, right.yMax);
69  // check for an actual overlap. Why was this check added?
70  if (xMin > xMax || yMin > yMax) *this = Frame();
71  return *this;
72 }
T right(T... args)
double xMin
coordinate of boundary.
Definition: Frame.h:41
Frame()
Default constructor.
Definition: Frame.cc:46
int min
int max

◆ operator+()

Frame lsst::jointcal::Frame::operator+ ( const Frame right) const

union of Frames

Definition at line 74 of file Frame.cc.

74  {
75  Frame result = *this;
76  result += right;
77  return result;
78 }
T right(T... args)
Frame()
Default constructor.
Definition: Frame.cc:46
py::object result
Definition: _schema.cc:429

◆ operator+=()

Frame & lsst::jointcal::Frame::operator+= ( const Frame right)

union of Frames

Definition at line 80 of file Frame.cc.

80  {
81  Frame rightCopy = right;
82  // make sure that coordinates are properly ordered
83  order();
84  rightCopy.order();
85  xMin = min(xMin, rightCopy.xMin);
86  xMax = max(xMax, right.xMax);
87  yMin = min(yMin, right.yMin);
88  yMax = max(yMax, right.yMax);
89  return *this;
90 }
T right(T... args)
double xMin
coordinate of boundary.
Definition: Frame.h:41
Frame()
Default constructor.
Definition: Frame.cc:46
int min
int max

◆ operator==()

bool lsst::jointcal::Frame::operator== ( const Frame right) const

necessary for comparisons (!= is defined from this one implicitely)

Definition at line 97 of file Frame.cc.

97  {
98  return ((xMin == right.xMin) && (xMax == right.xMax) && (yMin == right.yMin) && (yMax == right.yMax));
99 }
T right(T... args)
double xMin
coordinate of boundary.
Definition: Frame.h:41

◆ rescale()

Frame lsst::jointcal::Frame::rescale ( const double  factor) const

rescale it. The center does not move.

Definition at line 110 of file Frame.cc.

110  {
111  double hxsize = fabs(factor * 0.5 * (xMax - xMin));
112  double xcenter = 0.5 * (xMax + xMin);
113  double hysize = fabs(factor * 0.5 * (yMax - yMin));
114  double ycenter = 0.5 * (yMax + yMin);
115  return Frame(xcenter - hxsize, ycenter - hysize, xcenter + hxsize, ycenter + hysize);
116 }
double xMin
coordinate of boundary.
Definition: Frame.h:41
Frame()
Default constructor.
Definition: Frame.cc:46
T fabs(T... args)

Friends And Related Function Documentation

◆ operator<<

std::ostream& operator<< ( std::ostream stream,
const Frame right 
)
friend

allows

std::cout << frame; 

.

Definition at line 104 of file Frame.h.

104  {
105  right.dump(stream);
106  return stream;
107  };
T right(T... args)

Member Data Documentation

◆ xMax

double lsst::jointcal::Frame::xMax

Definition at line 41 of file Frame.h.

◆ xMin

double lsst::jointcal::Frame::xMin

coordinate of boundary.

Definition at line 41 of file Frame.h.

◆ yMax

double lsst::jointcal::Frame::yMax

Definition at line 41 of file Frame.h.

◆ yMin

double lsst::jointcal::Frame::yMin

Definition at line 41 of file Frame.h.


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