DatumShiftInfo.FileStatus Property
Gets the file status (missing or found) for one or more grid shift files (NTv2 or CTable).
Syntax
public System.String FileStatus { get; }Property Value
Default: ""
The file status as text.
Remarks
This property is not useful to enter if you create a DatumShiftInfo manually in Carmenta Studio. But it can be useful if you have called one of the methods
GeodeticDatum.AlternativeDatumShifts(gridFileRootPath)
GeodeticDatum.AlternativeDatumShiftsForArea(areaName, gridFileRootPath)
GeodeticDatum.AlternativeDatumShiftsForArea(areaBounds, gridFileRootPath)
These methods can return a DatumShiftInfo for a grid file datum shift as well as for simpler datum shifts. The methods need a gridFileRootPath as argument (its value is not prescribed by Carmenta, since you can store your grid files where you like). The DatumShiftInfo for a grid file datum shift will be returned even if your computer lacks the necessary grid file.
The contents of FileStatus will then tell whether the grid file exists in the expected location; it will be either Missing fileName or Found fileName. If the file is missing, an attempt to construct the grid file datum shift from the DatumShiftInfo will throw an exception, so you must try to download the grid file from the original InformationSource.
The file is searched for in any subdirectory of gridFileRootPath.
When these GeodeticDatum methods give a DatumShiftInfo based on a grid file, the corresponding datum shift will always be a FallbackDatumShift where the first alternative is a GridFileDatumShift with a single grid file, and a fallback alternative that is a simple HelmertDatumShift. Sometimes you may want to use a GridFileDatumShift with several grid files, but that will require human judgement since grid files often have an overlap where they disagree.
Platforms
Windows, Linux, Android