adiwg-mdtranslator 2.2.0 → 2.3.0

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_orderProcess.rb

@@ -0,0 +1,79 @@
+# Reader - fgdc to internal data structure
+# unpack fgdc distribution order process
+
+# History:
+#  Stan Smith 2017-09-08 original script
+
+require 'nokogiri'
+require 'adiwg/mdtranslator/internal/internal_metadata_obj'
+require_relative 'module_digitalForm'
+
+module ADIWG
+   module Mdtranslator
+      module Readers
+         module Fgdc
+
+            module OrderProcess
+
+               def self.unpack(xOrder, hDistributor, hResponseObj)
+
+                  # instance classes needed in script
+                  intMetadataClass = InternalMetadata.new
+                  hOrder = intMetadataClass.newOrderProcess
+
+                  # distribution 6.4.1 (nondig) - non-digital form
+                  # -> place as offline option
+                  # -> distribution.distributor.transferOption.offlineOption.note
+                  nonDigital = xOrder.xpath('./nondig').text
+                  unless nonDigital.empty?
+                     hTransfer = intMetadataClass.newTransferOption
+                     hOffline = intMetadataClass.newMedium
+                     hOffline[:note] = nonDigital
+                     hTransfer[:offlineOptions] << hOffline
+                     hDistributor[:transferOptions] << hTransfer
+                  end
+
+                  # distribution 6.4.2 (digform) - digital form []
+                  axDigital = xOrder.xpath('./digform')
+                  unless axDigital.empty?
+                     axDigital.each do |xDigiForm|
+                        hReturn = DigitalForm.unpack(xDigiForm, hResponseObj)
+                        unless hReturn.nil?
+                           hDistributor[:transferOptions] << hReturn
+                        end
+                     end
+                  end
+
+                  # distribution 6.4.3 (fees) - fees
+                  # -> distribution.distributor.orderProcess.fees
+                  fees = xOrder.xpath('./fees').text
+                  unless fees.empty?
+                     hOrder[:fees] = fees
+                  end
+
+                  # distribution 6.4.4 (ordering) - ordering information
+                  # -> distribution.distributor.orderProcess.orderingInstructions
+                  instructions = xOrder.xpath('./ordering').text
+                  unless instructions.empty?
+                     hOrder[:orderingInstructions] = instructions
+                  end
+
+                  # distribution 6.4.5 (turnarnd) - turnaround time
+                  # -> distribution.distributor.orderProcess.turnaround
+                  turnaround = xOrder.xpath('./turnarnd').text
+                  unless turnaround.empty?
+                     hOrder[:turnaround] = turnaround
+                  end
+
+                  hDistributor[:orderProcess] << hOrder
+
+                  return hDistributor
+
+               end
+
+            end
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_pointVector.rb

@@ -0,0 +1,102 @@
+# Reader - fgdc to internal data structure
+# unpack fgdc point and vector data organization
+
+# History:
+#  Stan Smith 2017-09-01 original script
+
+require 'nokogiri'
+require 'adiwg/mdtranslator/internal/internal_metadata_obj'
+
+module ADIWG
+   module Mdtranslator
+      module Readers
+         module Fgdc
+
+            module PointVector
+
+               def self.unpack(xPtVec, hResourceInfo, hResponseObj)
+
+                  # instance classes needed in script
+                  intMetadataClass = InternalMetadata.new
+
+                  # point and vector object 3.3.1 (sdtsterm) - SDTS term []
+                  axSDTSterm = xPtVec.xpath('./sdtsterm')
+                  unless axSDTSterm.empty?
+                     hVectorInfo = intMetadataClass.newVectorInfo
+
+                     axSDTSterm.each do |xTerm|
+                        hVectorObj = intMetadataClass.newVectorObject
+
+                        # SDTS term 3.3.1.1 (sdtstype) - point and vector object type
+                        # -> spatialRepresentation.vectorInfo.vectorObject.objectType
+                        sdtsType = xTerm.xpath('./sdtstype').text
+                        unless sdtsType.empty?
+                           hVectorObj[:objectType] = sdtsType
+                        end
+
+                        # SDTS term 3.3.1.2 (ptvctcnt) - point and vector object count
+                        # -> spatialRepresentation.vectorInfo.vectorObject.objectCount
+                        ptvCount = xTerm.xpath('./ptvctcnt').text
+                        unless ptvCount.empty?
+                           hVectorObj[:objectCount] = ptvCount.to_i
+                        end
+
+                        hVectorInfo[:vectorObject] << hVectorObj
+                     end
+
+                     hSpatialRepresentation = intMetadataClass.newSpatialRepresentation
+                     hSpatialRepresentation[:vectorRepresentation] = hVectorInfo
+                     hResourceInfo[:spatialRepresentations] << hSpatialRepresentation
+                  end
+
+                  # point and vector object 3.3.2 (vpfterm) - VPF terms description
+                  xVPFterm = xPtVec.xpath('./vpfterm')
+                  unless xVPFterm.empty?
+                     hVectorInfo = intMetadataClass.newVectorInfo
+
+                     # VPF term 3.3.2.1 (vpflevel) - VPF topology level
+                     # -> spatialRepresentation.vectorInfo.topologyLevel
+                     level = xVPFterm.xpath('vpflevel').text
+                     unless level.empty?
+                        hVectorInfo[:topologyLevel] = level.to_i
+                     end
+
+                     # VPF term 3.3.2.2 (vpfinfo) - VPF point and vector object information []
+                     axVPFInfo = xVPFterm.xpath('./vpfinfo')
+                     unless axVPFInfo.empty?
+                        axVPFInfo.each do |xInfo|
+                           hVectorObj = intMetadataClass.newVectorObject
+
+                           # VPF point and object 3.3.2.2.1 (vpftype) - VPF point and vector object type
+                           # -> spatialRepresentation.vectorInfo.vectorObject.objectType
+                           vpfType = xInfo.xpath('./vpftype').text
+                           unless vpfType.empty?
+                              hVectorObj[:objectType] = vpfType
+                           end
+
+                           # VPF point and object 3.3.2.2.2 (ptvctcnt) - VPF point and vector object count
+                           # -> spatialRepresentation.vectorInfo.vectorObject.objectCount
+                           vpfCount = xInfo.xpath('./ptvctcnt').text
+                           unless vpfCount.empty?
+                              hVectorObj[:objectCount] = vpfCount.to_i
+                           end
+
+                           hVectorInfo[:vectorObject] << hVectorObj
+                        end
+
+                        hSpatialRepresentation = intMetadataClass.newSpatialRepresentation
+                        hSpatialRepresentation[:vectorRepresentation] = hVectorInfo
+                        hResourceInfo[:spatialRepresentations] << hSpatialRepresentation
+                     end
+
+                  end
+
+                  return hResourceInfo
+
+               end
+            end
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_range.rb

@@ -0,0 +1,50 @@
+# Reader - fgdc to internal data structure
+# unpack fgdc entity range domain
+
+# History:
+#  Stan Smith 2017-09-06 original script
+
+require 'nokogiri'
+require 'adiwg/mdtranslator/internal/internal_metadata_obj'
+
+module ADIWG
+   module Mdtranslator
+      module Readers
+         module Fgdc
+
+            module Range
+
+               def self.unpack(xRange, hAttribute, hResponseObj)
+
+                  # entity attribute 5.1.2.4.2.1 (rdommin) - range minimum
+                  # -> dataDictionary.entities.attributes.minValue
+                  min = xRange.xpath('./rdommin').text
+                  unless min.empty?
+                     hAttribute[:minValue] = min
+                  end
+
+                  # entity attribute 5.1.2.4.2.2 (rdommax) - range maximum
+                  # -> dataDictionary.entities.attributes.maxValue
+                  max = xRange.xpath('./rdommax').text
+                  unless max.empty?
+                     hAttribute[:maxValue] = max
+                  end
+
+                  # entity attribute 5.1.2.4.2.3 (attrunit) - units of measure
+                  # -> dataDictionary.entities.attributes.unitOfMeasure
+                  units = xRange.xpath('./attrunit').text
+                  unless units.empty?
+                     hAttribute[:unitOfMeasure] = units
+                  end
+
+                  # entity attribute 5.1.2.4.2.4 (attrmres) - measurement resolution
+                  # -> not mapped
+
+               end
+
+            end
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_raster.rb

@@ -0,0 +1,84 @@
+# Reader - fgdc to internal data structure
+# unpack fgdc raster data organization
+
+# History:
+#  Stan Smith 2017-09-01 original script
+
+require 'nokogiri'
+require 'adiwg/mdtranslator/internal/internal_metadata_obj'
+
+module ADIWG
+   module Mdtranslator
+      module Readers
+         module Fgdc
+
+            module Raster
+
+               def self.unpack(xRaster, hResourceInfo, hResponseObj)
+
+                  # instance classes needed in script
+                  intMetadataClass = InternalMetadata.new
+                  hSpatialRepresentation = intMetadataClass.newSpatialRepresentation
+                  hGridInfo = intMetadataClass.newGridInfo
+
+                  # raster object 3.4.1 (rasttype) - raster object type
+                  # -> spatialRepresentation.gridInfo.numberOfDimensions per NOAA
+                  # -> FGDC and ISO definitions do not match on this element
+                  # -> however elements do match on  spatialRepresentation.gridInfo.cellGeometry
+                  cellGeometry = xRaster.xpath('./rasttype').text
+                  unless cellGeometry.empty?
+                     hGridInfo[:cellGeometry] = cellGeometry.downcase
+                  end
+
+                  # -> make number of dimensions from total occurrence of 3.4.2-4
+                  hGridInfo[:numberOfDimensions] = 0
+
+                  # raster object 3.4.2 (rowcount) - row count
+                  # -> spatialRepresentation.gridInfo.dimension.dimensionSize
+                  # -> spatialRepresentation.gridInfo.dimension.dimensionType = row
+                  rows = xRaster.xpath('./rowcount').text
+                  unless rows.empty?
+                     hDimension = intMetadataClass.newDimension
+                     hDimension[:dimensionType] = 'row'
+                     hDimension[:dimensionSize] = rows.to_i
+                     hGridInfo[:dimension] << hDimension
+                     hGridInfo[:numberOfDimensions] += 1
+                  end
+
+                  # raster object 3.4.3 (colcount) - column count
+                  # -> spatialRepresentation.gridInfo.dimension.dimensionSize
+                  # -> spatialRepresentation.gridInfo.dimension.dimensionType = column
+                  columns = xRaster.xpath('./colcount').text
+                  unless columns.empty?
+                     hDimension = intMetadataClass.newDimension
+                     hDimension[:dimensionType] = 'column'
+                     hDimension[:dimensionSize] = columns.to_i
+                     hGridInfo[:dimension] << hDimension
+                     hGridInfo[:numberOfDimensions] += 1
+                  end
+
+                  # raster object 3.4.4 (vrtcount) - vertical count
+                  # -> spatialRepresentation.gridInfo.dimension.dimensionSize
+                  # -> spatialRepresentation.gridInfo.dimension.dimensionType = vertical
+                  verts = xRaster.xpath('./vrtcount').text
+                  unless verts.empty?
+                     hDimension = intMetadataClass.newDimension
+                     hDimension[:dimensionType] = 'vertical'
+                     hDimension[:dimensionSize] = verts.to_i
+                     hGridInfo[:dimension] << hDimension
+                     hGridInfo[:numberOfDimensions] += 1
+                  end
+
+                  hSpatialRepresentation[:gridRepresentation] = hGridInfo
+                  hResourceInfo[:spatialRepresentations] << hSpatialRepresentation
+
+                  return hResourceInfo
+
+               end
+
+            end
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_spatialOrganization.rb

@@ -6,6 +6,8 @@
 
 require 'nokogiri'
 require 'adiwg/mdtranslator/internal/internal_metadata_obj'
+require_relative 'module_pointVector'
+require_relative 'module_raster'
 
 module ADIWG
    module Mdtranslator
@@ -14,12 +16,56 @@ module ADIWG
 
             module SpatialOrganization
 
-               def self.unpack(xSpatialOrg, hResponseObj)
+               def self.unpack(xSpatialOrg, hResourceInfo, hResponseObj)
 
+                  # instance classes needed in script
+                  intMetadataClass = InternalMetadata.new
 
+                  # spatial organization 3.1 (indspref) - indirect spatial reference
+                  # -> resourceInfo.spatialReferenceSystems.spatialReferenceSystem.systemIdentifier.identifier per NOAA
+                  # -> however definitions are not close
+                  indirect = xSpatialOrg.xpath('./indspref').text
+                  unless indirect.empty?
+                     hSystem = intMetadataClass.newSpatialReferenceSystem
+                     hIdentifier = intMetadataClass.newIdentifier
+                     hIdentifier[:identifier] = indirect
+                     hSystem[:systemIdentifier] = hIdentifier
+                     hResourceInfo[:spatialReferenceSystems] << hSystem
+                  end
 
-               end
+                  # spatial organization 3.2 (direct) - direct spatial reference method
+                  # -> resourceInfo.spatialRepresentationTypes, translate FGDC to ISO as:
+                  # -> point = vector do 3.3
+                  # -> vector = vector do 3.3
+                  # -> raster = grid do 3.4
+                  direct = xSpatialOrg.xpath('./direct').text
+                  unless direct.empty?
+                     type = 'vector' if direct == 'Point'
+                     type = 'vector' if direct == 'Vector'
+                     type = 'grid' if direct == 'Raster'
+                     hResourceInfo[:spatialRepresentationTypes] << type
+
+                     # spatial organization 3.3 (ptvctinfo) - point and vector object
+                     if type == 'vector'
+                        xPtVec = xSpatialOrg.xpath('./ptvctinf')
+                        unless xPtVec.empty?
+                           PointVector.unpack(xPtVec, hResourceInfo, hResponseObj)
+                        end
+                     end
+
+                     # spatial organization 3.4 (rastinfo) - raster object
+                     if type == 'grid'
+                        xRaster = xSpatialOrg.xpath('./rastinfo')
+                        unless xRaster.empty?
+                           Raster.unpack(xRaster, hResourceInfo, hResponseObj)
+                        end
+                     end
 
+                  end
+
+                  return hResourceInfo
+
+               end
             end
 
          end

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_timePeriod.rb

@@ -54,7 +54,26 @@ module ADIWG
                      end
 
                      # time period 9.2 (mdattim) - multiple date times
-                     # placed in temporal extent
+                     # take first date
+                     xMulti = xTimeInfo.xpath('./mdattim')
+                     unless xMulti.empty?
+                        axSingle = xMulti.xpath('./sngdate')
+
+                        # use first occurrence of the multiple date times
+                        unless axSingle.empty?
+                           xSingle = axSingle[0]
+                           date = xSingle.xpath('./caldate').text
+                           time = xSingle.xpath('./time').text
+                           hDateTime = DateTime.unpack(date, time, hResponseObj)
+                           unless hDateTime.nil?
+                              hTimePeriod[:startDateTime] = hDateTime
+                           end
+                           hTimePeriod[:description] = current
+
+                           return hTimePeriod
+
+                        end
+                     end
 
                      # time period 9.3 (rngdates) - range of dates
                      xRange = xTimeInfo.xpath('./rngdates')

data/lib/adiwg/mdtranslator/readers/fgdc/modules/module_transferInfo.rb

@@ -0,0 +1,87 @@
+# Reader - fgdc to internal data structure
+# unpack fgdc distribution digital transfer information
+
+# History:
+#  Stan Smith 2017-09-09 original script
+
+require 'nokogiri'
+require 'adiwg/mdtranslator/internal/internal_metadata_obj'
+require_relative 'module_date'
+
+module ADIWG
+   module Mdtranslator
+      module Readers
+         module Fgdc
+
+            module TransferInfo
+
+               def self.unpack(xTranInfo, hTransfer, hResponseObj)
+
+                  # instance classes needed in script
+                  intMetadataClass = InternalMetadata.new
+                  hFormat = intMetadataClass.newResourceFormat
+                  hSpecification = intMetadataClass.newCitation
+                  hFormat[:formatSpecification] = hSpecification
+                  hTransfer[:distributionFormats] << hFormat
+
+                  # distribution 6.4.2.1.1 (formname) - format name
+                  # -> distribution.distributor.transferOption.distributionFormat.formatSpecification.title
+                  title = xTranInfo.xpath('./formname').text
+                  unless title.empty?
+                     hSpecification[:title] = title
+                  end
+
+                  # distribution 6.4.2.1.2 (formvern) - format version number
+                  # -> distribution.distributor.transferOption.distributionFormat.formatSpecification.edition
+                  version = xTranInfo.xpath('./formvern').text
+                  unless version.empty?
+                     hSpecification[:edition] = version
+                  end
+
+                  # distribution 6.4.2.1.3 (formverd) - format version date
+                  # -> distribution.distributor.transferOption.distributionFormat.formatSpecification.date(version)
+                  date = xTranInfo.xpath('./formverd').text
+                  unless date.empty?
+                     hDate = Date.unpack(date, '', 'revision', hResponseObj)
+                     unless hDate.nil?
+                        hSpecification[:dates] << hDate
+                     end
+                  end
+
+                  # distribution 6.4.2.1.4 (formspec) - format specification
+                  # -> distribution.distributor.transferOption.distributionFormat.formatSpecification.otherCitationDetails
+                  specification = xTranInfo.xpath('./formspec').text
+                  unless specification.empty?
+                     hSpecification[:otherDetails] << specification
+                  end
+
+                  # distribution 6.4.2.1.5 (formcont) - format information content
+                  # -> distribution.distributor.transferOption.distributionFormat.formatSpecification.otherCitationDetails
+                  specification = xTranInfo.xpath('./formcont').text
+                  unless specification.empty?
+                     hSpecification[:otherDetails] << specification
+                  end
+
+                  # distribution 6.4.2.1.6 (filedec) - file decompression technique
+                  # -> distribution.distributor.transferOption.distributionFormat.compressionMethod
+                  compress = xTranInfo.xpath('./filedec').text
+                  unless compress.empty?
+                     hFormat[:compressionMethod] = compress
+                  end
+
+                  # distribution 6.4.2.1.7 (transize) - file transfer size in MB
+                  # -> distribution.distributor.transferOption.transferSize
+                  size = xTranInfo.xpath('./transize').text
+                  unless size.empty?
+                     hTransfer[:transferSize] = size.to_i
+                  end
+
+                  return hTransfer
+
+               end
+            end
+
+         end
+      end
+   end
+end