DataSetInfo.FromDirectory Method

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

FromDirectory(System.String path, System.Boolean searchSubdirectories)

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

Syntax

public static DataSetInfoCollection FromDirectory (
    System.String path,
    System.Boolean searchSubdirectories
)

Parameters

path

Type: System.String
The path to the directory.

searchSubdirectories

Type: System.Boolean
Tells whether files in subdirectories shall be considered.

Return Value

Type: A collection of DataSetInfo elements.
A new collection of DataSetInfo instances with information about the geodata in the given directory.

Remarks

The result is not exhaustive: there are some kinds of geodata files that can be read by Carmenta Engine, but which are not recognized by this method. Sometimes this is because the required type of DataSet is not supported by FromDirectory, and sometimes it is because the file extension is not searched for.

Supported types of DataSet

The FromDirectory method supports all the dataset types that inherit from FileDataSet, except ArincDataSet and S57DataSet. In addition, the method also supports RaveGeoDataSet even though it does not inherit from FileDataSet.

An ARINC file can be opened by FromFile instead, but S57 data cannot.

Supported file extensions

The FromDirectory method retrieves only files that match a list of commonly occurring file extensions for geodata files. We have omitted file extensions that are rarely seen, since they could otherwise slow down the method.

Also, your Carmenta Engine license may exclude some types of datasets, so the method will ignore geodata files that require a dataset type for which you have no license.

File name pattern	The type of DataSet you can get from CreateDataSet()
`*.2nd`	DfadDataSet
`*.asc`	GdalDataSet
`*.bil`	GdalDataSet or HdrDataSet
`*.bip`	GdalDataSet or HdrDataSet
`*.bmp`	GdalDataSet or ImageDataSet
`*.bsq`	GdalDataSet or HdrDataSet
`dat_01.001`	GdalDataSet
`*.dem`	GdalDataSet
`*.dt0`	DtedDataSet
`*.dt1`	DtedDataSet
`*.dt2`	DtedDataSet
`*.dwg`	DwgDxfDataSet
`*.dxf`	DwgDxfDataSet
`*.ecw`	EcwDataSet
`*.gen`	GdalDataSet
`*.gif`	GdalDataSet or ImageDataSet
`*.gpkg`	MapPackageDataSet
`*.gpkx`	MapPackageDataSet
`*.grd`	GdalDataSet
`*.hgt`	GdalDataSet
`*.img`	GdalDataSet
`*.jif`	GdalDataSet or ImageDataSet
`*.jp2`	Jpeg2000DataSet
`*.jpeg`	GdalDataSet or ImageDataSet
`*.jpg`	GdalDataSet or ImageDataSet
`LAT`	VpfDataSet
`*.mif`	OgrDataSet or MifDataSet
`*.mpx`	MapPackageDataSet
`*.n1`	GdalDataSet
`*.png`	GdalDataSet or ImageDataSet
`*.rlib`	RaveGeoDataSet
`*.shp`	ShapefileDataSet
`*.sid`	MrSidDataSet
`contents.thf`	CmrgDataSet
`*.tif`	GdalDataSet or ImageDataSet
`*.tiff`	GdalDataSet or ImageDataSet
`*.toc`	RpfDataSet

The file name patterns that FromDirectory() will look for, and the corresponding types of dataset you may then create.

Platforms

Windows, Linux, Android

DataSetInfo::fromDirectory Method

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

fromDirectory(const String& path, bool searchSubdirectories)

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

Syntax

C++

public:
static DataSetInfoCollectionPtr fromDirectory (
    const String& path,
    bool searchSubdirectories
)

Parameters

path

Type: String
The path to the directory.

searchSubdirectories

Type: bool
Tells whether files in subdirectories shall be considered.

Return Value

Type: A collection of DataSetInfo elements.
A new collection of DataSetInfo instances with information about the geodata in the given directory.

Remarks

The result is not exhaustive: there are some kinds of geodata files that can be read by Carmenta Engine, but which are not recognized by this method. Sometimes this is because the required type of DataSet is not supported by fromDirectory, and sometimes it is because the file extension is not searched for.

Supported types of DataSet

The fromDirectory method supports all the dataset types that inherit from FileDataSet, except ArincDataSet and S57DataSet. In addition, the method also supports RaveGeoDataSet even though it does not inherit from FileDataSet.

An ARINC file can be opened by fromFile instead, but S57 data cannot.

Supported file extensions

The fromDirectory method retrieves only files that match a list of commonly occurring file extensions for geodata files. We have omitted file extensions that are rarely seen, since they could otherwise slow down the method.

Also, your Carmenta Engine license may exclude some types of datasets, so the method will ignore geodata files that require a dataset type for which you have no license.

File name pattern	The type of DataSet you can get from CreateDataSet()
`*.2nd`	DfadDataSet
`*.asc`	GdalDataSet
`*.bil`	GdalDataSet or HdrDataSet
`*.bip`	GdalDataSet or HdrDataSet
`*.bmp`	GdalDataSet or ImageDataSet
`*.bsq`	GdalDataSet or HdrDataSet
`dat_01.001`	GdalDataSet
`*.dem`	GdalDataSet
`*.dt0`	DtedDataSet
`*.dt1`	DtedDataSet
`*.dt2`	DtedDataSet
`*.dwg`	DwgDxfDataSet
`*.dxf`	DwgDxfDataSet
`*.ecw`	EcwDataSet
`*.gen`	GdalDataSet
`*.gif`	GdalDataSet or ImageDataSet
`*.gpkg`	MapPackageDataSet
`*.gpkx`	MapPackageDataSet
`*.grd`	GdalDataSet
`*.hgt`	GdalDataSet
`*.img`	GdalDataSet
`*.jif`	GdalDataSet or ImageDataSet
`*.jp2`	Jpeg2000DataSet
`*.jpeg`	GdalDataSet or ImageDataSet
`*.jpg`	GdalDataSet or ImageDataSet
`LAT`	VpfDataSet
`*.mif`	OgrDataSet or MifDataSet
`*.mpx`	MapPackageDataSet
`*.n1`	GdalDataSet
`*.png`	GdalDataSet or ImageDataSet
`*.rlib`	RaveGeoDataSet
`*.shp`	ShapefileDataSet
`*.sid`	MrSidDataSet
`contents.thf`	CmrgDataSet
`*.tif`	GdalDataSet or ImageDataSet
`*.tiff`	GdalDataSet or ImageDataSet
`*.toc`	RpfDataSet

The file name patterns that FromDirectory() will look for, and the corresponding types of dataset you may then create.

Platforms

Windows, Linux, Android

DataSetInfo.fromDirectory Method

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

fromDirectory(String path, boolean searchSubdirectories)

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

Syntax

Java

public static final DataSetInfoCollection fromDirectory (
    String path,
    boolean searchSubdirectories
)

Parameters

path

Type: String
The path to the directory.

searchSubdirectories

Type: boolean
Tells whether files in subdirectories shall be considered.

Return Value

Type: A collection of DataSetInfo elements.
A new collection of DataSetInfo instances with information about the geodata in the given directory.

Remarks

The result is not exhaustive: there are some kinds of geodata files that can be read by Carmenta Engine, but which are not recognized by this method. Sometimes this is because the required type of DataSet is not supported by fromDirectory, and sometimes it is because the file extension is not searched for.

Supported types of DataSet

An ARINC file can be opened by fromFile instead, but S57 data cannot.

Supported file extensions

Also, your Carmenta Engine license may exclude some types of datasets, so the method will ignore geodata files that require a dataset type for which you have no license.

File name pattern	The type of DataSet you can get from CreateDataSet()
`*.2nd`	DfadDataSet
`*.asc`	GdalDataSet
`*.bil`	GdalDataSet or HdrDataSet
`*.bip`	GdalDataSet or HdrDataSet
`*.bmp`	GdalDataSet or ImageDataSet
`*.bsq`	GdalDataSet or HdrDataSet
`dat_01.001`	GdalDataSet
`*.dem`	GdalDataSet
`*.dt0`	DtedDataSet
`*.dt1`	DtedDataSet
`*.dt2`	DtedDataSet
`*.dwg`	DwgDxfDataSet
`*.dxf`	DwgDxfDataSet
`*.ecw`	EcwDataSet
`*.gen`	GdalDataSet
`*.gif`	GdalDataSet or ImageDataSet
`*.gpkg`	MapPackageDataSet
`*.gpkx`	MapPackageDataSet
`*.grd`	GdalDataSet
`*.hgt`	GdalDataSet
`*.img`	GdalDataSet
`*.jif`	GdalDataSet or ImageDataSet
`*.jp2`	Jpeg2000DataSet
`*.jpeg`	GdalDataSet or ImageDataSet
`*.jpg`	GdalDataSet or ImageDataSet
`LAT`	VpfDataSet
`*.mif`	OgrDataSet or MifDataSet
`*.mpx`	MapPackageDataSet
`*.n1`	GdalDataSet
`*.png`	GdalDataSet or ImageDataSet
`*.rlib`	RaveGeoDataSet
`*.shp`	ShapefileDataSet
`*.sid`	MrSidDataSet
`contents.thf`	CmrgDataSet
`*.tif`	GdalDataSet or ImageDataSet
`*.tiff`	GdalDataSet or ImageDataSet
`*.toc`	RpfDataSet

The file name patterns that FromDirectory() will look for, and the corresponding types of dataset you may then create.

Platforms

Windows, Linux, Android

DataSetInfo.fromDirectory Method

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

fromDirectory(path, searchSubdirectories)

Returns a new collection of DataSetInfo instances with information about the geodata in the given directory.

Syntax

Python

DataSetInfoCollection fromDirectory ( path, searchSubdirectories )

Parameters

path

Type: String
The path to the directory.

searchSubdirectories

Type: bool
Tells whether files in subdirectories shall be considered.

Return Value

Type: A collection of DataSetInfo elements.
A new collection of DataSetInfo instances with information about the geodata in the given directory.

Remarks

The result is not exhaustive: there are some kinds of geodata files that can be read by Carmenta Engine, but which are not recognized by this method. Sometimes this is because the required type of DataSet is not supported by fromDirectory, and sometimes it is because the file extension is not searched for.

Supported types of DataSet

An ARINC file can be opened by fromFile instead, but S57 data cannot.

Supported file extensions

Also, your Carmenta Engine license may exclude some types of datasets, so the method will ignore geodata files that require a dataset type for which you have no license.

File name pattern	The type of DataSet you can get from CreateDataSet()
`*.2nd`	DfadDataSet
`*.asc`	GdalDataSet
`*.bil`	GdalDataSet or HdrDataSet
`*.bip`	GdalDataSet or HdrDataSet
`*.bmp`	GdalDataSet or ImageDataSet
`*.bsq`	GdalDataSet or HdrDataSet
`dat_01.001`	GdalDataSet
`*.dem`	GdalDataSet
`*.dt0`	DtedDataSet
`*.dt1`	DtedDataSet
`*.dt2`	DtedDataSet
`*.dwg`	DwgDxfDataSet
`*.dxf`	DwgDxfDataSet
`*.ecw`	EcwDataSet
`*.gen`	GdalDataSet
`*.gif`	GdalDataSet or ImageDataSet
`*.gpkg`	MapPackageDataSet
`*.gpkx`	MapPackageDataSet
`*.grd`	GdalDataSet
`*.hgt`	GdalDataSet
`*.img`	GdalDataSet
`*.jif`	GdalDataSet or ImageDataSet
`*.jp2`	Jpeg2000DataSet
`*.jpeg`	GdalDataSet or ImageDataSet
`*.jpg`	GdalDataSet or ImageDataSet
`LAT`	VpfDataSet
`*.mif`	OgrDataSet or MifDataSet
`*.mpx`	MapPackageDataSet
`*.n1`	GdalDataSet
`*.png`	GdalDataSet or ImageDataSet
`*.rlib`	RaveGeoDataSet
`*.shp`	ShapefileDataSet
`*.sid`	MrSidDataSet
`contents.thf`	CmrgDataSet
`*.tif`	GdalDataSet or ImageDataSet
`*.tiff`	GdalDataSet or ImageDataSet
`*.toc`	RpfDataSet

The file name patterns that FromDirectory() will look for, and the corresponding types of dataset you may then create.

Platforms

Windows, Linux, Android

DataSetInfo.FromDirectory Method

In this article

FromDirectory(System.String path, System.Boolean searchSubdirectories)

Syntax

Parameters

Return Value

Remarks

Platforms

See Also

Reference

DataSetInfo::fromDirectory Method

In this article

fromDirectory(const String& path, bool searchSubdirectories)

Syntax

Parameters

Return Value

Remarks

Platforms

See Also

Reference

DataSetInfo.fromDirectory Method

In this article

fromDirectory(String path, boolean searchSubdirectories)

Syntax

Parameters

Return Value

Remarks

Platforms

See Also

Reference

DataSetInfo.fromDirectory Method

In this article

fromDirectory(path, searchSubdirectories)

Syntax

Parameters

Return Value

Remarks

Platforms

See Also

Reference