Create an empty MeasurementSet from observation and telescope descriptions. More...

#include <NewMSSimulator.h>

Public Member Functions
	NewMSSimulator (const String &)
	Constructor from name only. More...

	NewMSSimulator (MeasurementSet &)
	Constructor from existing MS. More...

	NewMSSimulator (const NewMSSimulator &mss)
	Copy constructor - for completeness only. More...

	~NewMSSimulator ()

NewMSSimulator &	operator= (const NewMSSimulator &)
	Assignment. More...

void	setMaxData (const Double maxData=2e9)
	Set maximum amount of data (bytes) to be written into any one scratch column hypercube. More...

void	initAnt (const String &telname, const Vector< Double > &x, const Vector< Double > &y, const Vector< Double > &z, const Vector< Double > &dishDiameter, const Vector< Double > &offset, const Vector< String > &mount, const Vector< String > &name, const Vector< String > &padname, const String &coordsystem, const MPosition &mRefLocation)
	set the antenna and array data. More...

bool	getAnt (String &telescope, Int &nAnt, Matrix< Double > *antXYZ, Vector< Double > &antDiam, Vector< Double > &offset, Vector< String > &mount, Vector< String > &name, Vector< String > &padname, String &coordsystem, MPosition &mRefLocation)
	get the info back More...

void	initFields (const String &sourceName, const MDirection &sourceDirection, const String &calCode)
	set the observed fields More...

bool	getFields (Int &nField, Vector< String > &sourceName, Vector< MDirection > &sourceDirection, Vector< String > &calCode)

void	initFeeds (const String &mode)
	set the Feeds; brain dead version More...

bool	getFeedMode (String &mode)

void	initFeeds (const String &mode, const Vector< Double > &x, const Vector< Double > &y, const Vector< String > &pol)
	set the Feeds; Smart version More...

void	initSpWindows (const String &spWindowName, const Int &nChan, const Quantity &startFreq, const Quantity &freqInc, const Quantity &freqRes, const MFrequency::Types &freqType, const String &stokesString)
	set the spectral windows information More...

bool	getSpWindows (Int &nSpw, Vector< String > &spWindowName, Vector< Int > &nChan, Vector< Quantity > &startFreq, Vector< Quantity > &freqInc, Vector< String > &stokesString)

void	setFractionBlockageLimit (const Double fraclimit)

void	setElevationLimit (const Quantity &ellimit)

void	setAutoCorrelationWt (const Float autocorrwt)

void	settimes (const Quantity &qIntegrationTime, const Bool useHourAngles, const MEpoch &mRefTime)

void	observe (const String &sourceName, const String &spWindowName, const Quantity &qStartTime, const Quantity &qStopTime, const Bool add_observation=True, const Bool state_sig=True, const Bool state_ref=True, const double &state_cal=0., const double &state_load=0., const unsigned int state_sub_scan=1, const String &state_obs_mode="OBSERVE_TARGET.ON_SOURCE", const String &observername="CASA simulator", const String &projectname="CASA simulation")

void	observe (const Vector< String > &sourceNames, const String &spWindowName, const Vector< Quantity > &qStartTimes, const Vector< Quantity > &qStopTimes, const Vector< MDirection > &directions, const Bool add_observation=True, const Bool state_sig=True, const Bool state_ref=True, const double &state_cal=0., const double &state_load=0., const unsigned int state_sub_scan=1, const String &state_obs_mode="OBSERVE_TARGET.ON_SOURCE", const String &observername="CASA simulator", const String &projectname="CASA simulation")

casacore::CountedPtr < MeasurementSet >	getMs () const

Private Member Functions
	NewMSSimulator ()
	Prevent use of default constructor. More...

void	local2global (Vector< Double > &xReturned, Vector< Double > &yReturned, Vector< Double > &zReturned, const MPosition &mRefLocation, const Vector< Double > &xIn, const Vector< Double > &yIn, const Vector< Double > &zIn)

void	longlat2global (Vector< Double > &xReturned, Vector< Double > &yReturned, Vector< Double > &zReturned, const MPosition &mRefLocation, const Vector< Double > &xIn, const Vector< Double > &yIn, const Vector< Double > &zIn)

void	blockage (Double &fraction1, Double &fraction2, const Vector< Double > &uvw, const Double diam1, const Double diam2)
	Returns the fractional blockage of one antenna by another We will want to put this somewhere else eventually, but I don't yet know where! Till then. More...

String	formatDirection (const MDirection &)

String	formatTime (const Double)

void	addHyperCubes (const Int id, const Int nBase, const Int nChan, const Int nCorr)

void	defaults ()

Bool	calcAntUVW (MEpoch &epoch, MDirection &refdir, Matrix< Double > &uvwAnt)

Detailed Description

Create an empty MeasurementSet from observation and telescope descriptions.

Prerequisite

MeasurementSet

Etymology

MS is from MeasurementSet, Simulator refers to the generation of 'fake' data from a set of parameters for instrument and sources.

Synopsis

This class creates a MeasurementSet from a set of parameters for instrument and sources. It does not simulate the data, only the coordinates of a measurement. The application "simulator" uses this class to create a true simulated MS with perfect or corrupted data.

Motivation

To test calibration and imaging programs it is necessary to have flawless data and data with errors that are known exactly. This class generates empty MeasurementSets (only coordinates filled in) that can be filled with predicted data.

To Do

The amount of information to be specified by the user could be much larger. For the moment it has been restricted to what is needed for testing the synthesis imaging code. Already it is possible to create MeasurementSets that cannot be processed yet.

Definition at line 90 of file NewMSSimulator.h.

Constructor & Destructor Documentation

casacore::NewMSSimulator::NewMSSimulator ( const String & )

Constructor from name only.

casacore::NewMSSimulator::NewMSSimulator ( MeasurementSet & )

Constructor from existing MS.

casacore::NewMSSimulator::NewMSSimulator ( const NewMSSimulator & mss )

Copy constructor - for completeness only.

casacore::NewMSSimulator::~NewMSSimulator ( )

casacore::NewMSSimulator::NewMSSimulator ( )

inlineprivate

Prevent use of default constructor.

Definition at line 223 of file NewMSSimulator.h.

Member Function Documentation

void casacore::NewMSSimulator::addHyperCubes	(	const Int	id,
		const Int	nBase,
		const Int	nChan,
		const Int	nCorr
	)

private

void casacore::NewMSSimulator::blockage	(	Double &	fraction1,
		Double &	fraction2,
		const Vector< Double > &	uvw,
		const Double	diam1,
		const Double	diam2
	)

private

Returns the fractional blockage of one antenna by another We will want to put this somewhere else eventually, but I don't yet know where! Till then.

fraction1: fraction of antenna 1 that is blocked by 2 fraction2: fraction of antenna 2 that is blocked by 1 hint: at least one of the two will be 0.0

Bool casacore::NewMSSimulator::calcAntUVW	(	MEpoch &	epoch,
		MDirection &	refdir,
		Matrix< Double > &	uvwAnt
	)

private

void casacore::NewMSSimulator::defaults ( )

private

String casacore::NewMSSimulator::formatDirection ( const MDirection & )

private

String casacore::NewMSSimulator::formatTime ( const Double )

private

bool casacore::NewMSSimulator::getAnt	(	String &	telescope,
		Int &	nAnt,
		Matrix< Double > *	antXYZ,
		Vector< Double > &	antDiam,
		Vector< Double > &	offset,
		Vector< String > &	mount,
		Vector< String > &	name,
		Vector< String > &	padname,
		String &	coordsystem,
		MPosition &	mRefLocation
	)

get the info back

bool casacore::NewMSSimulator::getFeedMode ( String & mode )

bool casacore::NewMSSimulator::getFields	(	Int &	nField,
		Vector< String > &	sourceName,
		Vector< MDirection > &	sourceDirection,
		Vector< String > &	calCode
	)

casacore::CountedPtr<MeasurementSet> casacore::NewMSSimulator::getMs ( ) const

bool casacore::NewMSSimulator::getSpWindows	(	Int &	nSpw,
		Vector< String > &	spWindowName,
		Vector< Int > &	nChan,
		Vector< Quantity > &	startFreq,
		Vector< Quantity > &	freqInc,
		Vector< String > &	stokesString
	)

void casacore::NewMSSimulator::initAnt	(	const String &	telname,
		const Vector< Double > &	x,
		const Vector< Double > &	y,
		const Vector< Double > &	z,
		const Vector< Double > &	dishDiameter,
		const Vector< Double > &	offset,
		const Vector< String > &	mount,
		const Vector< String > &	name,
		const Vector< String > &	padname,
		const String &	coordsystem,
		const MPosition &	mRefLocation
	)

set the antenna and array data.

These are written immediately to the existing MS. The same model is used for the other init infor.

void casacore::NewMSSimulator::initFeeds ( const String & mode )

set the Feeds; brain dead version

void casacore::NewMSSimulator::initFeeds	(	const String &	mode,
		const Vector< Double > &	x,
		const Vector< Double > &	y,
		const Vector< String > &	pol
	)

set the Feeds; Smart version

void casacore::NewMSSimulator::initFields	(	const String &	sourceName,
		const MDirection &	sourceDirection,
		const String &	calCode
	)

set the observed fields

void casacore::NewMSSimulator::initSpWindows	(	const String &	spWindowName,
		const Int &	nChan,
		const Quantity &	startFreq,
		const Quantity &	freqInc,
		const Quantity &	freqRes,
		const MFrequency::Types &	freqType,
		const String &	stokesString
	)

set the spectral windows information

void casacore::NewMSSimulator::local2global	(	Vector< Double > &	xReturned,
		Vector< Double > &	yReturned,
		Vector< Double > &	zReturned,
		const MPosition &	mRefLocation,
		const Vector< Double > &	xIn,
		const Vector< Double > &	yIn,
		const Vector< Double > &	zIn
	)

private

void casacore::NewMSSimulator::longlat2global	(	Vector< Double > &	xReturned,
		Vector< Double > &	yReturned,
		Vector< Double > &	zReturned,
		const MPosition &	mRefLocation,
		const Vector< Double > &	xIn,
		const Vector< Double > &	yIn,
		const Vector< Double > &	zIn
	)

private

void casacore::NewMSSimulator::observe	(	const String &	sourceName,
		const String &	spWindowName,
		const Quantity &	qStartTime,
		const Quantity &	qStopTime,
		const Bool	add_observation = `True`,
		const Bool	state_sig = `True`,
		const Bool	state_ref = `True`,
		const double &	state_cal = `0.`,
		const double &	state_load = `0.`,
		const unsigned int	state_sub_scan = `1`,
		const String &	state_obs_mode = `"OBSERVE_TARGET.ON_SOURCE"`,
		const String &	observername = `"CASA simulator"`,
		const String &	projectname = `"CASA simulation"`
	)

void casacore::NewMSSimulator::observe	(	const Vector< String > &	sourceNames,
		const String &	spWindowName,
		const Vector< Quantity > &	qStartTimes,
		const Vector< Quantity > &	qStopTimes,
		const Vector< MDirection > &	directions,
		const Bool	add_observation = `True`,
		const Bool	state_sig = `True`,
		const Bool	state_ref = `True`,
		const double &	state_cal = `0.`,
		const double &	state_load = `0.`,
		const unsigned int	state_sub_scan = `1`,
		const String &	state_obs_mode = `"OBSERVE_TARGET.ON_SOURCE"`,
		const String &	observername = `"CASA simulator"`,
		const String &	projectname = `"CASA simulation"`
	)

NewMSSimulator& casacore::NewMSSimulator::operator= ( const NewMSSimulator & )

Assignment.

void casacore::NewMSSimulator::setAutoCorrelationWt ( const Float autocorrwt )

inline

Definition at line 176 of file NewMSSimulator.h.

References autoCorrelationWt_p.

void casacore::NewMSSimulator::setElevationLimit ( const Quantity & ellimit )

inline

Definition at line 173 of file NewMSSimulator.h.

References elevationLimit_p.

void casacore::NewMSSimulator::setFractionBlockageLimit ( const Double fraclimit )

inline

Definition at line 170 of file NewMSSimulator.h.

References fractionBlockageLimit_p.

void casacore::NewMSSimulator::setMaxData ( const Double maxData = 2e9 )

inline

Set maximum amount of data (bytes) to be written into any one scratch column hypercube.

Definition at line 112 of file NewMSSimulator.h.

References maxData_p.

void casacore::NewMSSimulator::settimes	(	const Quantity &	qIntegrationTime,
		const Bool	useHourAngles,
		const MEpoch &	mRefTime
	)

Member Data Documentation

Float casacore::NewMSSimulator::autoCorrelationWt_p

private

Definition at line 228 of file NewMSSimulator.h.

Referenced by setAutoCorrelationWt().

TiledDataStManAccessor casacore::NewMSSimulator::dataAcc_p

private

Definition at line 243 of file NewMSSimulator.h.

Double casacore::NewMSSimulator::dataWritten_p

private

Definition at line 235 of file NewMSSimulator.h.

Quantity casacore::NewMSSimulator::elevationLimit_p

private

Definition at line 227 of file NewMSSimulator.h.

Referenced by setElevationLimit().

TiledDataStManAccessor casacore::NewMSSimulator::flagAcc_p

private

Definition at line 243 of file NewMSSimulator.h.

Double casacore::NewMSSimulator::fractionBlockageLimit_p

private

Definition at line 226 of file NewMSSimulator.h.

Referenced by setFractionBlockageLimit().

Bool casacore::NewMSSimulator::hasHyperCubes_p

private

Definition at line 237 of file NewMSSimulator.h.

Bool casacore::NewMSSimulator::hourAngleDefined_p

private

Definition at line 232 of file NewMSSimulator.h.

Int casacore::NewMSSimulator::hyperCubeID_p

private

Definition at line 236 of file NewMSSimulator.h.

Int casacore::NewMSSimulator::lastNchan_p

private

Definition at line 239 of file NewMSSimulator.h.

Int casacore::NewMSSimulator::lastSpWID_p

private

Definition at line 238 of file NewMSSimulator.h.

Double casacore::NewMSSimulator::maxData_p

private

Definition at line 245 of file NewMSSimulator.h.

Referenced by setMaxData().

MEpoch casacore::NewMSSimulator::mRefTime_p

private

Definition at line 233 of file NewMSSimulator.h.

casacore::CountedPtr<MeasurementSet> casacore::NewMSSimulator::ms_p

private

Definition at line 241 of file NewMSSimulator.h.

Quantity casacore::NewMSSimulator::qIntegrationTime_p

private

Definition at line 230 of file NewMSSimulator.h.

TiledDataStManAccessor casacore::NewMSSimulator::scratchDataAcc_p

private

Definition at line 243 of file NewMSSimulator.h.

TiledDataStManAccessor casacore::NewMSSimulator::sigmaAcc_p

private

Definition at line 243 of file NewMSSimulator.h.

Double casacore::NewMSSimulator::t_offset_p

private

Definition at line 234 of file NewMSSimulator.h.

String casacore::NewMSSimulator::telescope_p

private

Definition at line 229 of file NewMSSimulator.h.

Bool casacore::NewMSSimulator::useHourAngle_p

private

Definition at line 231 of file NewMSSimulator.h.

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

casa/casacore/ms/MSOper/NewMSSimulator.h

Private Attributes
Double	fractionBlockageLimit_p

Quantity	elevationLimit_p

Float	autoCorrelationWt_p

String	telescope_p

Quantity	qIntegrationTime_p

Bool	useHourAngle_p

Bool	hourAngleDefined_p

MEpoch	mRefTime_p

Double	t_offset_p

Double	dataWritten_p

Int	hyperCubeID_p

Bool	hasHyperCubes_p

Int	lastSpWID_p

Int	lastNchan_p

casacore::CountedPtr < MeasurementSet >	ms_p

TiledDataStManAccessor	dataAcc_p

TiledDataStManAccessor	scratchDataAcc_p

TiledDataStManAccessor	sigmaAcc_p

TiledDataStManAccessor	flagAcc_p

Double	maxData_p

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Prerequisite

Etymology

Synopsis

Motivation

To Do

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation