Пример #1
0
        /// <summary>
        /// Main utility method to parse a Radarsat1 Metadata text file and populate the Radarsat1 Image Observation from the information
        /// contained within the file.
        ///
        /// The metadata is in RADARSAT CEOS format and is (c) Canadian Space Agency 1997 Agence spatiale canadienne, and processed and distributed by MDA Geospatial Services Inc.
        /// The data and metadata used within this software has been made freely available by the Canadian Federal Government under its Open Government initiative,
        /// subject to the following license terms: https://open.canada.ca/en/open-government-licence-canada
        /// </summary>
        /// <param name="metadataFileKey">The filepath/filename of the Radarsat1 metadata file</param>
        /// <exception cref="ArgumentNullException"></exception>
        /// <returns>A populated Radarsat1Observation object containing the metadata values, or null if the object couldn't be populated</returns>
        /// <throws>A FileLoadException if the file cannot be found or loaded</throws>
        public Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> GetRadarsat1ObservationFromMetadataFile(string radarsat1MetadataFilename)
        {
            Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> observation = null;
            // Radarsat 1 metadata files are in .txt format
            // ReSharper disable once RedundantAssignment
            var metadataFileText = string.Empty;

            if (radarsat1MetadataFilename.EndsWith(".txt"))
            {
                try
                {   // Open the Radarsat1 Metadata text file
                    using (StreamReader sr = new StreamReader(radarsat1MetadataFilename, Encoding.GetEncoding("iso-8859-1")))
                    {
                        metadataFileText = sr.ReadToEnd();
                    }
                }
                catch (Exception ex)
                {
                    throw new FileLoadException(ex.Message);
                }
                String       radarsatUniqueId   = Path.GetFileNameWithoutExtension(radarsat1MetadataFilename);
                String       sceneId            = metadataFileText.FindStringWithinAnchorText("SCENE_ID", "MDA ORDER NUMBER", true, true);
                String       mdaOrderNumber     = metadataFileText.FindStringWithinAnchorText("MDA ORDER NUMBER", "GEOGRAPHICAL AREA", true, true);
                String       geographicalArea   = metadataFileText.FindStringWithinAnchorText("GEOGRAPHICAL AREA", "SCENE START TIME", true, true);
                String       sceneStartTimeText = metadataFileText.FindStringWithinAnchorText("SCENE START TIME", "SCENE STOP TIME", true, true);
                const string dateFormatPattern  = "MMM dd yyyy HH:mm:ss.FFF";
                Guard.Against <ArgumentNullException>(
                    String.IsNullOrEmpty(sceneStartTimeText),
                    DeploySoftware_LaunchPad_Space_Resources.Exception_Radarsat1MetadataParser_GetRadarsat1ObservationFromMetadataFile_SceneStartTime_ArgumentNullExpection
                    );
                DateTime.TryParseExact(sceneStartTimeText,
                                       dateFormatPattern,
                                       CultureInfo.InvariantCulture,
                                       DateTimeStyles.None,
                                       out DateTime sceneStartTime);
                String sceneStopTimeText = metadataFileText.FindStringWithinAnchorText("SCENE STOP TIME", "ORBIT", true, true);
                Guard.Against <ArgumentNullException>(
                    String.IsNullOrEmpty(sceneStopTimeText),
                    DeploySoftware_LaunchPad_Space_Resources.Exception_Radarsat1MetadataParser_GetRadarsat1ObservationFromMetadataFile_SceneStopTime_ArgumentNullExpection
                    );
                DateTime.TryParseExact(sceneStopTimeText,
                                       dateFormatPattern,
                                       CultureInfo.InvariantCulture,
                                       DateTimeStyles.None,
                                       out DateTime sceneStopTime);
                String orbit          = metadataFileText.FindStringWithinAnchorText("ORBIT", "ORBIT DATA TYPE", true, true);
                String orbitDataType  = metadataFileText.FindStringWithinAnchorText("ORBIT DATA TYPE", "APPLICATION LUT", true, true);
                String applicationLut = metadataFileText.FindStringWithinAnchorText("APPLICATION LUT", "BEAM MODE", true, true);
                String beamMode       = metadataFileText.FindStringWithinAnchorText("BEAM MODE", "PRODUCT TYPE", true, true);
                String productType    = metadataFileText.FindStringWithinAnchorText("PRODUCT TYPE", "FORMAT", true, true);
                String format         = metadataFileText.FindStringWithinAnchorText("FORMAT", "# OF IMAGE LINES", true, true);
                Int32.TryParse(metadataFileText.FindStringWithinAnchorText("# OF IMAGE LINES", "# OF IMAGE PIXELS", true, true), out var numberImageLines);
                Int32.TryParse(metadataFileText.FindStringWithinAnchorText("# OF IMAGE PIXELS", "PIXEL SPACING", true, true), out var numberImagePixels);
                String pixelSpacing = metadataFileText.FindStringWithinAnchorText("PIXEL SPACING", "SCENE CENTRE", true, true);

                // when loading coordinates, disable celestial calculations (not needed)
                EagerLoad load = new EagerLoad
                {
                    Celestial = false,
                    Cartesian = true,
                    UTM_MGRS  = true
                };

                // get the scene centre coordinates. Centre is spelled properly in Canadian, eh.
                String sceneCentre = metadataFileText.FindStringWithinAnchorText("SCENE CENTRE", "CORNER COORDINATES", true, true);
                Guard.Against <ArgumentNullException>(
                    String.IsNullOrEmpty(sceneCentre),
                    DeploySoftware_LaunchPad_Space_Resources.Exception_Radarsat1MetadataParser_GetRadarsat1ObservationFromMetadataFile_SceneCentre_ArgumentNullExpection
                    );
                // ReSharper disable once PossibleNullReferenceException
                string[]   latLongSplit = sceneCentre.Split(new[] { ' ' }, StringSplitOptions.RemoveEmptyEntries);
                Coordinate c            = new Coordinate(load);
                c.Latitude  = GetLatitude(latLongSplit[0], c);
                c.Longitude = GetLongitude(latLongSplit[1], c);
                GeographicLocation centre = new GeographicLocation
                                            (
                    c.Latitude.ToDouble(),
                    c.Longitude.ToDouble(),
                    c.EagerLoadSettings
                                            );

                // get the image corner coordinates
                String cornerCoordinatesString = metadataFileText.FindStringWithinAnchorText("CORNER COORDINATES:", "For information on RADARSAT CEOS format see README.TXT", true, true);
                Guard.Against <ArgumentNullException>(
                    String.IsNullOrEmpty(cornerCoordinatesString),
                    DeploySoftware_LaunchPad_Space_Resources.Exception_Radarsat1MetadataParser_GetRadarsat1ObservationFromMetadataFile_CornerCoordinates_ArgumentNullExpection
                    );
                ImageObservationCornerCoordinates cornerCoords = GetCornerCoordinates(cornerCoordinatesString);

                ILicense     license   = new OpenGovernmentCanadaLicense();
                IUsageRights copyright = new Radarsat1DataUsageRights();

                // Create a new Radarsat1 Earth Observation image
                observation = new Radarsat1Observation <TPrimaryKey, TFileStorageLocationType>(
                    null, // tenant Id - not used in this application
                    sceneId,
                    mdaOrderNumber,
                    geographicalArea,
                    sceneStartTime,
                    sceneStopTime,
                    orbit,
                    orbitDataType,
                    applicationLut,
                    beamMode,
                    productType,
                    format,
                    numberImageLines,
                    numberImagePixels,
                    pixelSpacing,
                    centre,
                    cornerCoords
                    )
                {
                    Name = radarsatUniqueId,

                    //Metadata.Description = radarsatUniqueId,
                    Copyright = copyright
                };
            }

            // ReSharper disable once PossibleNullReferenceException
            observation.Files = LoadExpectedObservationFiles(observation, radarsat1MetadataFilename);
            return(observation);
        }
Пример #2
0
        protected Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .Radarsat1ObservationFiles LoadExpectedObservationFiles(Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> observation, string radarsat1MetadataFilename)
        {
            // get the list of related observation files
            String baseFilePath = radarsat1MetadataFilename.Substring(0, radarsat1MetadataFilename.Length - 4);
            IList <KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, String> > expectedFiles = new List <KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, String> >
            {
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Nvol,
                    baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Nvol
                    ),
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Sard, baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Sard
                    ),
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Sarl, baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Sarl
                    ),
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Sart, baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Sart
                    ),
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Tfw, baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Tfw
                    ),
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Tif, baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Tif
                    ),
                new KeyValuePair <Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes, string>(
                    Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Vol, baseFilePath + "." + Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .FileTypes.Vol
                    )
            };

            // initialize the list of observation files
            Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .Radarsat1ObservationFiles observationFiles = new Radarsat1Observation <TPrimaryKey, TFileStorageLocationType> .Radarsat1ObservationFiles();

            var location = new TFileStorageLocationType();

            location.RootPath = new System.Uri(Directory.GetCurrentDirectory());

            // add each expected file type (if it exists)
            if (File.Exists(expectedFiles[0].Value))
            {
                observationFiles.Nvol = new NvolFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[0].Value),
                    Location = location
                };
            }
            if (File.Exists(expectedFiles[1].Value))
            {
                observationFiles.Sard = new SardFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[1].Value),
                    Location = location
                };
            }
            if (File.Exists(expectedFiles[2].Value))
            {
                observationFiles.Sarl = new SarlFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[2].Value),
                    Location = location
                };
            }
            if (File.Exists(expectedFiles[3].Value))
            {
                observationFiles.Sart = new SartFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[3].Value),
                    Location = location
                };
            }
            if (File.Exists(expectedFiles[4].Value))
            {
                observationFiles.Tfw = new TifWorldFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[4].Value),
                    Location = location
                };
            }
            if (File.Exists(expectedFiles[5].Value))
            {
                observationFiles.Tif = new TifFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[5].Value),
                    Location = location
                };
            }
            if (File.Exists(expectedFiles[6].Value))
            {
                observationFiles.Vol = new VolFile <Guid, TFileStorageLocationType>()
                {
                    Id       = SequentialGuid.NewGuid(),
                    Name     = Path.GetFileName(expectedFiles[6].Value),
                    Location = location
                };
            }
            return(observationFiles);
        }