adiwg-mdtranslator 2.4.0 → 2.5.0

data/lib/adiwg/mdtranslator/writers/iso19110/classes/class_citation.rb

@@ -0,0 +1,185 @@
+# ISO <<Class>> CI_Citation
+# 19110 writer output in XML
+
+# History:
+# 	Stan Smith 2017-11-02 original script.
+
+require_relative 'class_codelist'
+require_relative 'class_responsibleParty'
+require_relative 'class_date'
+require_relative 'class_mdIdentifier'
+require_relative 'class_series'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Iso19110
+
+            class CI_Citation
+
+               def initialize(xml, hResponseObj)
+                  @xml = xml
+                  @hResponseObj = hResponseObj
+               end
+
+               def writeXML(hCitation)
+
+                  unless hCitation.empty?
+
+                     # classes used
+                     codelistClass = MD_Codelist.new(@xml, @hResponseObj)
+                     rPartyClass = CI_ResponsibleParty.new(@xml, @hResponseObj)
+                     dateClass = CI_Date.new(@xml, @hResponseObj)
+                     idClass = MD_Identifier.new(@xml, @hResponseObj)
+                     seriesClass = CI_Series.new(@xml, @hResponseObj)
+
+                     @xml.tag!('gmd:CI_Citation') do
+
+                        # citation - title (required)
+                        s = hCitation[:title]
+                        if s.nil?
+                           @xml.tag!('gmd:title', {'gco:nilReason' => 'missing'})
+                        else
+                           @xml.tag!('gmd:title') do
+                              @xml.tag!('gco:CharacterString', s)
+                           end
+                        end
+
+                        # citation - alternate title []
+                        aTitles = hCitation[:alternateTitles]
+                        aTitles.each do |title|
+                           @xml.tag!('gmd:alternateTitle') do
+                              @xml.tag!('gco:CharacterString', title)
+                           end
+                        end
+                        if aTitles.empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:alternateTitle')
+                        end
+
+                        # citation - date [] (required)
+                        aDate = hCitation[:dates]
+                        aDate.each do |hDate|
+                           @xml.tag!('gmd:date') do
+                              dateClass.writeXML(hDate)
+                           end
+                        end
+                        if aDate.empty?
+                           @xml.tag!('gmd:date', {'gco:nilReason' => 'missing'})
+                        end
+
+                        # citation - edition
+                        s = hCitation[:edition]
+                        unless s.nil?
+                           @xml.tag!('gmd:edition') do
+                              @xml.tag!('gco:CharacterString', s)
+                           end
+                        end
+                        if s.nil? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:edition')
+                        end
+
+                        # citation - resource identifier []
+                        # do not process ISBN and ISSN as MD_identifier(s)
+                        # ... these are written separately in ISO 19115-x
+                        isbn = ''
+                        issn = ''
+                        aIds = hCitation[:identifiers]
+                        aIds.each do |hIdentifier|
+                           unless hIdentifier[:namespace].nil?
+                              if hIdentifier[:namespace].downcase == 'isbn'
+                                 isbn = hIdentifier[:identifier]
+                              elsif hIdentifier[:namespace].downcase == 'issn'
+                                 issn = hIdentifier[:identifier]
+                              end
+                           end
+                           if issn == '' && isbn == ''
+                              @xml.tag!('gmd:identifier') do
+                                 idClass.writeXML(hIdentifier)
+                              end
+                           end
+                        end
+                        if aIds.empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:identifier')
+                        end
+
+                        # citation - cited responsible party [{CI_ResponsibleParty}]
+                        # contacts are grouped by role in the internal object
+                        # output a separate <gmd:contact> for each role:contact pairing
+                        aRParties = hCitation[:responsibleParties]
+                        aRParties.each do |hRParty|
+                           role = hRParty[:roleName]
+                           aParties = hRParty[:parties]
+                           aParties.each do |hParty|
+                              @xml.tag!('gmd:citedResponsibleParty') do
+                                 rPartyClass.writeXML(role, hParty)
+                              end
+                           end
+                        end
+                        if aRParties.empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:citedResponsibleParty')
+                        end
+
+                        # citation - presentation forms [{CI_PresentationFormCode}]
+                        aPresForms = hCitation[:presentationForms]
+                        aPresForms.each do |presForm|
+                           @xml.tag!('gmd:presentationForm') do
+                              codelistClass.writeXML('gmd', 'iso_presentationForm', presForm)
+                           end
+                        end
+                        if aPresForms.empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:presentationForm')
+                        end
+
+                        # citation - series {CI_Series}
+                        hSeries = hCitation[:series]
+                        unless hSeries.empty?
+                           @xml.tag!('gmd:series') do
+                              seriesClass.writeXML(hSeries)
+                           end
+                        end
+                        if hSeries.empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:series')
+                        end
+
+                        # citation - other citation details
+                        aOther = hCitation[:otherDetails]
+                        unless aOther.empty?
+                           other = aOther[0]
+                           @xml.tag!('gmd:otherCitationDetails') do
+                              @xml.tag!('gco:CharacterString', other)
+                           end
+                        end
+                        if aOther.empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:otherCitationDetails')
+                        end
+
+                        # citation - ISBN
+                        unless isbn == ''
+                           @xml.tag!('gmd:ISBN') do
+                              @xml.tag!('gco:CharacterString', isbn)
+                           end
+                        end
+                        if isbn == '' && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:ISBN')
+                        end
+
+                        # citation - ISSN
+                        unless issn == ''
+                           @xml.tag!('gmd:ISSN') do
+                              @xml.tag!('gco:CharacterString', issn)
+                           end
+                        end
+                        if issn == '' && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gmd:ISSN')
+                        end
+
+                     end
+                  end
+
+               end # write XML
+            end # CI_Citation
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/iso19110/classes/class_date.rb

@@ -0,0 +1,60 @@
+# ISO <<Class>> CI_Date
+# 19115-2 writer output in XML
+
+# History:
+# 	Stan Smith 2017-11-02 original script
+
+require_relative 'class_codelist'
+require_relative 'class_gcoDateTime'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Iso19110
+
+            class CI_Date
+
+               def initialize(xml, hResponseObj)
+                  @xml = xml
+                  @hResponseObj = hResponseObj
+               end
+
+               def writeXML(hDate)
+
+                  # classes used
+                  codelistClass = MD_Codelist.new(@xml, @hResponseObj)
+                  gcoDateTimeClass = GcoDateTime.new(@xml, @hResponseObj)
+
+                  date = hDate[:date]
+                  dateType = hDate[:dateType]
+
+                  @xml.tag!('gmd:CI_Date') do
+
+                     # date - date (required)
+                     unless date.nil?
+                        @xml.tag!('gmd:date') do
+                           gcoDateTimeClass.writeXML(hDate)
+                        end
+                     end
+                     if date.nil?
+                        @xml.tag!('gmd:date', {'gco:nilReason' => 'missing'})
+                     end
+
+                     # date - date type (required)
+                     unless dateType.nil?
+                        @xml.tag!('gmd:dateType') do
+                           codelistClass.writeXML('gmd', 'iso_dateType', dateType)
+                        end
+                     end
+                     if dateType.nil?
+                        @xml.tag!('gmd:dateType', {'gco:nilReason' => 'missing'})
+                     end
+
+                  end # CI_Date tag
+               end # write XML
+            end # CI_Date class
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/iso19110/classes/class_definitionReference.rb

@@ -0,0 +1,45 @@
+# ISO <<Class>> FC_DefinitionReference
+# 19110 writer output in XML
+
+# History:
+# 	Stan Smith 2017-11-02 original script.
+
+require_relative 'class_citation'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Iso19110
+
+            class FC_DefinitionReference
+
+               def initialize(xml, hResponseObj)
+                  @xml = xml
+                  @hResponseObj = hResponseObj
+               end
+
+               def writeXML(hReference)
+
+                  # classes used
+                  citationClass = CI_Citation.new(@xml, @hResponseObj)
+
+                  unless hReference.empty?
+                     @xml.tag!('gfc:FC_DefinitionReference') do
+                        @xml.tag!('gfc:definitionSource') do
+                           @xml.tag!('gfc:FC_DefinitionSource') do
+                              @xml.tag!('gfc:source') do
+                                 citationClass.writeXML(hReference)
+                              end
+                           end
+                        end
+
+                     end
+                  end
+
+               end # write XML
+            end # FC_DefinitionReference
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/iso19110/classes/class_domain.rb

@@ -0,0 +1,107 @@
+# ISO <<Class>> <<abstract>>
+# writer output in XML
+# to define the domain of an attribute
+
+# History:
+#  Stan Smith 2017-11-02 original script
+
+require_relative 'class_listedValue'
+require_relative 'class_definitionReference'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Iso19110
+
+            class Domain
+
+               def initialize(xml, responseObj)
+                  @xml = xml
+                  @hResponseObj = responseObj
+               end
+
+               def writeXML(hDomain)
+
+                  # classes used
+                  listClass = FC_ListedValue.new(@xml, @hResponseObj)
+                  defRefClass = FC_DefinitionReference.new(@xml, @hResponseObj)
+
+                  # if have domainItems treat as enumerated list
+                  aItems = hDomain[:domainItems]
+                  unless aItems.empty?
+                     aItems.each do |hItem|
+                        @xml.tag!('gfc:listedValue') do
+                           listClass.writeXML(hItem)
+                        end
+                     end
+                     return
+                  end
+
+                  # if have domainReference treat as codeList reference
+                  hCitation = hDomain[:domainReference]
+                  unless hCitation.empty?
+                     @xml.tag!('gfc:listedValue') do
+                        @xml.tag!('gfc:FC_ListedValue') do
+
+                           # label
+                           if hDomain[:domainName].nil?
+                              @xml.tag!('gfc:label', {'gco:nilReason' => 'missing'})
+                           else
+                              @xml.tag!('gfc:label') do
+                                 @xml.tag!('gco:CharacterString', hDomain[:domainName])
+                              end
+                           end
+
+                           # definition
+                           unless hDomain[:domainDescription].nil?
+                              @xml.tag!('gfc:definition') do
+                                 @xml.tag!('gco:CharacterString', hDomain[:domainDescription])
+                              end
+                           end
+                           if hDomain[:domainDescription].empty? && @hResponseObj[:writerShowTags]
+                              @xml.tag!('gfc:definition')
+                           end
+
+                           # definition reference
+                           @xml.tag!('gfc:definitionReference') do
+                              defRefClass.writeXML(hCitation)
+                           end
+
+                        end
+                     end
+                     return
+                  end
+
+                  # if have definition only treat as unrepresentable domain
+                  @xml.tag!('gfc:listedValue') do
+                     @xml.tag!('gfc:FC_ListedValue') do
+
+                        # label
+                        if hDomain[:domainName].nil?
+                           @xml.tag!('gfc:label', {'gco:nilReason' => 'missing'})
+                        else
+                           @xml.tag!('gfc:label') do
+                              @xml.tag!('gco:CharacterString', hDomain[:domainName])
+                           end
+                        end
+
+                        # definition
+                        unless hDomain[:domainDescription].nil?
+                           @xml.tag!('gfc:definition') do
+                              @xml.tag!('gco:CharacterString', hDomain[:domainDescription])
+                           end
+                        end
+                        if hDomain[:domainDescription].empty? && @hResponseObj[:writerShowTags]
+                           @xml.tag!('gfc:definition')
+                        end
+
+                     end
+                  end
+
+               end # writeXML
+            end # FC_ListedValue class
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/iso19110/classes/class_fcFeatureCatalogue.rb

@@ -2,12 +2,12 @@
 # writer output in XML
 
 # History:
-#   Stan Smith 2017-01-20 refactored for mdJson/mdTranslator 2.0
-#   Stan Smith 2015-07-14 refactored to eliminate namespace globals $WriterNS and $IsoNS
-#   Stan Smith 2015-07-14 refactored to make iso19110 independent of iso19115_2 classes
-#   Stan Smith 2015-06-22 replace global ($response) with passed in object (responseObj)
-#   Stan Smith 2014-12-29 set builder object '@xml' into string 'metadata'
-#   Stan Smith 2014-12-15 refactored to handle namespacing readers and writers
+#  Stan Smith 2017-01-20 refactored for mdJson/mdTranslator 2.0
+#  Stan Smith 2015-07-14 refactored to eliminate namespace globals $WriterNS and $IsoNS
+#  Stan Smith 2015-07-14 refactored to make iso19110 independent of iso19115_2 classes
+#  Stan Smith 2015-06-22 replace global ($response) with passed in object (responseObj)
+#  Stan Smith 2014-12-29 set builder object '@xml' into string 'metadata'
+#  Stan Smith 2014-12-15 refactored to handle namespacing readers and writers
 # 	Stan Smith 2013-12-01 original script
 
 require_relative 'class_locale'
@@ -15,190 +15,190 @@ require_relative 'class_responsibleParty'
 require_relative 'class_featureType'
 
 module ADIWG
-    module Mdtranslator
-        module Writers
-            module Iso19110
-
-                class FC_FeatureCatalogue
-
-                    def initialize(xml, responseObj)
-                        @xml = xml
-                        @hResponseObj = responseObj
-                    end
-
-                    def writeXML(intObj)
-
-                        # classes used
-                        localeClass = PT_Locale.new(@xml, @hResponseObj)
-                        rPartyClass = CI_ResponsibleParty.new(@xml, @hResponseObj)
-                        featureClass = FC_FeatureType.new(@xml, @hResponseObj)
-
-                        hDictionary = intObj[:dataDictionaries][0]
-                        hCitation = hDictionary[:citation]
-                        aEntities = hDictionary[:entities]
-                        version = @hResponseObj[:translatorVersion]
-
-                        # document head
-                        metadata = @xml.instruct! :xml, encoding: 'UTF-8'
-                        @xml.comment!('ISO 19110 METADATA')
-                        @xml.comment!('Metadata file was constructed using the ADIwg mdTranslator, http://mdtranslator.adiwg.org')
-                        @xml.comment!('mdTranslator software is an open-source project of the Alaska Data Integration working group (ADIwg)')
-                        @xml.comment!('mdTranslator and other metadata tools are available at https://github.com/adiwg')
-                        @xml.comment!('ADIwg is not responsible for the content of this metadata record')
-                        @xml.comment!('This metadata record was generated by mdTranslator ' + version + ' at ' + Time.now.to_s)
-
-                        # FC_FeatureCatalogue
-                        @xml.tag!('gfc:FC_FeatureCatalogue',
-                                  {'xmlns:gmi' => 'http://www.isotc211.org/2005/gmi',
-                                   'xmlns:gmd' => 'http://www.isotc211.org/2005/gmd',
-                                   'xmlns:gco' => 'http://www.isotc211.org/2005/gco',
-                                   'xmlns:gml' => 'http://www.opengis.net/gml/3.2',
-                                   'xmlns:gsr' => 'http://www.isotc211.org/2005/gsr',
-                                   'xmlns:gss' => 'http://www.isotc211.org/2005/gss',
-                                   'xmlns:gst' => 'http://www.isotc211.org/2005/gst',
-                                   'xmlns:gmx' => 'http://www.isotc211.org/2005/gmx',
-                                   'xmlns:gfc' => 'http://www.isotc211.org/2005/gfc',
-                                   'xmlns:xlink' => 'http://www.w3.org/1999/xlink',
-                                   'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
-                                   'xsi:schemaLocation' => 'http://www.isotc211.org/2005/gfc ftp://ftp.ncddc.noaa.gov/pub/Metadata/Online_ISO_Training/Intro_to_ISO/schemas/ISObio/gfc/gfc.xsd'}) do
-
-                            # local schema for development
-                            # 'xsi:schemaLocation' => 'http://www.isotc211.org/2005/gfc C:\Users\StanSmith\Projects\ISO\19115\NOAA\schema\gfc\gfc.xsd'}) do
-
-                            # remote schema for publication
-                            # 'xsi:schemaLocation' => 'http://www.isotc211.org/2005/gfc ftp://ftp.ncddc.noaa.gov/pub/Metadata/Online_ISO_Training/Intro_to_ISO/schemas/ISObio/gfc/gfc.xsd'}) do
-
-                            # feature catalogue - name, version, version date are
-                            # are taken from citation
-                            name = hCitation[:title]
-                            version = hCitation[:edition]
-                            hDate = {}
-                            aDates = hCitation[:dates]
-                            unless aDates.empty?
-                                hDate = aDates[0]
-                            end
-
-                            # feature catalogue - name (required)
-                            unless name.nil?
-                                @xml.tag!('gmx:name') do
-                                    @xml.tag!('gco:CharacterString', name)
-                                end
-                            end
-                            if name.nil?
-                                @xml.tag!('gmx:name', {'gco:nilReason' => 'missing'})
-                            end
-
-                            # feature catalogue - scope (required) []
-                            aScopes = hDictionary[:subjects]
-                            aScopes.each do |scope|
-                                @xml.tag!('gmx:scope') do
-                                    @xml.tag!('gco:CharacterString', scope)
-                                end
-                            end
-                            if aScopes.empty? && @hResponseObj[:writerShowTags]
-                                @xml.tag!('gmx:scope', {'gco:nilReason' => 'missing'})
-                            end
-
-                            # feature catalogue - field of application []
-                            aUses = hDictionary[:recommendedUses]
-                            aUses.each do |use|
-                                @xml.tag!('gmx:fieldOfApplication') do
-                                    @xml.tag!('gco:CharacterString', use)
-                                end
-                            end
-                            if aUses.empty? && @hResponseObj[:writerShowTags]
-                                @xml.tag!('gmx:fieldOfApplication')
-                            end
-
-                            # feature catalogue - version number (required)
-                            unless version.nil?
-                                @xml.tag!('gmx:versionNumber') do
-                                    @xml.tag!('gco:CharacterString', version)
-                                end
-                            end
-                            if version.nil?
-                                @xml.tag!('gmx:versionNumber', {'gco:nilReason' => 'missing'})
-                            end
-
-                            # feature catalogue - version date (required)
-                            sDate = nil
-                            unless hDate.empty?
-                                dateTime = hDate[:date]
-                                dateRes = hDate[:dateResolution]
-                                unless dateTime.nil?
-                                    sDate = AdiwgDateTimeFun.stringDateFromDateTime(dateTime, dateRes)
-                                end
-                            end
-                            unless sDate.nil?
-                                @xml.tag!('gmx:versionDate') do
-                                    @xml.tag!('gco:Date', sDate)
-                                end
-                            end
-                            if sDate.nil?
-                                @xml.tag!('gmx:versionDate', {'gco:nilReason' => 'missing'})
-                            end
-
-                            # feature catalogue - locale []
-                            aLocales = hDictionary[:locales]
-                            aLocales.each do |hLocale|
-                                unless hLocale.empty?
-                                    @xml.tag!('gmx:locale') do
-                                        localeClass.writeXML(hLocale)
-                                    end
-                                end
-                            end
-                            if aLocales.empty? && @hResponseObj[:writerShowTags]
-                                @xml.tag!('gmx:locale')
-                            end
-
-                            # feature catalogue - producer (required) {CI_ResponsibleParty}
-                            hParty = hDictionary[:responsibleParty]
-                            unless hParty.empty?
-                                role = hParty[:roleName]
-                                aParties = hParty[:parties]
-                                unless aParties.empty?
-                                    party = aParties[0]
-                                    @xml.tag!('gfc:producer') do
-                                        rPartyClass.writeXML(role, party)
-                                    end
-                                end
-                            end
-                            if hParty.empty? && @hResponseObj[:writerShowTags]
-                                @xml.tag!('gfc:producer')
-                            end
-
-                            # feature catalogue - functional language
-                            s = hDictionary[:dictionaryFormat]
-                            unless s.nil?
-                                @xml.tag!('gfc:functionalLanguage') do
-                                    @xml.tag!('gco:CharacterString', s)
-                                end
-                            end
-                            if s.nil? && @hResponseObj[:writerShowTags]
-                                @xml.tag!('gfc:functionalLanguage')
-                            end
-
-                            # feature catalogue - feature type (required)
-                            # use feature type to represent date entities
-                            unless aEntities.empty?
-                                aEntities.each do |hEntity|
-                                    @xml.tag!('gfc:featureType') do
-                                        featureClass.writeXML(hEntity)
-                                    end
-                                end
-                            end
-                            if aEntities.empty?
-                                @xml.tag!('gfc:featureType', {'gco:nilReason' => 'missing'})
-                            end
-
-                            return metadata
+   module Mdtranslator
+      module Writers
+         module Iso19110
+
+            class FC_FeatureCatalogue
+
+               def initialize(xml, responseObj)
+                  @xml = xml
+                  @hResponseObj = responseObj
+               end
+
+               def writeXML(intObj)
+
+                  # classes used
+                  localeClass = PT_Locale.new(@xml, @hResponseObj)
+                  rPartyClass = CI_ResponsibleParty.new(@xml, @hResponseObj)
+                  featureClass = FC_FeatureType.new(@xml, @hResponseObj)
+
+                  hDictionary = intObj[:dataDictionaries][0]
+                  hCitation = hDictionary[:citation]
+                  aEntities = hDictionary[:entities]
+                  version = @hResponseObj[:translatorVersion]
+
+                  # document head
+                  metadata = @xml.instruct! :xml, encoding: 'UTF-8'
+                  @xml.comment!('ISO 19110 METADATA')
+                  @xml.comment!('Metadata file was constructed using the ADIwg mdTranslator, http://mdtranslator.adiwg.org')
+                  @xml.comment!('mdTranslator software is an open-source project of the Alaska Data Integration working group (ADIwg)')
+                  @xml.comment!('mdTranslator and other metadata tools are available at https://github.com/adiwg')
+                  @xml.comment!('ADIwg is not responsible for the content of this metadata record')
+                  @xml.comment!('This metadata record was generated by mdTranslator ' + version + ' at ' + Time.now.to_s)
+
+                  # FC_FeatureCatalogue
+                  @xml.tag!('gfc:FC_FeatureCatalogue',
+                            {'xmlns:gmi' => 'http://www.isotc211.org/2005/gmi',
+                             'xmlns:gmd' => 'http://www.isotc211.org/2005/gmd',
+                             'xmlns:gco' => 'http://www.isotc211.org/2005/gco',
+                             'xmlns:gml' => 'http://www.opengis.net/gml/3.2',
+                             'xmlns:gsr' => 'http://www.isotc211.org/2005/gsr',
+                             'xmlns:gss' => 'http://www.isotc211.org/2005/gss',
+                             'xmlns:gst' => 'http://www.isotc211.org/2005/gst',
+                             'xmlns:gmx' => 'http://www.isotc211.org/2005/gmx',
+                             'xmlns:gfc' => 'http://www.isotc211.org/2005/gfc',
+                             'xmlns:xlink' => 'http://www.w3.org/1999/xlink',
+                             'xmlns:xsi' => 'http://www.w3.org/2001/XMLSchema-instance',
+                             'xsi:schemaLocation' => 'http://www.isotc211.org/2005/gfc ftp://ftp.ncddc.noaa.gov/pub/Metadata/Online_ISO_Training/Intro_to_ISO/schemas/ISObio/gfc/gfc.xsd'}) do
+
+                     # local schema for development
+                     # 'xsi:schemaLocation' => 'http://www.isotc211.org/2005/gfc C:\Users\StanSmith\Projects\ISO\19115\NOAA\schema\gfc\gfc.xsd'}) do
+
+                     # remote schema for publication
+                     # 'xsi:schemaLocation' => 'http://www.isotc211.org/2005/gfc ftp://ftp.ncddc.noaa.gov/pub/Metadata/Online_ISO_Training/Intro_to_ISO/schemas/ISObio/gfc/gfc.xsd'}) do
+
+                     # feature catalogue - name, version, version date are
+                     # are taken from citation
+                     name = hCitation[:title]
+                     version = hCitation[:edition]
+                     hDate = {}
+                     aDates = hCitation[:dates]
+                     unless aDates.empty?
+                        hDate = aDates[0]
+                     end
+
+                     # feature catalogue - name (required)
+                     unless name.nil?
+                        @xml.tag!('gmx:name') do
+                           @xml.tag!('gco:CharacterString', name)
                         end
+                     end
+                     if name.nil?
+                        @xml.tag!('gmx:name', {'gco:nilReason' => 'missing'})
+                     end
+
+                     # feature catalogue - scope (required) []
+                     aScopes = hDictionary[:subjects]
+                     aScopes.each do |scope|
+                        @xml.tag!('gmx:scope') do
+                           @xml.tag!('gco:CharacterString', scope)
+                        end
+                     end
+                     if aScopes.empty? && @hResponseObj[:writerShowTags]
+                        @xml.tag!('gmx:scope', {'gco:nilReason' => 'missing'})
+                     end
+
+                     # feature catalogue - field of application []
+                     aUses = hDictionary[:recommendedUses]
+                     aUses.each do |use|
+                        @xml.tag!('gmx:fieldOfApplication') do
+                           @xml.tag!('gco:CharacterString', use)
+                        end
+                     end
+                     if aUses.empty? && @hResponseObj[:writerShowTags]
+                        @xml.tag!('gmx:fieldOfApplication')
+                     end
+
+                     # feature catalogue - version number (required)
+                     unless version.nil?
+                        @xml.tag!('gmx:versionNumber') do
+                           @xml.tag!('gco:CharacterString', version)
+                        end
+                     end
+                     if version.nil?
+                        @xml.tag!('gmx:versionNumber', {'gco:nilReason' => 'missing'})
+                     end
+
+                     # feature catalogue - version date (required)
+                     sDate = nil
+                     unless hDate.empty?
+                        dateTime = hDate[:date]
+                        dateRes = hDate[:dateResolution]
+                        unless dateTime.nil?
+                           sDate = AdiwgDateTimeFun.stringDateFromDateTime(dateTime, dateRes)
+                        end
+                     end
+                     unless sDate.nil?
+                        @xml.tag!('gmx:versionDate') do
+                           @xml.tag!('gco:Date', sDate)
+                        end
+                     end
+                     if sDate.nil?
+                        @xml.tag!('gmx:versionDate', {'gco:nilReason' => 'missing'})
+                     end
+
+                     # feature catalogue - locale []
+                     aLocales = hDictionary[:locales]
+                     aLocales.each do |hLocale|
+                        unless hLocale.empty?
+                           @xml.tag!('gmx:locale') do
+                              localeClass.writeXML(hLocale)
+                           end
+                        end
+                     end
+                     if aLocales.empty? && @hResponseObj[:writerShowTags]
+                        @xml.tag!('gmx:locale')
+                     end
+
+                     # feature catalogue - producer (required) {CI_ResponsibleParty}
+                     hParty = hDictionary[:responsibleParty]
+                     unless hParty.empty?
+                        role = hParty[:roleName]
+                        aParties = hParty[:parties]
+                        unless aParties.empty?
+                           party = aParties[0]
+                           @xml.tag!('gfc:producer') do
+                              rPartyClass.writeXML(role, party)
+                           end
+                        end
+                     end
+                     if hParty.empty? && @hResponseObj[:writerShowTags]
+                        @xml.tag!('gfc:producer')
+                     end
+
+                     # feature catalogue - functional language
+                     s = hDictionary[:dictionaryFormat]
+                     unless s.nil?
+                        @xml.tag!('gfc:functionalLanguage') do
+                           @xml.tag!('gco:CharacterString', s)
+                        end
+                     end
+                     if s.nil? && @hResponseObj[:writerShowTags]
+                        @xml.tag!('gfc:functionalLanguage')
+                     end
+
+                     # feature catalogue - feature type (required)
+                     # use feature type to represent date entities
+                     unless aEntities.empty?
+                        aEntities.each do |hEntity|
+                           @xml.tag!('gfc:featureType') do
+                              featureClass.writeXML(hEntity)
+                           end
+                        end
+                     end
+                     if aEntities.empty?
+                        @xml.tag!('gfc:featureType', {'gco:nilReason' => 'missing'})
+                     end
 
-                    end
+                     return metadata
+                  end
 
-                end
+               end
 
             end
-        end
-    end
+
+         end
+      end
+   end
 end