TopoBaseInfo Class

A class holding metadata according to French standard TopoBase Défense Edition V2.

Syntax

public class TopoBaseInfo : ProfileSpecificInfo

Remarks

A TopoBaseInfo instance holds additional metadata for a data set or data file, according to the French standard TopoBase Défense, edition 2. It can be retrieved through the DataSet.GetDataSetInfo method and DataSetInfo.ProfileSpecificInfo, if such metadata is present.

The standard specifies a number of products, each with its own specific data format and associated metadata. So only a few Carmenta Engine data sets will actually look for additional TopoBase Défense metadata files.

Product	Data format	Carmenta Engine data set
ORTHO-1	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-2	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-U	JPEG 2000	Jpeg2000DataSet
RASTER	ASRP, USRP	GdalDataSet
VMap1, VMAP2i	VPF	VpfDataSet

For the raster data sets, the root DataSetInfo will contain the information from the .EPU file, and the DataSetInfo instance for each file will hold file-specific information from the corresponding .PU file. For VMAP, the .EPU information will be available through the database DataSetInfo instance (corresponding to the LAT file), the library level DataSetInfo instances will hold information from the corresponding .PU file.

Only a subset of the available metadata is read. QualityParameters will contain a number of single-value quality parameters valid for the entire data set or file, whereas QualityLayers may contain one or more references to an external file containing a mask with associated quality values. The AdditionalInfo may contain some other values picked up from the metadata files, such as contact information and security classification.

Example

// Read TopoBase PLAQUA quality info at a specified point
static AttributeSet getQualityAttributes(DataSet ds, Point p)
{
	// Get TopoBase metadata from data set
	var dataSetInfo = ds.GetDataSetInfo();
	var profileSpecificMetadata = dataSetInfo.ProfileSpecificInfo;
	if (!(profileSpecificMetadata is TopoBaseInfo))
	{
		// If root node didn't have the information, get it from the child covering p
		foreach (var dsi in dataSetInfo.Children)
		{
			if (dsi.Bounds.Inside(p))
			{
				profileSpecificMetadata = dsi.ProfileSpecificInfo;
				if (profileSpecificMetadata is TopoBaseInfo)
					break;
			}
		}
	}
	if (!(profileSpecificMetadata is TopoBaseInfo))
		return null;
	var topoBaseInfo = profileSpecificMetadata as TopoBaseInfo;

	// Find the PLAQUA quality layer
	TopoBaseInfoEntry plaqua = null;
	foreach (var ql in topoBaseInfo.QualityLayers)
	{
		if (ql.MeasureIdentification == "PLAQUA")
		{
			plaqua = ql;
			break;
		}
	}
	if (plaqua == null)
		return null;

	// Find quality area containing p
	foreach (var f in plaqua.QualityAreas)
	{
		var poly = f.GetGeometryAsPolygon();
		if (poly != null && poly.PointInside(p))
			return f.Attributes;
	}
	return null;
}

Inheritance Hierarchy

System.Object (not available in C#)
  EngineObject
    ProfileSpecificInfo
      TopoBaseInfo

Platforms

Windows, Linux, Android

TopoBaseInfo Members

The TopoBaseInfo type has the following members.

Properties

Name	Description
AdditionalInfo	Gets some additional information picked up from the metadata files.
IsDisposed	Gets a value that tells whether the current TopoBaseInfo has been disposed. Inherited from EngineObject
NativeHandle	Gets the native Carmenta Engine kernel object the current TopoBaseInfo represents. Inherited from EngineObject
QualityLayers	Gets a collection of additional quality layers.
QualityParameters	Gets a set of single-valued quality parameters valid for the entire data set or file.

Methods

Name	Description
Clone	Creates a copy of an object. Inherited from EngineObject
Dispose	Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject
Equals	Determines whether this instance is equal to another. Inherited from EngineObject

TopoBaseInfo Class

A class holding metadata according to French standard TopoBase Défense Edition V2.

Syntax

C++

class TopoBaseInfo : public ProfileSpecificInfo

C++ Smart Pointer Declaration

typedef Ptr<TopoBaseInfo> TopoBaseInfoPtr;

Remarks

A TopoBaseInfo instance holds additional metadata for a data set or data file, according to the French standard TopoBase Défense, edition 2. It can be retrieved through the DataSet::getDataSetInfo method and DataSetInfo::profileSpecificInfo, if such metadata is present.

Product	Data format	Carmenta Engine data set
ORTHO-1	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-2	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-U	JPEG 2000	Jpeg2000DataSet
RASTER	ASRP, USRP	GdalDataSet
VMap1, VMAP2i	VPF	VpfDataSet

Only a subset of the available metadata is read. qualityParameters will contain a number of single-value quality parameters valid for the entire data set or file, whereas qualityLayers may contain one or more references to an external file containing a mask with associated quality values. The additionalInfo may contain some other values picked up from the metadata files, such as contact information and security classification.

Example

C++

// Read Read TopoBase PLAQUA quality info at a specified point
static AttributeSetPtr getQualityAttributes(DataSetPtr ds, Point p)
{
	// Get TopoBase metadata from data set
	auto dataSetInfo = ds->getDataSetInfo();
	auto profileSpecificMetadata = dataSetInfo->profileSpecificInfo();
	if (!dynamic_cast<TopoBaseInfo*>(profileSpecificMetadata.get()))
	{
		// If root node didn't have the information, get it from the child covering p
		auto children = dataSetInfo->children();
		for (DataSetInfoPtr dsi : *children)
		{
			if (dsi->bounds().inside(p))
			{
				profileSpecificMetadata = dsi->profileSpecificInfo();
				if (dynamic_cast<TopoBaseInfo*>(profileSpecificMetadata.get()))
					break;
			}
		}
	}
	if (!dynamic_cast<TopoBaseInfo*>(profileSpecificMetadata.get()))
		return nullptr;
	auto topoBaseInfo = dynamic_cast<TopoBaseInfo*>(profileSpecificMetadata.get());

	// Find the PLAQUA quality layer
	TopoBaseInfoEntryPtr plaqua;
	auto qls = topoBaseInfo->qualityLayers();
	for (TopoBaseInfoEntryPtr ql : *qls)
	{
		if (ql->measureIdentification() == "PLAQUA")
		{
			plaqua = ql;
			break;
		}
	}
	if (!plaqua)
		return nullptr;

	// Find quality area containing p
	auto qas = plaqua->qualityAreas();
	for (FeaturePtr f : *qas)
	{
		auto poly = f->getGeometryAsPolygon();
		if (poly && poly->pointInside(p))
			return f->attributes();
	}
	return nullptr;
}

Inheritance Hierarchy

EngineObject
ProfileSpecificInfo
TopoBaseInfo

Platforms

Windows, Linux, Android

TopoBaseInfo Members

The TopoBaseInfo type has the following members.

Properties

Name	Description
additionalInfo	Gets some additional information picked up from the metadata files.
qualityLayers	Gets a collection of additional quality layers.
qualityParameters	Gets a set of single-valued quality parameters valid for the entire data set or file.

Methods

Name	Description
clone	Creates a copy of an object. Inherited from EngineObject
equals	Determines whether this instance is equal to another. Inherited from EngineObject

TopoBaseInfo Class

A class holding metadata according to French standard TopoBase Défense Edition V2.

Syntax

Java

public class TopoBaseInfo extends ProfileSpecificInfo

Remarks

A TopoBaseInfo instance holds additional metadata for a data set or data file, according to the French standard TopoBase Défense, edition 2. It can be retrieved through the DataSet.getDataSetInfo method and DataSetInfo.profileSpecificInfo, if such metadata is present.

Product	Data format	Carmenta Engine data set
ORTHO-1	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-2	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-U	JPEG 2000	Jpeg2000DataSet
RASTER	ASRP, USRP	GdalDataSet
VMap1, VMAP2i	VPF	VpfDataSet

Example

Java

// Read TopoBase PLAQUA quality info at a specified point
static AttributeSet getQualityAttributes(DataSet ds, Point p)
{
	// Get TopoBase metadata from data set
	DataSetInfo dataSetInfo = ds.getDataSetInfo();
	ProfileSpecificInfo profileSpecificMetadata = dataSetInfo.getProfileSpecificInfo();
	if (!(profileSpecificMetadata instanceof TopoBaseInfo))
	{
		// If root node didn't have the information, get it from the child covering p
		for (DataSetInfo dsi : dataSetInfo.getChildren())
		{
			if (dsi.getBounds().inside(p))
			{
				profileSpecificMetadata = dsi.getProfileSpecificInfo();
				if (profileSpecificMetadata instanceof TopoBaseInfo)
					break;
			}
		}
	}
	if (!(profileSpecificMetadata instanceof TopoBaseInfo))
		return null;
	TopoBaseInfo topoBaseInfo = (TopoBaseInfo)profileSpecificMetadata;

	// Find the PLAQUA quality layer
	TopoBaseInfoEntry plaqua = null;
	for (TopoBaseInfoEntry ql : topoBaseInfo.getQualityLayers())
	{
		if (ql.getMeasureIdentification().equals("PLAQUA"))
		{
			plaqua = ql;
			break;
		}
	}
	if (plaqua == null)
		return null;

	// Find quality area containing p
	for (Feature f : plaqua.getQualityAreas())
	{
		PolygonGeometry poly = f.getGeometryAsPolygon();
		if (poly != null && poly.pointInside(p))
			return f.getAttributes();
	}
	return null;
}

Inheritance Hierarchy

System::Object (not available in Java)
  EngineObject
    ProfileSpecificInfo
      TopoBaseInfo

Platforms

Windows, Linux, Android

TopoBaseInfo Members

The TopoBaseInfo type has the following members.

Properties

Name	Description
additionalInfo	Gets some additional information picked up from the metadata files.
isDisposed	Gets a value that tells whether the current TopoBaseInfo has been disposed. Inherited from EngineObject
qualityLayers	Gets a collection of additional quality layers.
qualityParameters	Gets a set of single-valued quality parameters valid for the entire data set or file.

Methods

Name	Description
clone	Creates a copy of an object. Inherited from EngineObject
dispose	Releases the reference to the native Carmenta Engine kernel instance the EngineObject represents. Inherited from EngineObject
equals	Determines whether this instance is equal to another. Inherited from EngineObject

TopoBaseInfo Class

A class holding metadata according to French standard TopoBase Défense Edition V2.

Syntax

Python

class TopoBaseInfo ( ProfileSpecificInfo )

Remarks

A TopoBaseInfo instance holds additional metadata for a data set or data file, according to the French standard TopoBase Défense, edition 2. It can be retrieved through the DataSet.getDataSetInfo method and DataSetInfo.profileSpecificInfo, if such metadata is present.

Product	Data format	Carmenta Engine data set
ORTHO-1	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-2	GeoTIFF	ImageDataSet, GdalDataSet
ORTHO-U	JPEG 2000	Jpeg2000DataSet
RASTER	ASRP, USRP	GdalDataSet
VMap1, VMAP2i	VPF	VpfDataSet

Example

Python

# This example is not available in the selected language.

Inheritance Hierarchy

EngineObject
ProfileSpecificInfo
TopoBaseInfo

Platforms

Windows, Linux, Android

TopoBaseInfo Members

The TopoBaseInfo type has the following members.

Properties

Name	Description
additionalInfo	Gets some additional information picked up from the metadata files.
qualityLayers	Gets a collection of additional quality layers.
qualityParameters	Gets a set of single-valued quality parameters valid for the entire data set or file.

Methods

Name	Description
clone	Creates a copy of an object. Inherited from EngineObject
equals	Determines whether this instance is equal to another. Inherited from EngineObject

TopoBaseInfo Class

In this article

Syntax

Remarks

Example

Inheritance Hierarchy

Platforms

See Also

Reference

TopoBaseInfo Members

TopoBaseInfo Class

In this article

Syntax

Remarks

Example

Inheritance Hierarchy

Platforms

See Also

Reference

TopoBaseInfo Members

TopoBaseInfo Class

In this article

Syntax

Remarks

Example

Inheritance Hierarchy

Platforms

See Also

Reference

TopoBaseInfo Members

TopoBaseInfo Class

In this article

Syntax

Remarks

Example

Inheritance Hierarchy

Platforms

See Also

Reference

TopoBaseInfo Members