#include <WsfCoverageCompositeGrid.hpp>

Inheritance diagram for wsf::coverage::CompositeGrid:

[legend]

Collaboration diagram for wsf::coverage::CompositeGrid:

[legend]

Public Member Functions
	CompositeGrid (const WsfScenario &aScenario)
	CompositeGrid (const CompositeGrid &aOther)=default
	~CompositeGrid () override=default
CompositeGrid *	Clone () const override
bool	ProcessInput (UtInput &aInput) override
void	PreparePlatforms (WsfSimulation &aSimulation) override
const Point *	GetPoint (PointId aPointId) const override
std::size_t	GetSize () const override
void	Invoke (GridAction &aAction) const override
GridAsset	GetAsset (PointId aPointId) const override
GridAsset	GetAsset (const std::string &aPlatformName) const override
void	HasNullDevice (bool &aAnyNull, bool &aAllNull) const override
bool	CreatesNewPlatforms () const override
bool	IsStructured () const override
std::size_t	GetNumComponents () const override
std::string	GetComponentName (std::size_t aComponentIndex) const override
	Return the name of the specified grid component.
std::pair< std::size_t, std::size_t >	GetComponentSizes (std::size_t aComponentIndex) const override
std::pair< std::size_t, std::size_t >	GetPointIndices (PointId aPointId) const override
void	InvokeOnComponent (GridAction &aAction, std::size_t aComponentIndex) const override
Public Member Functions inherited from wsf::coverage::Grid
	Grid (const WsfScenario &aScenario)
	Grid (const Grid &aOther)=default
	~Grid () override=default
bool	ProcessInput (UtInput &aInput) override
void	SetUsedFlag ()
bool	IsUsed () const
bool	Initialize ()
void	CategorizeAssets (const WsfSimulation &aSimulation, const std::string &aCategory) const
bool	IsInitialized () const
	Return if this Grid has been initialized.
const ut::CentralBody &	GetCentralBody () const
	Return the central body to which this grid's point locations refer.
void	SetCentralBody (const ut::CentralBody &aCentralBody)
	Set the central body of this grid.
const std::string &	GetGridDataFileName () const
	Return the configured grid data file name.
bool	GetSuppressGridPlatforms () const
	Return if this grid is suppressing grid platforms.
void	SetSuppressGridPlatforms (bool aSuppress)
	Set if this grid suppresses grid platforms.
bool	WriteGridDataFile (TextOutputWriter &aWriter) const
bool	WriteGridDataFile () const
Public Member Functions inherited from WsfObject
	WsfObject ()
	This is the constructor for the WsfObject class.
	~WsfObject () override
	This is the destructor for the WsfObject class.
const char *	GetScriptClassName () const override
const std::string &	GetType () const
WsfStringId	GetTypeId () const
	Get the string ID of the 'type' of the object.
void	SetType (WsfStringId aType)
const std::string &	GetBaseType () const
WsfStringId	GetBaseTypeId () const
const TypeList &	GetTypeList () const
bool	IsA_TypeOf (WsfStringId aType) const
WsfObject &	operator= (const WsfObject &aRhs)
	Assignment operator.
template<typename T>
void	Serialize (T &aBuff)
	For XIO (de)serialization.
const std::string &	GetName () const
WsfStringId	GetNameId () const
void	SetName (WsfStringId aName)

Static Public Attributes
static constexpr const char *	cTYPE {"WSF_COMPOSITE_GRID"}

Protected Member Functions
bool	InitializeP () override
Protected Member Functions inherited from wsf::coverage::Grid
PointId	GetNextAvailableId ()
const WsfScenario &	GetScenario () const
	WsfObject (const WsfObject &aSrc)
	Copy constructor (for Clone()).

Additional Inherited Members
Public Types inherited from WsfObject
typedef std::vector< WsfStringId >	TypeList
	The list of types returned by GetTypeList.

Detailed Description

A coverage grid formed from the composition of multiple sub-grids.

The implementation strategy is to defer as much to the owned instances of the sub-grids. In a few cases, the PointId or GridAsset from the sub-grid is modified to give the correct PointId relative to the parent grid.

Constructor & Destructor Documentation

◆ CompositeGrid() [1/2]

wsf::coverage::CompositeGrid::CompositeGrid ( const WsfScenario & aScenario )

inlineexplicit

References wsf::coverage::Grid::Grid().

Referenced by Clone(), and CompositeGrid().

◆ CompositeGrid() [2/2]

wsf::coverage::CompositeGrid::CompositeGrid ( const CompositeGrid & aOther )

default

References CompositeGrid().

◆ ~CompositeGrid()

wsf::coverage::CompositeGrid::~CompositeGrid ( )

overridedefault

Member Function Documentation

◆ Clone()

CompositeGrid * wsf::coverage::CompositeGrid::Clone ( ) const

inlineoverridevirtual

Return a copy of this object. Must be implemented by all derived types. If cloning is impossible, a WsfUncloneableException should be thrown.

Implements wsf::coverage::Grid.

References CompositeGrid().

◆ CreatesNewPlatforms()

bool wsf::coverage::CompositeGrid::CreatesNewPlatforms ( ) const

inlineoverridevirtual

Return if the grid creates new platforms during initialization.

A grid should either create new platforms, or use existing platforms. This method returns if this grid creates new platforms. The behavior of some coverage classes will vary depending on the result of this method.

Returns: - true if this grid creates new platforms during initialization; false if it uses existing platforms.

Implements wsf::coverage::Grid.

◆ GetAsset() [1/2]

GridAsset wsf::coverage::CompositeGrid::GetAsset ( const std::string & aPlatformName ) const

overridevirtual

Return a grid asset for the given platform.

This returns the grid asset associated with the platform that has the given aPlatformName. If there is no such asset, this will return an invalid grid asset.

Parameters

aPlatformName - The name of one of this grid's asset platform.

Returns: - The corresponding grid asset if it exists; an invalid grid asset otherwise.

Implements wsf::coverage::Grid.

References wsf::coverage::cINVALID_POINT_ID, and GetAsset().

◆ GetAsset() [2/2]

GridAsset wsf::coverage::CompositeGrid::GetAsset ( PointId aPointId ) const

overridevirtual

Return a grid asset for the point with the given ID.

This returns the grid asset for the point with the given aPointId. If there is no such point, this will return an invalid grid asset.

Parameters

aPointId - The ID of a point in this grid.

Returns: - The corresponding grid asset if it exists; an invalid grid asset otherwise.

Implements wsf::coverage::Grid.

References wsf::coverage::cINVALID_POINT_ID.

Referenced by GetAsset().

◆ GetComponentName()

std::string wsf::coverage::CompositeGrid::GetComponentName ( std::size_t aComponentIndex ) const

overridevirtual

Return the name of the specified grid component.

Reimplemented from wsf::coverage::Grid.

◆ GetComponentSizes()

std::pair< std::size_t, std::size_t > wsf::coverage::CompositeGrid::GetComponentSizes ( std::size_t aComponentIndex ) const

overridevirtual

Return the number of points in the specified grid component.

This method returns the size of the structured grid as the N-S and E-W size of the grid in the first and second components of the returned pair, but only if this grid returns true from IsStructured. Otherwise, the size of the component is returned in the first component, and a 1 is returned in the second component.

Parameters

aComponentIndex The component whose size is being queried.

Returns: A pair containing the N-S and E-W number of points in the structured grid (respectively), or the size of the component in the first component and 1 in the second component if the grid is not structured.

Reimplemented from wsf::coverage::Grid.

◆ GetNumComponents()

std::size_t wsf::coverage::CompositeGrid::GetNumComponents ( ) const

overridevirtual

Return the number of grid components.

Grid components are geometrically distinct portions of a grid. Most grids have a single component. For an example of a grid with multiple components, see CompositeGrid.

Returns: The number of components of this grid.

Reimplemented from wsf::coverage::Grid.

◆ GetPoint()

const Point * wsf::coverage::CompositeGrid::GetPoint ( PointId aPointId ) const

overridevirtual

Return the Point at the given index if it exists.

This will return the Point with the given aPointId if such a point exists. This will return nullptr if this Grid has not been initialized.

Parameters

aPointId - The ID of the point to retrieve.

Returns: - The Point if it exists; nullptr otherwise.

Implements wsf::coverage::Grid.

◆ GetPointIndices()

std::pair< std::size_t, std::size_t > wsf::coverage::CompositeGrid::GetPointIndices ( PointId aPointId ) const

overridevirtual

Return the structured index of the point with the given aPointId.

This returns the indices of the point with the given aPointId in the structure of the grid. If the grid is not structured, this will return a pair containing two zeros. The returned indices will each be in the range [0, N) where N is the respective component of the value returned by GetComponentSizes. If the given aPointId does not refer to a point in this grid, this will return a pair with out of bounds indices (they are larger than the return values from GetComponentSizes).

Parameters

aPointId The id of the point whose structure indices are requested.

Returns: The structure indices of the point for structured grids; a pair with two zeros otherwise.

Reimplemented from wsf::coverage::Grid.

◆ GetSize()

std::size_t wsf::coverage::CompositeGrid::GetSize ( ) const

inlineoverridevirtual

Return the number of Points in this Grid.

This will return the number of Points in this Grid. This will return 0 if this Grid has not been initialized.

Returns: - The number of Points in this grid.

Implements wsf::coverage::Grid.

◆ HasNullDevice()

void wsf::coverage::CompositeGrid::HasNullDevice	(	bool &	aAnyNull,
		bool &	aAllNull ) const

overridevirtual

Return if this grid's assets have null devices.

This will determine if this grid has any asset with a null device, and set aAnyNull accordingly. This will also determing if all of this grid's assets have null devices, and set aAllNull accordingly.

Parameters

aAnyNull	[out] - Does any asset have a null device.
aAllNull	[out] - Do all assets have a null device.

Implements wsf::coverage::Grid.

◆ InitializeP()

bool wsf::coverage::CompositeGrid::InitializeP ( )

overrideprotectedvirtual

Grid type specific initialization.

Initialization specific to the grid type occurs in this method. In particular, validation on input quantities should occur here. The set of grid points should be defined after this method's successful return, and both GetAsset methods should return valid GridAsset instances for any point in this grid.

Returns: true if initialization is successful; false otherwise.

Implements wsf::coverage::Grid.

References wsf::coverage::CreateGridAction(), wsf::coverage::Point::GetAltitude(), wsf::coverage::Grid::GetAsset(), wsf::coverage::Grid::GetCentralBody(), wsf::coverage::Point::GetID(), wsf::coverage::Point::GetLatitude(), wsf::coverage::Point::GetLongitude(), WsfObject::GetName(), wsf::coverage::Grid::GetNextAvailableId(), wsf::coverage::Grid::GetSuppressGridPlatforms(), wsf::coverage::Grid::Grid(), wsf::coverage::Grid::Initialize(), and wsf::coverage::GridAsset::SetPointId().

◆ Invoke()

void wsf::coverage::CompositeGrid::Invoke ( GridAction & aAction ) const

overridevirtual

Invoke the given action on every Point in this Grid.

This method invokes the given action for every Point in this Grid. If this method is used before this Grid is initialized, this method will do nothing.

Parameters

aAction - The action to invoke for every Point in this Grid.

Implements wsf::coverage::Grid.

References wsf::coverage::GridAction::Call().

◆ InvokeOnComponent()

void wsf::coverage::CompositeGrid::InvokeOnComponent	(	GridAction &	aAction,
		std::size_t	aComponentIndex ) const

overridevirtual

Invoke the given action on the given component.

This will invoke the given aAction on the component with the given aComponentIndex. This will effectively call InvokeOnComponent on the subgrid, but will then translate the points from the subgrid into the equivalent point on the parent grid. This is important for cases where InvokeOnComponent calls the provided action more times than when calling Invoke for the selected subgrid.

Parameters

aAction	- The action to invoke for each point of the subgrid.
aComponentIndex	- The index of the component on which to invoke the given `aAction`.

Reimplemented from wsf::coverage::Grid.

References wsf::coverage::GridAction::Call(), wsf::coverage::CreateGridAction(), end(), wsf::coverage::Point::GetAltitude(), wsf::coverage::Point::GetID(), wsf::coverage::Point::GetLatitude(), wsf::coverage::Point::GetLongitude(), and wsf::coverage::Grid::Grid().

◆ IsStructured()

bool wsf::coverage::CompositeGrid::IsStructured ( ) const

overridevirtual

Return if the grid is structured.

Structured grids are those grids that have some positional organization of the grid points. Most grids are structured. For an example of an unstructured grid, see the ExistingPlatformGrid. To prevent a subclass from participating in overlay output from a Coverage object, IsStructured should return false.

Returns: true if the grid has some structure to its points; false otherwise.

Reimplemented from wsf::coverage::Grid.

◆ PreparePlatforms()

void wsf::coverage::CompositeGrid::PreparePlatforms ( WsfSimulation & aSimulation )

overridevirtual

Prepare the platforms for this grid.

This method will create or modify the platforms associated with this grid object. In particular, this should mark created platforms as private so they are not sent over DIS. This should also set the side of created platforms so they might be easily removed from the visual tools.

Parameters

aSimulation - The simulation in which this grid's platforms will participate.

Implements wsf::coverage::Grid.

References WsfSimulation::GetPlatformByName().

◆ ProcessInput()

bool wsf::coverage::CompositeGrid::ProcessInput ( UtInput & aInput )

overridevirtual

Process input from a generic source.

Examine the current input command. If it is NOT one of the commands recognized by this class then it simply returns 'false'. If it is one of the commands recognized by this class then it processes the command and returns 'true'.

Parameters

aInput a reference to a UtInput object.

Returns: 'true' if the command was one recognized by the class or 'false' if not.

Exceptions

UtInput::ExceptionBase (or an object derived from it) if the command was recognized but contains some sort of error.

Note: If a derived class does not recognize the command (i.e.: the return value is false) then it should call the base class ProcessInput method. This chain should continue until either the command is recognized or the top-level base class is encountered.

Reimplemented from WsfObject.

References WsfObjectTypeList< T >::Find(), wsf::coverage::GridTypes::Get(), WsfObject::GetName(), wsf::coverage::Grid::GetScenario(), and wsf::coverage::Grid::ProcessInput().

Member Data Documentation

◆ cTYPE

const char* wsf::coverage::CompositeGrid::cTYPE {"WSF_COMPOSITE_GRID"}

staticconstexpr

Referenced by wsf::coverage::GridTypes::GridTypes().

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

Public Member Functions

Static Public Attributes

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ CompositeGrid() [1/2]

◆ CompositeGrid() [2/2]

◆ ~CompositeGrid()

Member Function Documentation

◆ Clone()

◆ CreatesNewPlatforms()

◆ GetAsset() [1/2]

◆ GetAsset() [2/2]

◆ GetComponentName()

◆ GetComponentSizes()

◆ GetNumComponents()

◆ GetPoint()

◆ GetPointIndices()

◆ GetSize()

◆ HasNullDevice()

◆ InitializeP()

◆ Invoke()

◆ InvokeOnComponent()

◆ IsStructured()

◆ PreparePlatforms()

◆ ProcessInput()

Member Data Documentation

◆ cTYPE