plotKML (version 0.4-2)

spMetadata.Spatial: Generate spatial metadata from an sp object

Description

Tries to generate metadata from an external file. If no metadata file is available, tries to fill in missing columns based on the data properties.

Usage

spMetadata.Spatial(obj, xml.file, generate.missing = TRUE, Citation_title,  
    Target_variable, Attribute_Measurement_Resolution = 1, 
    Attribute_Units_of_Measure = "NA",
    Indirect_Spatial_Reference = "", GoogleGeocode = FALSE, 
    Enduser_license_URL = get("license_url", envir = plotKML.opts),
    signif.digit = 3, colour_scale, bounds, legend_names, icons, 
    validate.schema = FALSE, Target_variable_descr = "NA", 
    Geosp_Data_Presentation_Form, Edition, Purpose, Abstract, 
    Supplinf, Publisher, Pub_Place, Temp_Ext,
    Update_Freq = c("Unknown", "Continually", "Daily", "Weekly", 
    "Monthly", "Annually", "As needed", "Irregular", "None planned"), 
    Stat_Progress = c("Complete", "In work", "Planned"), 
    Spatial_Represent_Type = c("Point", "Vector", "Raster"),
    Keyw_theme, Keyw_place)

Arguments

obj

some "Spatial" class object with "data" slot

xml.file

(optional) metadata file in the FGDC format

generate.missing

logical; species whether the program should try to generate missing metadata automatically

Citation_title

one-sentence title of the object

Target_variable

target variable i.e. column name in the data slot

Attribute_Measurement_Resolution

numeric resolution (typically estimated as half the measurement precision)

Attribute_Units_of_Measure

physical units of the target variable

Indirect_Spatial_Reference

name of the closest geographical location, town or village

GoogleGeocode

logical; specifies whether R should try to estimate Indirect Spatial Reference using Google maps API

Enduser_license_URL

end-user license specification (URL)

signif.digit

integer; a number of significant digits to round the numbers in the palette slot

colour_scale

collor scheme used to visualize this data

bounds

numeric vector; upper and lower limit bounds for the target variable

legend_names

(optional) manually inserted legend names

icons

(optional) manually inserted icon names for legend names

validate.schema

logical; specieis whether R should try to validate your xml file

Target_variable_descr

character; specifies target variable description for eainfo-node 'attrdef'

Geosp_Data_Presentation_Form

character; defines node 'geoform'

Edition

defines the version of the title

Purpose

defines the purpose of the given layer

Abstract

defines the abstract of the given layer

Supplinf

defines the supplemental information of the given layer

Publisher

defines publishing organization (or individual)

Pub_Place

defines publication place ('pubplace')

Temp_Ext

defines temporal extent start/end

Update_Freq

defines update frequency

Stat_Progress

defines progress status

Spatial_Represent_Type

defines direct node (direct spatial reference method)

Keyw_theme

defines node(s) 'themekey'

Keyw_place

defines node(s) 'placekey'

Details

spMetadata.Spatial tries to locate a metadata file in the working directory (it looks for a metadata file with the same name as the object name). If no .xml file exists, it will load the template xml file available in the system folder (system.file("FGDC.xml", package="plotKML")).

See Also

SpatialMetadata-class

Examples

data(eberg)
library(sp)
library(rgdal)
coordinates(eberg) <- ~X+Y
proj4string(eberg) <- CRS("+init=epsg:31467")
# (a) no metadata file exist:
eberg.md <- spMetadata(eberg, Target_variable="SNDMHT_A")
# (b) with localy prepared metadata file:
eberg.md <- spMetadata(eberg, xml.file=system.file("eberg.xml", package="plotKML"), 
Target_variable="SNDMHT_A")