Represents a line annotation. More...

#include <AnnLine.h>

Inheritance diagram for casa::AnnLine:

Public Member Functions
	AnnLine (const casacore::Quantity &xPoint1, const casacore::Quantity &yPoint1, const casacore::Quantity &xPoint2, const casacore::Quantity &yPoint2, const casacore::String &dirRefFrameString, const casacore::CoordinateSystem &csys, const casacore::Quantity &beginFreq, const casacore::Quantity &endFreq, const casacore::String &freqRefFrame, const casacore::String &dopplerString, const casacore::Quantity &restfreq, const casacore::Vector< casacore::Stokes::StokesTypes > &stokes)

	AnnLine (const casacore::Quantity &xPoint1, const casacore::Quantity &yPoint1, const casacore::Quantity &xPoint2, const casacore::Quantity &yPoint2, const casacore::CoordinateSystem &csys, const casacore::Vector< casacore::Stokes::StokesTypes > &stokes)
	simplified constructor. More...

AnnLine &	operator= (const AnnLine &other)
	implicit copy constructor and destructor are fine More...

casacore::Vector < casacore::MDirection >	getEndPoints () const
	get the end point directions, transformed to the input coordinate system if necessary More...

virtual std::ostream &	print (std::ostream &os) const

Public Member Functions inherited from casa::AnnotationBase
virtual	~AnnotationBase ()

Type	getType () const

void	setLabel (const casacore::String &label)

casacore::String	getLabel () const

void	setColor (const casacore::String &color)
	`color` must either be a recognized color name or a valid rgb hex string, else an expection is thrown More...

void	setColor (const RGB &color)
	color must have three elements all with values between 0 and 255 inclusive or an exception is thrown. More...

casacore::String	getColorString () const
	returns the color name if it is recognized or its rgb hex string More...

RGB	getColor () const
	get the color associated with this object More...

void	setLineStyle (const LineStyle lineStyle)

LineStyle	getLineStyle () const

void	setLineWidth (const casacore::uInt linewidth)

casacore::uInt	getLineWidth () const

void	setSymbolSize (const casacore::uInt symbolsize)

casacore::uInt	getSymbolSize () const

void	setSymbolThickness (const casacore::uInt symbolthickness)

casacore::uInt	getSymbolThickness () const

void	setFont (const casacore::String &font)

casacore::String	getFont () const

void	setFontSize (const casacore::uInt fontsize)

casacore::uInt	getFontSize () const

void	setFontStyle (const FontStyle &fontstyle)

FontStyle	getFontStyle () const

void	setUseTex (const casacore::Bool usetex)

casacore::Bool	isUseTex () const

virtual casacore::Bool	isRegion () const
	is the object a region? More...

virtual casacore::Bool	isAnnotationOnly () const
	is the object only an annotation? Can only be false if the object is a region More...

void	setLabelColor (const casacore::String &color)
	`color` must either be a recognized color name or a valid rgb hex string, else an expection is thrown More...

void	setLabelColor (const RGB &color)
	color must have three elements all with values between 0 and 255 inclusive or an exception is thrown. More...

casacore::String	getLabelColorString () const
	returns the color name if it is recognized or its rgb hex string More...

RGB	getLabelColor () const
	get the color associated with this object's label More...

casacore::String	getLabelPosition () const
	returns one of top, bottom, left, or right. More...

void	setLabelPosition (const casacore::String &position)
	`position` must have a value in top, bottom, left, or right. More...

void	setLabelOffset (const std::vector< casacore::Int > &offset)
	`offset` must have two elements More...

std::vector< casacore::Int >	getLabelOffset () const

void	setGlobals (const casacore::Vector< Keyword > &globalKeys)
	These parameters are included at the global scope. More...

const casacore::CoordinateSystem &	getCsys () const
	get the coordinate system associated with this object. More...

Direction	getDirections () const
	DEPRECATED Please use getConvertedDirections() the pair elements have longitude as the first member and latitude as the second. More...

casacore::Vector < casacore::MFrequency >	getFrequencyLimits () const
	get the frequency limits converted to the spectral frame of the coordinate system of this object. More...

casacore::Vector < casacore::Stokes::StokesTypes >	getStokes () const
	Get the stokes for which the selection applies. More...

virtual casacore::Bool	setFrequencyLimits (const casacore::Quantity &beginFreq, const casacore::Quantity &endFreq, const casacore::String &freqRefFrame, const casacore::String &dopplerString, const casacore::Quantity &restfreq)
	if freqRefFrame=="" -> use the reference frame of the coordinate system if dopplerString=="" -> use the doppler system associated with the coordinate system if restfreq=casacore::Quantity(0, "Hz") -> use the rest frequency associated with the coordinate system Tacitly does nothing if the coordinate system has no spectral axis. More...

const casacore::Vector < casacore::MDirection > &	getConvertedDirections () const
	same as getDirections, only returns proper MDirections More...

Protected Attributes
AnnotationBase::Direction	_inputPoints

Additional Inherited Members
Public Types inherited from casa::AnnotationBase
enum	Type { LINE, VECTOR, TEXT, SYMBOL, RECT_BOX, CENTER_BOX, ROTATED_BOX, POLYGON, POLYLINE, CIRCLE, ANNULUS, ELLIPSE }

enum	Keyword { COORD, RANGE, FRAME, CORR, VELTYPE, RESTFREQ, LINEWIDTH, LINESTYLE, SYMSIZE, SYMTHICK, COLOR, FONT, FONTSIZE, FONTSTYLE, USETEX, LABEL, LABELCOLOR, LABELPOS, LABELOFF, UNKNOWN_KEYWORD, N_KEYS }

enum	LineStyle { SOLID, DASHED, DOT_DASHED, DOTTED }

enum	FontStyle { NORMAL, BOLD, ITALIC, ITALIC_BOLD }

using	RGB = std::vector< float >

using	Direction = casacore::Vector< std::pair< casacore::Quantity, casacore::Quantity > >
	The pairs have longitude as the first member and latitude as the second. More...

Static Public Member Functions inherited from casa::AnnotationBase
static LineStyle	lineStyleFromString (const casacore::String &ls)

static Type	typeFromString (const casacore::String &type)
	Given a string, return the corresponding annotation type or throw an error if the string does not correspond to an allowed type. More...

static casacore::String	typeToString (const Type type)

static casacore::String	keywordToString (const Keyword key)

static casacore::String	lineStyleToString (const LineStyle linestyle)

static FontStyle	fontStyleFromString (const casacore::String &fs)

static casacore::String	fontStyleToString (const FontStyle fs)

static casacore::String	colorToString (const RGB &color)

static void	unitInit ()
	set "pix" as valid unit. More...

static std::ostream &	print (std::ostream &os, const std::map< Keyword, casacore::String > &params)
	print a set of keyword value pairs More...

static std::ostream &	print (std::ostream &os, const LineStyle ls)
	print a line style representation More...

static std::ostream &	print (std::ostream &os, const FontStyle fs)
	print a font style representation More...

static std::ostream &	print (std::ostream &os, const Direction d)

static std::list< std::string >	colorChoices ()
	Get a list of the user-friendly color names supported. More...

Static Public Attributes inherited from casa::AnnotationBase
static const RGB	BLACK

static const RGB	BLUE

static const RGB	CYAN

static const RGB	GRAY

static const RGB	GREEN

static const RGB	MAGENTA

static const RGB	ORANGE

static const RGB	RED

static const RGB	WHITE

static const RGB	YELLOW

static const casacore::String	DEFAULT_LABEL

static const RGB	DEFAULT_COLOR

static const LineStyle	DEFAULT_LINESTYLE

static const casacore::uInt	DEFAULT_LINEWIDTH

static const casacore::uInt	DEFAULT_SYMBOLSIZE

static const casacore::uInt	DEFAULT_SYMBOLTHICKNESS

static const casacore::String	DEFAULT_FONT

static const casacore::uInt	DEFAULT_FONTSIZE

static const FontStyle	DEFAULT_FONTSTYLE

static const casacore::Bool	DEFAULT_USETEX

static const RGB	DEFAULT_LABELCOLOR

static const casacore::String	DEFAULT_LABELPOS

static const std::vector < casacore::Int >	DEFAULT_LABELOFF

static const casacore::Regex	rgbHexRegex

Protected Member Functions inherited from casa::AnnotationBase
	AnnotationBase (const Type type, const casacore::String &dirRefFrameString, const casacore::CoordinateSystem &csys, const casacore::Quantity &beginFreq, const casacore::Quantity &endFreq, const casacore::String &freqRefFrame, const casacore::String &dopplerString, const casacore::Quantity &restfreq, const casacore::Vector< casacore::Stokes::StokesTypes > &stokes)
	if `freqRefFrame` or `dopplerString` are empty, the values from the spectral coordinate of csys will be used, if one exists. More...

	AnnotationBase (const Type type, const casacore::CoordinateSystem &csys, const casacore::Vector< casacore::Stokes::StokesTypes > &stokes)
	use only if the frame of the input directions is the same as the frame of the coordinate system. More...

AnnotationBase &	operator= (const AnnotationBase &other)
	assignment operator More...

casacore::MDirection	_directionFromQuantities (const casacore::Quantity &q0, const casacore::Quantity &q1)

void	_checkAndConvertDirections (const casacore::String &origin, const Direction &dirs)

virtual void	_printPairs (std::ostream &os) const

const casacore::IPosition &	_getDirectionAxes () const

casacore::String	_printDirection (const casacore::Quantity &longitude, const casacore::Quantity &latitude) const
	direction to string, precision of 0.1 mas ra and dec in sexigesimal format, non-equatorial coords in degrees More...

void	_setParam (const Keyword k, const casacore::String &s)

casacore::MDirection::Types	_getDirectionRefFrame () const

Static Protected Member Functions inherited from casa::AnnotationBase
static void	_checkMixed (const casacore::String &origin, const Direction &dirs)

static casacore::String	_toArcsec (const casacore::Quantity &angle)
	convert angle to arcsec, precision 0.1 mas More...

static casacore::String	_toDeg (const casacore::Quantity &angle)
	convert angle to degrees, precision 0.1 mas More...

static casacore::String	_printPixel (const casacore::Double &d)
	return a string representing a pixel value, precision 1. More...

Detailed Description

Represents a line annotation.

Intended use:

Public interface

Review Status

Date Reviewed:: yyyy/mm/dd

Synopsis

Represents an ascii line annotation

Definition at line 50 of file AnnLine.h.

Constructor & Destructor Documentation

casa::AnnLine::AnnLine	(	const casacore::Quantity &	xPoint1,
		const casacore::Quantity &	yPoint1,
		const casacore::Quantity &	xPoint2,
		const casacore::Quantity &	yPoint2,
		const casacore::String &	dirRefFrameString,
		const casacore::CoordinateSystem &	csys,
		const casacore::Quantity &	beginFreq,
		const casacore::Quantity &	endFreq,
		const casacore::String &	freqRefFrame,
		const casacore::String &	dopplerString,
		const casacore::Quantity &	restfreq,
		const casacore::Vector< casacore::Stokes::StokesTypes > &	stokes
	)

casa::AnnLine::AnnLine	(	const casacore::Quantity &	xPoint1,
		const casacore::Quantity &	yPoint1,
		const casacore::Quantity &	xPoint2,
		const casacore::Quantity &	yPoint2,
		const casacore::CoordinateSystem &	csys,
		const casacore::Vector< casacore::Stokes::StokesTypes > &	stokes
	)

simplified constructor.

Direction quantities must be in the same reference frame as csys and all frequencies are valid.

Member Function Documentation

casacore::Vector<casacore::MDirection> casa::AnnLine::getEndPoints ( ) const

get the end point directions, transformed to the input coordinate system if necessary

AnnLine& casa::AnnLine::operator= ( const AnnLine & other )

implicit copy constructor and destructor are fine

virtual std::ostream& casa::AnnLine::print ( std::ostream & os ) const

virtual

Implements casa::AnnotationBase.

Member Data Documentation

AnnotationBase::Direction casa::AnnLine::_inputPoints

protected

Definition at line 90 of file AnnLine.h.

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

casa/code/imageanalysis/Annotations/AnnLine.h

Public Member Functions

Protected Attributes