casa  $Rev:20696$
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
AnnCenterBox.h
Go to the documentation of this file.
00001 //# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
00002 //# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Library General Public
00003 //# License for more details.
00004 //#
00005 //# You should have received a copy of the GNU Library General Public License
00006 //# along with this library; if not, write to the Free Software Foundation,
00007 //# Inc., 675 Massachusetts Ave, Cambridge, MA 02139, USA.
00008 //#
00009 //# Correspondence concerning AIPS++ should be addressed as follows:
00010 //#        Internet email: aips2-request@nrao.edu.
00011 //#        Postal address: AIPS++ Project Office
00012 //#                        National Radio Astronomy Observatory
00013 //#                        520 Edgemont Road
00014 //#                        Charlottesville, VA 22903-2475 USA
00015 //#
00016 
00017 #ifndef ANNOTATIONS_ANNCENTERBOX_H
00018 #define ANNOTATIONS_ANNCENTERBOX_H
00019 
00020 #include <casa/aips.h>
00021 #include <imageanalysis/Annotations/AnnRegion.h>
00022 
00023 namespace casa {
00024 
00025 // <summary>
00026 // This class represents a annotation for rectangular (in position coordinates) region specified
00027 // in an ascii region file as proposed in CAS-2285. It is specified by its center position
00028 // and side widths.
00029 // </summary>
00030 // <author>Dave Mehringer</author>
00031 // <use visibility=export>
00032 // <reviewed reviewer="" date="yyyy/mm/dd" tests="" demos="">
00033 // </reviewed>
00034 // <prerequisite>
00035 
00036 // </prerequisite>
00037 
00038 // <etymology>
00039 // Holds the specification of an annotation of a rectangular region as specified in ASCII format.
00040 // Specified by center position and widths of sides.
00041 // </etymology>
00042 
00043 // <synopsis>
00044 // This class represents an annotation of rectangular region in coordinate space specified by
00045 // center and widths of sides.
00046 // </synopsis>
00047 
00048 
00049 class AnnCenterBox: public AnnRegion {
00050 
00051 public:
00052 
00053         AnnCenterBox(
00054                 const Quantity& centerx,
00055                 const Quantity& centery,
00056                 const Quantity& xwidth,
00057                 const Quantity& ywidth,
00058                 const String& dirRefFrameString,
00059                 const CoordinateSystem& csys,
00060                 const IPosition& imShape,
00061                 const Quantity& beginFreq,
00062                 const Quantity& endFreq,
00063                 const String& freqRefFrameString,
00064                 const String& dopplerString,
00065                 const Quantity& restfreq,
00066                 const Vector<Stokes::StokesTypes> stokes,
00067                 const Bool annotationOnly
00068         );
00069 
00070         // Simplified constructor.
00071         // all frequencies are used (these can be set after construction).
00072         // centerx and centery
00073         // must be in the same frame as the csys direction coordinate.
00074         // is a region (not just an annotation), although this value can be changed after
00075         // construction.
00076         AnnCenterBox(
00077                 const Quantity& centerx,
00078                 const Quantity& centery,
00079                 const Quantity& xwidth,
00080                 const Quantity& ywidth,
00081                 const CoordinateSystem& csys,
00082                 const IPosition& imShape,
00083                 const Vector<Stokes::StokesTypes>& stokes
00084         );
00085 
00086         // implicit copy constructor and destructor are fine
00087 
00088         AnnCenterBox& operator=(const AnnCenterBox& other);
00089 
00090         MDirection getCenter() const;
00091 
00092         Vector<Quantity> getWidths() const;
00093 
00094         // get the blc and trc direction coords for the box which
00095         // have been converted to the coordinate frame specified
00096         // when the object was constructed.
00097         Vector<MDirection> getCorners() const;
00098 
00099         virtual ostream& print(ostream &os) const;
00100 
00101 private:
00102         Vector<Quantity> _widths;
00103         Vector<MDirection> _corners;
00104         Quantity _inpXCenter, _inpYCenter, _inpXWidth, _inpYWidth;
00105 
00106         void _init();
00107         void _doCorners();
00108 };
00109 
00110 }
00111 
00112 #endif /* ASCIICENTERBOXREGION_H_ */