GDAL
gdal_mdreader.h
1/******************************************************************************
2 * $Id: gdal_mdreader.h e37e476c4cf8f4b0df8995e0d95d5d672fca1a9b 2018-05-05 16:54:18 +0200 Even Rouault $
3 *
4 * Project: GDAL Core
5 * Purpose: Read metadata (mainly the remote sensing imagery) from files of
6 * different providers like DigitalGlobe, GeoEye etc.
7 * Author: Dmitry Baryshnikov, polimax@mail.ru
8 *
9 ******************************************************************************
10 * Copyright (c) 2014-2015, NextGIS info@nextgis.ru
11 *
12 * Permission is hereby granted, free of charge, to any person obtaining a
13 * copy of this software and associated documentation files (the "Software"),
14 * to deal in the Software without restriction, including without limitation
15 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
16 * and/or sell copies of the Software, and to permit persons to whom the
17 * Software is furnished to do so, subject to the following conditions:
18 *
19 * The above copyright notice and this permission notice shall be included
20 * in all copies or substantial portions of the Software.
21 *
22 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
23 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
25 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
26 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
27 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
28 * DEALINGS IN THE SOFTWARE.
29 ****************************************************************************/
30
31#ifndef GDAL_MDREADER_H_INCLUDED
32#define GDAL_MDREADER_H_INCLUDED
33
34#include "cpl_port.h"
35#include "gdal_priv.h"
36
37#define MD_DOMAIN_IMD "IMD"
38#define MD_DOMAIN_RPC "RPC"
39#define MD_DOMAIN_IMAGERY "IMAGERY"
40#define MD_DOMAIN_DEFAULT ""
42#define MD_NAME_ACQDATETIME "ACQUISITIONDATETIME"
43#define MD_NAME_SATELLITE "SATELLITEID"
44#define MD_NAME_CLOUDCOVER "CLOUDCOVER"
45#define MD_NAME_MDTYPE "METADATATYPE"
47#define MD_DATETIMEFORMAT "%Y-%m-%d %H:%M:%S"
48#define MD_CLOUDCOVER_NA "999"
54#define RPC_LINE_OFF "LINE_OFF"
55#define RPC_SAMP_OFF "SAMP_OFF"
56#define RPC_LAT_OFF "LAT_OFF"
57#define RPC_LONG_OFF "LONG_OFF"
58#define RPC_HEIGHT_OFF "HEIGHT_OFF"
59#define RPC_LINE_SCALE "LINE_SCALE"
60#define RPC_SAMP_SCALE "SAMP_SCALE"
61#define RPC_LAT_SCALE "LAT_SCALE"
62#define RPC_LONG_SCALE "LONG_SCALE"
63#define RPC_HEIGHT_SCALE "HEIGHT_SCALE"
64#define RPC_LINE_NUM_COEFF "LINE_NUM_COEFF"
65#define RPC_LINE_DEN_COEFF "LINE_DEN_COEFF"
66#define RPC_SAMP_NUM_COEFF "SAMP_NUM_COEFF"
67#define RPC_SAMP_DEN_COEFF "SAMP_DEN_COEFF"
68
69/* Optional */
70#define RPC_MIN_LONG "MIN_LONG"
71#define RPC_MIN_LAT "MIN_LAT"
72#define RPC_MAX_LONG "MAX_LONG"
73#define RPC_MAX_LAT "MAX_LAT"
74
79typedef enum {
80 MDR_None = 0x00000000,
81 MDR_DG = 0x00000001,
82 MDR_GE = 0x00000002,
83 MDR_OV = 0x00000004,
84 MDR_PLEIADES = 0x00000008,
85 MDR_SPOT = 0x00000010,
86 MDR_RDK1 = 0x00000020,
87 MDR_LS = 0x00000040,
88 MDR_RE = 0x00000080,
89 MDR_KOMPSAT = 0x00000100,
90 MDR_EROS = 0x00000200,
91 MDR_ALOS = 0x00000400,
92 MDR_ANY = MDR_DG | MDR_GE | MDR_OV | MDR_PLEIADES | MDR_SPOT | MDR_RDK1 |
93 MDR_LS | MDR_RE | MDR_KOMPSAT | MDR_EROS | MDR_ALOS
94} MDReaders;
95
100
102
103public:
104 GDALMDReaderBase(const char *pszPath, char **papszSiblingFiles);
105 virtual ~GDALMDReaderBase();
106
112 virtual char ** GetMetadataDomain(const char *pszDomain);
118 virtual bool FillMetadata(GDALMultiDomainMetadata* poMDMD);
124 virtual bool HasRequiredFiles() const = 0;
130 virtual char** GetMetadataFiles() const = 0;
131protected:
136 virtual void LoadMetadata();
142 virtual time_t GetAcquisitionTimeFromString(const char* pszDateTime);
152 virtual char** ReadXMLToList(CPLXMLNode* psNode, char** papszList,
153 const char* pszName = "");
163 virtual char** AddXMLNameValueToList(char** papszList, const char *pszName,
164 const char *pszValue);
165protected:
167 char **m_papszIMDMD = nullptr;
168 char **m_papszRPCMD = nullptr;
169 char **m_papszIMAGERYMD = nullptr;
170 char **m_papszDEFAULTMD = nullptr;
171 bool m_bIsMetadataLoad = false;
173};
174
181
183
184public:
186 virtual ~GDALMDReaderManager();
187
198 virtual GDALMDReaderBase* GetReader(const char *pszPath,
199 char **papszSiblingFiles,
200 GUInt32 nType = MDR_ANY);
201protected:
203 GDALMDReaderBase *m_pReader = nullptr;
205};
206
207// misc
208CPLString CPLStrip(const CPLString& osString, const char cChar);
209CPLString CPLStripQuotes(const CPLString& osString);
210char** GDALLoadRPBFile( const CPLString& osFilePath );
211char** GDALLoadRPCFile( const CPLString& osFilePath );
212char** GDALLoadIMDFile( const CPLString& osFilePath );
213bool GDALCheckFileHeader(const CPLString& soFilePath,
214 const char * pszTestString,
215 int nBufferSize = 256);
216
217CPLErr GDALWriteRPBFile( const char *pszFilename, char **papszMD );
218CPLErr GDALWriteRPCTXTFile( const char *pszFilename, char **papszMD );
219CPLErr GDALWriteIMDFile( const char *pszFilename, char **papszMD );
220
221#endif //GDAL_MDREADER_H_INCLUDED
Convenient string class based on std::string.
Definition: cpl_string.h:330
The base class for all metadata readers.
Definition: gdal_mdreader.h:99
virtual char ** GetMetadataFiles() const =0
Get metadata file names.
virtual time_t GetAcquisitionTimeFromString(const char *pszDateTime)
Convert string like 2012-02-25T00:25:59.9440000Z to time.
Definition: gdal_mdreader.cpp:235
virtual char ** GetMetadataDomain(const char *pszDomain)
Get specified metadata domain.
Definition: gdal_mdreader.cpp:208
GDALMDReaderBase(const char *pszPath, char **papszSiblingFiles)
GDALMDReaderBase()
Definition: gdal_mdreader.cpp:190
virtual char ** ReadXMLToList(CPLXMLNode *psNode, char **papszList, const char *pszName="")
ReadXMLToList Transform xml to list of NULL terminated name=value strings.
Definition: gdal_mdreader.cpp:304
virtual ~GDALMDReaderBase()
~GDALMDReaderBase()
Definition: gdal_mdreader.cpp:197
virtual void LoadMetadata()
Load metadata to the correspondent IMD, RPB, IMAGERY and DEFAULT domains.
Definition: gdal_mdreader.cpp:225
virtual bool FillMetadata(GDALMultiDomainMetadata *poMDMD)
Fill provided metadata store class.
Definition: gdal_mdreader.cpp:276
virtual bool HasRequiredFiles() const =0
Determine whether the input parameter correspond to the particular provider of remote sensing data co...
virtual char ** AddXMLNameValueToList(char **papszList, const char *pszName, const char *pszValue)
AddXMLNameValueToList Execute from ReadXMLToList to add name and value to list.
Definition: gdal_mdreader.cpp:294
The metadata reader main class.
Definition: gdal_mdreader.h:180
GDALMDReaderManager()
GDALMDReaderManager()
CPLErr
Error category.
Definition: cpl_error.h:53
Core portability definitions for CPL.
unsigned int GUInt32
Unsigned int32 type.
Definition: cpl_port.h:207
#define CPL_DISALLOW_COPY_ASSIGN(ClassName)
Helper to remove the copy and assignment constructors so that the compiler will not generate the defa...
Definition: cpl_port.h:997
C++ GDAL entry points.
Document node structure.
Definition: cpl_minixml.h:67

Generated for GDAL by doxygen 1.9.4.