adiwg-mdtranslator 1.4.0 → 2.0.0rc2

data/lib/adiwg/mdtranslator/writers/iso19115_2/classes/class_timeInstant.rb

@@ -1,12 +1,15 @@
 # ISO <<Class>> TimeInstant
-# writer output in XML
+# 19115-2 writer output in XML
 
 # History:
-# 	Stan Smith 2013-11-04 original script.
-#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
-#   Stan Smith 2014-12-12 refactored to handle namespacing readers and writers
-#   Stan Smith 2015-07-14 refactored to make iso19110 independent of iso19115_2 classes
+#   Stan Smith 2016-12-01 refactored for mdTranslator/mdJson 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 2014-12-12 refactored to handle namespacing readers and writers
+#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
+# 	Stan Smith 2013-11-04 original script.
+
+require_relative 'class_gmlIdentifier'
 
 module ADIWG
     module Mdtranslator
@@ -15,41 +18,61 @@ module ADIWG
 
                 class TimeInstant
 
-                    def initialize(xml, responseObj)
+                    def initialize(xml, hResponseObj)
                         @xml = xml
-                        @responseObj = responseObj
+                        @hResponseObj = hResponseObj
                     end
 
-                    def writeXML(hTempI)
+                    def writeXML(hInstant)
+
+                        # classes used
+                        gmlClass =  GMLIdentifier.new(@xml, @hResponseObj)
 
-                        timeID = hTempI[:timeId]
+                        # TimeInstant requires a unique ID
+                        timeID = hInstant[:timeId]
                         if timeID.nil?
-                            @responseObj[:writerMissingIdCount] = @responseObj[:writerMissingIdCount].succ
-                            timeID = 'timeInstant' + @responseObj[:writerMissingIdCount]
+                            @hResponseObj[:writerMissingIdCount] = @hResponseObj[:writerMissingIdCount].succ
+                            timeID = 'timeInstant' + @hResponseObj[:writerMissingIdCount]
                         end
 
                         @xml.tag!('gml:TimeInstant', {'gml:id' => timeID}) do
 
                             # time instant - description
-                            s = hTempI[:description]
+                            s = hInstant[:description]
                             if !s.nil?
                                 @xml.tag!('gml:description', s)
-                            elsif @responseObj[:writerShowTags]
+                            elsif @hResponseObj[:writerShowTags]
                                 @xml.tag!('gml:description')
                             end
 
+                            # time instant - identifier {gmlIdentifier}
+                            hGMLid = hInstant[:identifier]
+                            unless hGMLid.empty?
+                                gmlClass.writeXML(hGMLid)
+                            end
+                            if hGMLid.empty? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gml:identifier', {'codeSpace'=>''})
+                            end
+
+                            # time instant - names []
+                            aNames = hInstant[:instantNames]
+                            aNames.each do |name|
+                                @xml.tag!('gml:name', name)
+                            end
+                            if aNames.empty? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gml:name')
+                            end
+
                             # time instant - time position
-                            hDateTime = hTempI[:timePosition]
+                            hDateTime = hInstant[:timeInstant]
                             timeInstant = hDateTime[:dateTime]
                             timeResolution = hDateTime[:dateResolution]
                             dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(timeInstant, timeResolution)
                             @xml.tag!('gml:timePosition', dateStr)
 
-                        end
-
-                    end
-
-                end
+                        end # TimeInstant tag
+                    end # writeXML
+                end # TimeInstant class
 
             end
         end

data/lib/adiwg/mdtranslator/writers/iso19115_2/classes/class_timePeriod.rb

@@ -1,13 +1,16 @@
 # ISO <<Class>> TimePeriod
-# writer output in XML
+# 19115-2 writer output in XML
 
 # History:
-# 	Stan Smith 2013-11-04 original script.
-#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
-#   Stan Smith 2014-12-12 refactored to handle namespacing readers and writers
-#   Stan Smith 2015-06-22 replace global ($response) with passed in object (responseObj)
-#   Stan Smith 2015-07-14 refactored to make iso19110 independent of iso19115_2 classes
+#   Stan Smith 2016-11-30 refactored for mdTranslator/mdJson 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 (hResponseObj)
+#   Stan Smith 2014-12-12 refactored to handle namespacing readers and writers
+#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
+# 	Stan Smith 2013-11-04 original script.
+
+require_relative 'class_gmlIdentifier'
 
 module ADIWG
     module Mdtranslator
@@ -16,48 +19,96 @@ module ADIWG
 
                 class TimePeriod
 
-                    def initialize(xml, responseObj)
+                    def initialize(xml, hResponseObj)
                         @xml = xml
-                        @responseObj = responseObj
+                        @hResponseObj = hResponseObj
                     end
 
-                    def writeXML(hTempP)
+                    def writeXML(hPeriod)
+
+                        # classes used
+                        gmlClass =  GMLIdentifier.new(@xml, @hResponseObj)
 
-                        timeID = hTempP[:timeId]
+                        # TimePeriod must have a uniqueID
+                        timeID = hPeriod[:timeId]
                         if timeID.nil?
-                            @responseObj[:writerMissingIdCount] = @responseObj[:writerMissingIdCount].succ
-                            timeID = 'timePeriod' + @responseObj[:writerMissingIdCount]
+                            @hResponseObj[:writerMissingIdCount] = @hResponseObj[:writerMissingIdCount].succ
+                            timeID = 'timePeriod' + @hResponseObj[:writerMissingIdCount]
                         end
 
                         @xml.tag!('gml:TimePeriod', {'gml:id' => timeID}) do
 
                             # time period - description
-                            s = hTempP[:description]
-                            if !s.nil?
+                            s = hPeriod[:description]
+                            unless s.nil?
                                 @xml.tag!('gml:description', s)
-                            elsif @responseObj[:writerShowTags]
+                            end
+                            if s.nil? && @hResponseObj[:writerShowTags]
                                 @xml.tag!('gml:description')
                             end
 
+                            # time period - identifier {gmlIdentifier}
+                            hGMLid = hPeriod[:identifier]
+                            unless hGMLid.empty?
+                                gmlClass.writeXML(hGMLid)
+                            end
+                            if hGMLid.empty? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gml:identifier', {'codeSpace'=>''})
+                            end
+
+                            # time period - names []
+                            aNames = hPeriod[:periodNames]
+                            aNames.each do |name|
+                                @xml.tag!('gml:name', name)
+                            end
+                            if aNames.empty? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gml:name')
+                            end
+
                             # time period - begin position
-                            hDateTime = hTempP[:beginTime]
-                            timeInstant = hDateTime[:dateTime]
-                            timeResolution = hDateTime[:dateResolution]
-                            dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(timeInstant, timeResolution)
-                            @xml.tag!('gml:beginPosition', dateStr)
+                            # tag required, however value may be empty
+                            unless hPeriod[:startDateTime].empty?
+                                hDateTime = hPeriod[:startDateTime]
+                                dateTime = hDateTime[:dateTime]
+                                timeResolution = hDateTime[:dateResolution]
+                                dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(dateTime, timeResolution)
+                                @xml.tag!('gml:beginPosition', dateStr)
+                            end
+                            if hPeriod[:startDateTime].empty?
+                                @xml.tag!('gml:beginPosition')
+                            end
 
                             # time period - begin position
-                            hDateTime = hTempP[:endTime]
-                            timeInstant = hDateTime[:dateTime]
-                            timeResolution = hDateTime[:dateResolution]
-                            dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(timeInstant, timeResolution)
-                            @xml.tag!('gml:endPosition', dateStr)
+                            # tag required, however value may be empty
+                            unless hPeriod[:endDateTime].empty?
+                                hDateTime = hPeriod[:endDateTime]
+                                dateTime = hDateTime[:dateTime]
+                                timeResolution = hDateTime[:dateResolution]
+                                dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(dateTime, timeResolution)
+                                @xml.tag!('gml:endPosition', dateStr)
+                            end
+                            if hPeriod[:endDateTime].empty?
+                                @xml.tag!('gml:endPosition')
+                            end
 
-                        end
+                            # time period - time interval
+                            hInterval = hPeriod[:timeInterval]
+                            unless hInterval.empty?
+                                units = hInterval[:units]
+                                interval = hInterval[:interval]
+                                @xml.tag!('gml:timeInterval', {'unit'=>units}, interval)
+                            end
 
-                    end
+                            # time period - duration (do not output if have time interval)
+                            hDuration = hPeriod[:duration]
+                            if hInterval.empty? && !hDuration.empty?
+                                duration = AdiwgDateTimeFun.writeDuration(hDuration)
+                                @xml.tag!('gml:duration', duration)
+                            end
 
-                end
+                        end # TimePeriod tag
+                    end # writeXML
+                end # TimePeriod class
 
             end
         end

data/lib/adiwg/mdtranslator/writers/iso19115_2/classes/class_transferOptions.rb

@@ -0,0 +1,91 @@
+# ISO <<Class>> MD_DigitalTransferOptions
+# 19115-2 writer output in XML
+
+# History:
+#   Stan Smith 2016-12-07 refactored for mdTranslator/mdJson 2.0
+#   Stan Smith 2015-09-21 added transfer size
+#   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 (hResponseObj)
+#   Stan Smith 2014-12-12 refactored to handle namespacing readers and writers
+#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
+# 	Stan Smith 2013-09-26 original script
+
+require_relative 'class_onlineResource'
+require_relative 'class_medium'
+
+module ADIWG
+    module Mdtranslator
+        module Writers
+            module Iso19115_2
+
+                class MD_DigitalTransferOptions
+
+                    def initialize(xml, hResponseObj)
+                        @xml = xml
+                        @hResponseObj = hResponseObj
+                    end
+
+                    def writeXML(hOption)
+
+                        # classes used
+                        olResClass =  CI_OnlineResource.new(@xml, @hResponseObj)
+                        medClass =  MD_Medium.new(@xml, @hResponseObj)
+
+                        @xml.tag!('gmd:MD_DigitalTransferOptions') do
+
+                            # digital transfer options - units of distribution
+                            s = hOption[:unitsOfDistribution]
+                            unless s.nil?
+                                @xml.tag!('gmd:unitsOfDistribution') do
+                                    @xml.tag!('gco:CharacterString', s)
+                                end
+                            end
+                            if s.nil? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gmd:unitsOfDistribution')
+                            end
+
+                            # digital transfer options - transfer size {MB}
+                            s = hOption[:transferSize]
+                            unless s.nil?
+                                @xml.tag!('gmd:transferSize') do
+                                    @xml.tag!('gco:Real', s.to_s)
+                                end
+                            end
+                            if s.nil? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gmd:transferSize')
+                            end
+
+                            # digital transfer options - online [] {CI_OnlineResource}
+                            aOnTranOpts = hOption[:onlineOptions]
+                            aOnTranOpts.each do |hOlOption|
+                                @xml.tag!('gmd:onLine') do
+                                    olResClass.writeXML(hOlOption)
+                                end
+                            end
+                            if aOnTranOpts.empty? &&@hResponseObj[:writerShowTags]
+                                @xml.tag!('gmd:onLine')
+                            end
+
+                            # digital transfer options - offline {MD_Medium}
+                            aOffTranOpt = hOption[:offlineOptions]
+                            unless aOffTranOpt.empty?
+                                hOffTranOpt = aOffTranOpt[0]
+                                unless hOffTranOpt.empty?
+                                    @xml.tag!('gmd:offLine') do
+                                        medClass.writeXML(hOffTranOpt)
+                                    end
+                                end
+                            end
+                            if aOffTranOpt.empty? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gmd:offLine')
+                            end
+
+                        end # gmd:MD_DigitalTransferOptions tag
+                    end # writeXML
+                end # MD_DigitalTransferOptions class
+
+            end
+        end
+    end
+end

data/lib/adiwg/mdtranslator/writers/iso19115_2/classes/class_unitsOfMeasure.rb

@@ -1,5 +1,5 @@
 # ISO <<Class>> UnitsOfMeasure
-# writer output in XML
+# 19115-2 writer output in XML
 
 # History:
 # 	Stan Smith 2015-08-27 copied from 19110 writer
@@ -16,9 +16,9 @@ module ADIWG
 
                 class UnitsOfMeasure
 
-                    def initialize(xml, responseObj)
+                    def initialize(xml, hResponseObj)
                         @xml = xml
-                        @responseObj = responseObj
+                        @hResponseObj = hResponseObj
                     end
 
                     def writeUnits(unit)
@@ -65,7 +65,7 @@ module ADIWG
                                 hBase[:catalogSymbol] = 'deg'
                                 hBase[:unitsSystem] = 'http://www.opengis.net/def/uom/OGC/1.0/degree'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'm', 'meter', 'meters', 'metre'
@@ -73,7 +73,7 @@ module ADIWG
                                 hBase[:name] = 'meter'
                                 hBase[:catalogSymbol] = 'm'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'kg', 'kilogram', 'kilograms'
@@ -81,7 +81,7 @@ module ADIWG
                                 hBase[:name] = 'kilogram'
                                 hBase[:catalogSymbol] = 'kg'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 's', 'second', 'seconds'
@@ -89,7 +89,7 @@ module ADIWG
                                 hBase[:name] = 'second'
                                 hBase[:catalogSymbol] = 'd'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'A', 'ampere', 'amperes'
@@ -97,7 +97,7 @@ module ADIWG
                                 hBase[:name] = 'ampere'
                                 hBase[:catalogSymbol] = 'A'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'K', 'kelvin'
@@ -105,7 +105,7 @@ module ADIWG
                                 hBase[:name] = 'kelvin'
                                 hBase[:catalogSymbol] = 'K'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'mol', 'mole', 'moles'
@@ -113,7 +113,7 @@ module ADIWG
                                 hBase[:name] = 'mole'
                                 hBase[:catalogSymbol] = 'mol'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'cd', 'candela', 'candelas'
@@ -121,7 +121,7 @@ module ADIWG
                                 hBase[:name] = 'candela'
                                 hBase[:catalogSymbol] = 'cd'
 
-                                baseClass = BaseUnit.new(@xml, @responseObj)
+                                baseClass = BaseUnit.new(@xml, @hResponseObj)
                                 baseClass.writeXML(hBase)
 
                             when 'ft', 'foot', 'feet'
@@ -131,7 +131,7 @@ module ADIWG
                                 hConvent[:preferredUnit] = 'meter'
                                 hConvent[:factor] = 3.280839
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'in', 'inch', 'inches'
@@ -141,7 +141,7 @@ module ADIWG
                                 hConvent[:preferredUnit] = 'meter'
                                 hConvent[:factor] = 0.0254
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'mm', 'millimeter', 'millimeters'
@@ -151,7 +151,7 @@ module ADIWG
                                 hConvent[:preferredUnit] = 'meter'
                                 hConvent[:factor] = 0.001
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'micrometer','micrometers'
@@ -164,7 +164,7 @@ module ADIWG
                                 hConvent[:preferredUnit] = 'meter'
                                 hConvent[:factor] = 0.000001
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'nm', 'nanometer', 'nanometers'
@@ -174,7 +174,7 @@ module ADIWG
                                 hConvent[:preferredUnit] = 'meter'
                                 hConvent[:factor] = 0.000000001
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'degC', 'centigrade', 'degreesC', 'Celsius'
@@ -187,7 +187,7 @@ module ADIWG
                                 hConvent[:c] = 1
                                 hConvent[:d] = 0
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'degF', 'degreesF', 'Fahrenheit'
@@ -200,7 +200,7 @@ module ADIWG
                                 hConvent[:c] = 9
                                 hConvent[:d] = 0
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'mph', 'miles per hour'
@@ -213,7 +213,7 @@ module ADIWG
                                 hConvent[:c] = 0
                                 hConvent[:d] = 3600.0
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'kph', 'kilometers per hour'
@@ -226,7 +226,7 @@ module ADIWG
                                 hConvent[:c] = 0
                                 hConvent[:d] = 3600
 
-                                convClass = ConventionalUnit.new(@xml, @responseObj)
+                                convClass = ConventionalUnit.new(@xml, @hResponseObj)
                                 convClass.writeXML(hConvent)
 
                             when 'density'
@@ -240,11 +240,11 @@ module ADIWG
                                 unitTerms << {'uom' => 'm', 'exponent' => '-3'}
                                 hDerived[:derivationUnitTerm] = unitTerms
 
-                                dervClass = DerivedUnit.new(@xml, @responseObj)
+                                dervClass = DerivedUnit.new(@xml, @hResponseObj)
                                 dervClass.writeXML(hDerived)
 
                             else
-                                defnClass = UnitDefinition.new(@xml, @responseObj)
+                                defnClass = UnitDefinition.new(@xml, @hResponseObj)
                                 defnClass.writeXML(unit)
 
                         end

data/lib/adiwg/mdtranslator/writers/iso19115_2/classes/class_usage.rb

@@ -1,13 +1,14 @@
 # ISO <<Class>> MD_Usage
-# writer output in XML
+# 19115-2 writer output in XML
 
 # History:
-# 	Stan Smith 2013-11-19 original script.
-#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
-#   Stan Smith 2014-12-12 refactored to handle namespacing readers and writers
-#   Stan Smith 2015-06-22 replace global ($response) with passed in object (responseObj)
-#   Stan Smith 2015-07-14 refactored to make iso19110 independent of iso19115_2 classes
+#   Stan Smith 2016-12-12 refactored for mdTranslator/mdJson 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 (hResponseObj)
+#   Stan Smith 2014-12-12 refactored to handle namespacing readers and writers
+#   Stan Smith 2014-07-08 modify require statements to function in RubyGem structure
+# 	Stan Smith 2013-11-19 original script.
 
 require_relative 'class_responsibleParty'
 
@@ -18,55 +19,96 @@ module ADIWG
 
                 class MD_Usage
 
-                    def initialize(xml, responseObj)
+                    def initialize(xml, hResponseObj)
                         @xml = xml
-                        @responseObj = responseObj
+                        @hResponseObj = hResponseObj
                     end
 
                     def writeXML(hUsage)
 
                         # classes used in MD_Usage
-                        rPartyClass = CI_ResponsibleParty.new(@xml, @responseObj)
+                        partyClass = CI_ResponsibleParty.new(@xml, @hResponseObj)
 
                         @xml.tag!('gmd:MD_Usage') do
 
-                            # usage - specific usage - required
+                            # usage - specific usage (required)
                             s = hUsage[:specificUsage]
-                            if s.nil?
-                                @xml.tag!('gmd:specificUsage', {'gco:nilReason' => 'missing'})
-                            else
+                            unless s.nil?
                                 @xml.tag!('gmd:specificUsage') do
                                     @xml.tag!('gco:CharacterString', s)
                                 end
                             end
+                            if s.nil?
+                                @xml.tag!('gmd:specificUsage', {'gco:nilReason' => 'missing'})
+                            end
+
+                            # usage - dateTime [0]
+                            aTimes = hUsage[:temporalExtents]
+                            dateStr = nil
+                            unless aTimes.empty?
+                                hTime = aTimes[0]
+                                unless hTime.empty?
+                                    hInstant = hTime[:timeInstant]
+                                    hPeriod = hTime[:timePeriod]
+                                    unless hInstant.empty?
+                                        hDateTime = hInstant[:timeInstant]
+                                        timeInstant = hDateTime[:dateTime]
+                                        timeResolution = hDateTime[:dateResolution]
+                                        dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(timeInstant, timeResolution)
+                                        hPeriod = {}
+                                    end
+                                    unless hPeriod.empty?
+                                        hStart = hPeriod[:startDateTime]
+                                        hEnd = hPeriod[:endDateTime]
+                                        if !hStart.empty?
+                                            dateTime = hStart[:dateTime]
+                                            timeResolution = hStart[:dateResolution]
+                                        else
+                                            dateTime = hEnd[:dateTime]
+                                            timeResolution = hEnd[:dateResolution]
+                                        end
+                                        dateStr = AdiwgDateTimeFun.stringDateTimeFromDateTime(dateTime, timeResolution)
+                                    end
+                                end
+                            end
+                            unless dateStr.nil?
+                                @xml.tag!('gmd:usageDateTime') do
+                                    @xml.tag!('gco:DateTime', dateStr)
+                                end
+                            end
+                            if dateStr.nil? && @hResponseObj[:writerShowTags]
+                                @xml.tag!('gmd:usageDateTime')
+                            end
 
                             # usage - user determined limitations
-                            s = hUsage[:userLimits]
-                            if !s.nil?
+                            s = hUsage[:userLimitation]
+                            unless s.nil?
                                 @xml.tag!('gmd:userDeterminedLimitations') do
                                     @xml.tag!('gco:CharacterString', s)
                                 end
-                            elsif @responseObj[:writerShowTags]
+                            end
+                            if s.nil? && @hResponseObj[:writerShowTags]
                                 @xml.tag!('gmd:userDeterminedLimitations')
                             end
 
-                            # usage - user contact info - responsible party
-                            aContacts = hUsage[:userContacts]
-                            if !aContacts.empty?
-                                aContacts.each do |rParty|
+                            # usage - user contact info (required (optional -1)) [{CI_ResponsibleParty}]
+                            aParties = hUsage[:userContacts]
+                            aParties.each do |hRParty|
+                                role = hRParty[:roleName]
+                                aParties = hRParty[:parties]
+                                aParties.each do |hParty|
                                     @xml.tag!('gmd:userContactInfo') do
-                                        rPartyClass.writeXML(rParty)
+                                        partyClass.writeXML(role, hParty)
                                     end
                                 end
-                            elsif @responseObj[:writerShowTags]
-                                @xml.tag!('gmd:userContactInfo')
+                            end
+                            if aParties.empty?
+                                @xml.tag!('gmd:userContactInfo', {'gco:nilReason' => 'missing'})
                             end
 
-                        end
-
-                    end
-
-                end
+                        end # gmd:MD_Usage tag
+                    end # writeXML
+                end # MD_Usage class
 
             end
         end