Metadata Creation and Validation Methods

Writing Metadata

I T ’ S NOT SO BAD !! First records are the hardest Not all fields may need to be filled in Tools are available Training classes can be taken Can often be produced automatically Can (and should) be reviewed for updates Tips for Writing Metadata

StepsforwritingqualitymetadataStepsforwritingqualitymetadata Writing Metadata Organize your information Write your metadata file Review your file Have someone else review ReviseRevise PublishPublish Organize your information Write your metadata file Review your file Have someone else review ReviseRevise PublishPublish

Before you begin writing, get organized Document your data as you go Write so others can understand Always review your document Writing Metadata

Metadata entry tool Metadata entry tool coffee chocolate standard and/or workbook ISO editor sense of humour!!!

Write simply but completely Document for a general audience Be consistent in style and terminology Keep your readers in mind

Define all acronyms Avoid using jargon Clearly state data limitations Keep your readers in mind

Write a complete title that includes… What Where When Who Writing Metadata

Which is better? Greater Yellowstone Rivers from 1:126,700 Forest Visitor Maps ( ) The title is critical in helping others find your data.

Vague: We checked our work and it looks complete. Specific: We checked our work using 3 separate sets of check plots reviewed by 2 different people. We determined our work to be 95% complete based on these visual inspections. Be specific. Quantify when you can.

Select your key words wisely Use unambiguous words Use descriptive words Fully qualify geographic locations

Have someone else read it If you’re the only reviewer, put it away and read it again later Check for clarity and omissions Review your final product

Can a novice understand what you wrote? Are your data properly documented for posterity? When you review your work, ask:

Does the documentation present all the information needed to use or reuse the data? Are any pieces missing? When you review your work, ask:

Organize your information Write your metadata file Review your file Have someone else review ReviseRevise PublishPublish Six Steps for Writing Quality Metadata Six Steps for Writing Quality Metadata Writing Metadata

Write so that others will understand

ISO Metadata Creation Methods

Creating ISO Metadata Ways to create ISO metadata 1.Transform from existing FGDC Metadata 2.Develop from templates ftp://ftp.ncddc.noaa.gov/pub/Metadata/Onlin e_ISO_Training/Transition_to_ISO/templates/ 3.Develop from scratch FGDC Metadata Guidance – -metadata-standards

Transform from Existing CSDGM using XSLT Extensible Stylesheet Language Transformations (XSLT) is an XML- based language used for the transformation of XML documents into other XML or "human-readable" documents via stylesheets (XSL). The original document is not changed; rather, a new document is created based on the content of an existing one. It does NOT guarantee valid XML records against a particular schema!!!! (simply displays the content in a new way.)

This is a part of the mapping for FGDC CSDGM to ISO Comments are Best Practices or Questions Transforming Metadata

transform CSDGM ISO Your input here is an xml version of a CSDGM record. XSLT Transformation csdgm2iso19115.xslt Your result is an xml instance of an ISO record. Transforming Metadata

Transforming CSDGM to ISO using XMLSpy Open XMLSpy XML Editor Open FGDC RSE XML file named Metadata to Transform.xml Select “F10” or XSL/Xquery > XSL Transformation from Menu – Select transform – CSDGM to ISO, use csdgm2iso xml – RSE to ISO, use fgdcrse2iso xsl Run transformation Select Text for output view Save as XML

Clue this is FGDC RSE so must use correct transform

Transforming FGDC Metadata using Open XML Editor Open FGDC RSE XML file named Metadata to Transform.xml Set up transformation scenario – one time set up – Name the scenario e.g. as “RSE to ISO ” – Select transform and transformation engine – For RSE to ISO use fgdcrse2iso xsl – Select Saxon-PE or EE transformers) Run transformation

Transforming FGDC Metadata using MERMAid Navigate to record to transform in Record level interface Select “Export” tab Select ISO , and “Produce View” button New window will open Select ISO for Section 5, Entity and Attributes.

Other Transformations ISO to FGDC DIF to ISO FGDC THREDDS netCDF to ISO Various ISO and FGDC views Custom transforms (from databases to metadata standards)

Transforming Metadata

Develop Metadata from Templates../pub/Metadata/Online_ISO_Training/Transition_to_ISO/ templates MDtemplate for ISO MIBiotemplate for ISO with Biological Extensions MItemplate For ISO

Exercise Transforming FGDC CSDGM Metadata to ISO Metadata Exercise ftp://ftp.ncddc.noaa.gov/pub/Metadata/Online_ ISO_Training/Transition_to_ISO/exercises/metad ata2transform.xml

Validating ISO Metadata

Tools for Validation Schemas NameSpaces Schematrons

XML Schemas Defines the structure, content, and some semantics of XML documents Pattern that represents the data’s model and defines the objects, attributes, and relationships Defines the rules for the structure and content of an XML document

Which schema do I use? Use the schema reference at ma.xsd – MD_Metadata root (19115) is found at gmd.xsd – MI_Metadata root ( ) is found at gmi.xsd – FC_FeatureCatalogue root (19110) is found at gfc.xsd Use biological schema set to document biological records (extends either MD or MI Metadata)

insert text insert text xmlns:gmi=“ xmlns:gmd=“ xmlns:gco=" Namespaces These codes are called namespaces. The namespace is a container providing context and rules for items. A definition of a term may change, depending on what namespace is applied.

Validation Tips <gmi:MI_Metadata xmlns:xsi=" xmlns:gmd=" xmlns:gco= “ xmlns:xlink=" xmlns:srv=" xmlns:gml=" xmlns:gsr=" xmlns:gss=" xmlns:gts=" xmlns:gmx=" xmlns:gmi=" xsi:schemaLocation="

Schematrons Used in conjunction with schemas Checks for additional validation that the schema cannot check – Content such as west bounding coordinate is west of the east bounding coordinate Delivers human-readable error messages

Online Validation Help ISO Validation FYI – ide.noaa.gov/wiki/index.php?title=ISO_Validation Validation Error Guidance for both XMLSpy and oXygen – ide.noaa.gov/wiki/index.php?title=Validation_Error_Guidan ce Online Validation –

Exercise Metadata to Fix – ftp://ftp.ncddc.noaa.gov/pub/Metadata/Online_ISO_Tra ining/Transition_to_ISO/exercises/metadata2fix1.xml Open record above in Spy or oXygen Apply correct schema Check namespaces Check validation

questions to