Differences

This shows you the differences between two versions of the page.

--- metadata [2016/01/26 14:17]
admin
+++ metadata [2016/04/28 00:01]
hermann [Map Metadata File Expansion]
@@ Line 1: / Line 1: @@
 ====== Metadata  ======
-===== Map Metadata Template=====
+Map metadata files are generated by [[Save Map]] functors when the corresponding metadata option is enabled by marking the apropriate checkbox on the Metadata tab of the functor editor.
-^ Metadata Keyword  ^ Description  ^ Editable Input  ^ Expansion Example  ^
+Once the metadata generation is enabled for a [[Save Map]], each map written by that functor will have an associated metadata file.
-| %TITLE%  | Title of the map  |
-| %DESCRIPTION%  | Description of the map  |
+The metadata file content is created replacing predefined tags or keywords on a template map with input supplied by the user or by the map itself. The metadata file name is created replacing the map file extension with the metadata file extension.
-| %SOURCE%  | Source or project originating the map  |
-| %ORIGINAL_SCALE%  | Original scale of the data from where the map was produced  |
+===== Map Metadata Template Keywords (Tags) =====
-| %ADDITIONAL_CATEGORY_INFORMATION%  |
-| %PUBLISHERS%  | Publisher of the map |
+^ Metadata Keyword  ^ Description  ^ Input Source  ^
-| %NUMBER_OF_COLUMNS%  | Number of rows of the map  |
+| **%TITLE%**  | Title of the map.  | Supplied by the user.  |
-| %NUMBER_OF_LINES%  | Number of lines of the map  |
+| **%DESCRIPTION%**  | Description of the map.  | Supplied by the user.  |
-| %CELL_HEIGHT%  | Height of the cells of the map. The height unit is projection dependent.  |
+| **%SOURCE%**  | Source or project originating the map.  | Supplied by the user.  |
-| %CELL_HEIGHT_IN_METERS%  | Height of the cells of the map in meters.  |
+| **%CITATION%**  | Citation instructing how to cite the map in a scientific publication.  | Supplied by the user.  |
-| %CELL_WIDTH%  | Width of the cells of the map. The width unit is projection dependent.  |
+| **%ORIGINAL_SCALE%**  | Original scale of the data from where the map was produced.  | Supplied by the user.  |
-| %CELL_WIDTH_IN_METERS%  | Width of the cells of the map in meters.  |
+| **%ADDITIONAL_CATEGORY_INFORMATION%**  | Additional information about the categories. Used typically to describe the null value.  | Supplied by the user.  |
-| %NUMBER_OF_LAYERS%  | Number of layers/bands of the map.  |
+| **%PUBLISHERS%**  | Publisher of the map.  | Supplied by the user.  |
-| %NULL_VALUE%  | Value representing the null value (no data) of the map.  |
+| **%NUMBER_OF_COLUMNS%**  | Number of rows of the map.   | Supplied by the map.  |
-| %CELL_TYPE%  | Text representing the type of the cell of the map.  |
+| **%NUMBER_OF_LINES%**  | Number of lines of the map.  | Supplied by the map.  |
-| %CELL_TYPE_CODE%  | Code representing the type of the cell of the map. See the [[cell_type_type|cell type definition]] for a list of all valid codes.  |
+| **%CELL_HEIGHT%**  | Height of the cells of the map. The height unit is projection dependent.  | Supplied by the map.  |
-| %CREATION_YEAR%  |
+| **%CELL_HEIGHT_IN_METERS%**  | Height of the cells of the map in meters.  | Supplied by the map.  |
-| %PROJECTION_WKT%  |
+| **%CELL_WIDTH%**  | Width of the cells of the map. The width unit is projection dependent.  | Supplied by the map.  |
-| %CATEGORIES%  |
+| **%CELL_WIDTH_IN_METERS%**  | Width of the cells of the map in meters.  | Supplied by the map.  |
-| %LAYER_RANGES%  |
+| **%NUMBER_OF_LAYERS%**  | Number of layers/bands of the map.  | Supplied by the map.  |
-| %CREATION_DATE%  |
+| **%NULL_VALUE%**  | Value representing the null value (no data) of the map.  | Supplied by the map.  |
-|
+| **%CELL_TYPE%**  | Text representing the type of the cell of the map.  | Supplied by the map.  |
+| **%CELL_TYPE_CODE%**  | Code representing the type of the cell of the map. See the [[cell_type_type|cell type definition]] for a list of all valid codes.  | Supplied by the map.  |
+| **%CREATION_YEAR%**  | Map creation year.  | Supplied by the system.  |
+| **%PROJECTION_WKT%**  | Map projection represented as a WKT string.  | Supplied by the map.  |
+| **%CATEGORIES%**  | List of map categories, if any. Each category is represented by its cell value and name.  | Supplied by the map.  |
+| **%LAYER_RANGES%**  | List of map layers and their corresponding minimum and maximum cell values.  | Supplied by the map.  |
+| **%CREATION_DATE%**  | Map creation date.  | Supplied by the system.  |
+| **%SOURCE_MODEL_FILE%**  | Name of the model script file responsible for the generation of the map.  | Supplied by the map.  |
 ===== Map Metadata Template Example =====
@@ Line 36: / Line 43: @@
 description = '%DESCRIPTION%
-Número de Colunas : %NUMBER_OF_COLUMNS%
+Number of Columns : %NUMBER_OF_COLUMNS%
-Número de Linhas : %NUMBER_OF_LINES%
+Number of Lines : %NUMBER_OF_LINES%
-Altura da Célula : %CELL_HEIGHT%
+Cell Height : %CELL_HEIGHT%
-Largura da Célula : %CELL_WIDTH%
+Cell Width : %CELL_WIDTH%
-Número de Camadas : %NUMBER_OF_LAYERS%
+Layers : %NUMBER_OF_LAYERS%
-Valor Nulo : %NULL_VALUE%
+Null Value : %NULL_VALUE%
-Tipo de Célula : %CELL_TYPE%'
+Cell Type : %CELL_TYPE%
+Model File : %SOURCE_MODEL_FILE%'
 source = '%SOURCE%'
+citation = '%CITATION%'
 original scale = '%ORIGINAL_SCALE%'
-thematic category = '%THEMATIC_CATEGORY%'
+thematic category = 'planning (015)'
 [SPATIAL REPRESENTATION SYSTEM]
 creation date = %CREATION_YEAR%
-original format = 'matricial (002)'
+original format = 'raster (002)'
 coordinate system representation = '%PROJECTION_WKT%'
@@ Line 60: / Line 69: @@
 [METAMETADATA]
-updated = %CREATION_DATE%
+updated = '%CREATION_DATE%'
 publishers = '%PUBLISHERS%'
+</code>
+===== Map Metadata File Expansion =====
+The following example illustrates a possible expansion of the metadata template for a given map file.
+<code>
+[IDENTIFICATION]
+title = 'Uso da terra no Brasil simulado pelo OTIMIZAGRO para 2030'
+description = 'OTIMIZAGRO modela nove cultivos temporários: 1) soja, 2) cana-de-açúcar, 3) milho, 4) algodão, 5) trigo, 6) feijão, 7) arroz, 8) mandioca e 9) fumo e cinco permanentes: 10) café arábica, 11) café robusta, 12) laranja, 13) cacau e 14) banana. Culturas de inverno ou safrinha incluem: 15) trigo, 16) feijão e 17) milho. Transições de desmatamento nos vários biomas e regeneração florestal também são modeladas.
+Number of Columns : 8533
+Cell Height : 500.0
+Cell Width : 500.0
+Number of Layers : 1
+Null Cell Value : 0.0
+Number of Lines : 8765
+Cell Type : Byte
+Model File : C:/models/otimizagro.egoml'
+source = 'Centro de Sensoriamento Remoto - CSR/UFMG (2015)'
+citation = 'Soares-Filho BS(2015) Otimizagro model, Brasil: IGC/UFMG. Available at: <http://csr.ufmg.br/dinamica>'
+original scale = 'Não informada'
+thematic category = 'planejamentoECadastro (015)'
+[SPATIAL REPRESENTATION SYSTEM]
+creation date = 2015
+original format = 'matricial (002)'
+coordinate system representation = 'PROJCS["South_America_Albers_Equal_Area_Conic_MC51W",
+    GEOGCS["GCS_South_American_1969",
+        DATUM["unknown",
+            SPHEROID["unnamed",6378160,298.249999999996]],
+        PRIMEM["Greenwich",0],
+        UNIT["degree",0.0174532925199433]],
+    PROJECTION["Albers_Conic_Equal_Area"],
+    PARAMETER["standard_parallel_1",-5],
+    PARAMETER["standard_parallel_2",-42],
+    PARAMETER["latitude_of_center",-32],
+    PARAMETER["longitude_of_center",-51],
+    PARAMETER["false_easting",0],
+    PARAMETER["false_northing",0],
+    UNIT["metre",1]]'
+[CATEGORIES]
+additional information = ''
+= 'fumo'
+= 'milho_2s'
+= 'feijao_2s'
+= 'laranja'
+= 'mandioca'
+= 'banana'
+= 'cacau'
+= 'feijao_feijao'
+= 'agua'
+= 'pastagem'
+= 'urbano'
+= 'savanas'
+= 'pastagem_em_AP'
+= 'florestas'
+= 'savanas_em_AP'
+= 'restauro'
+= 'florestas_em_AP'
+= 'milho_feijao'
+= 'soja_feijao'
+= 'soja'
+= 'milho'
+= 'cana_de_acucar'
+= 'arroz'
+= 'algodao'
+= 'feijao'
+= 'trigo'
+= 'cafe_robusta'
+= 'cafe_arabica'
+= 'floresta_plantada'
+= 'milho_trigo'
+= 'soja_trigo'
+[RANGE]
+layer_0 = '(Min=1.0,Max=40.0)'
+[METAMETADATA]
+updated = '2015/04/23'
+publishers = 'Centro de Sensoriamento Remoto - CSR/UFMG'
 </code>