adiwg-mdtranslator 2.21.0.pre.beta.0 → 2.21.0.pre.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 24a46249aaab639bcbfcf96546503546a9474db0aaf8d3d9136190cbd7ae2c19
-  data.tar.gz: da85309bcd6c126043a653d5e436535d7d29c4eb2107a416acb1cdc4575d3696
+  metadata.gz: b6d6f205260d7cd279df45c873810e05a328d4fd8915be617b29c4c57044af13
+  data.tar.gz: fcfc19da4c41bc3b93b528f57122119cc12d8f988e3afc9553f4275f639cd833
 SHA512:
-  metadata.gz: 966ff66ba5977d8f190b38535637cf43b0d346291ed81928179814b8bbb081a2967d56bba02f80847525e0f86fce8c0e1d405d71fbd7dcf1338c7cc5e2c2a31c
-  data.tar.gz: ae9ec9bd0c85646c0b7b99d79adda40be5ea40de1bb14eb133471028a3b9800b86138591abf2e1c87d6c3bc8e5e07741a66f816755558823cdc76697d30b9845
+  metadata.gz: '097c2bf2ffdcfc10e63b16d44cdf72fc9e30c0cdebeab4366e07eae6d0c13dc52b782c3882d17516c8843cb19e7cecc2c064aa8e89dd56cbeccb254acae4e8f1'
+  data.tar.gz: 14fab38df050287ba08b0337aeaf9ebc4c2e42a113a63709cff0019f7dc3ba761534c35586e055aef57b5b147cfb4571eb466cd5a208f90da431aa3e09742309

data/.github/workflows/test.yml

@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: ruby/setup-ruby@ec02537da5712d66d4d50a0f33b7eb52773b5ed1
+      - uses: ruby/setup-ruby@v1
         with:
           ruby-version: "3.1" # Not needed with a .ruby-version file
       - run: bundle install

data/DCAT-US.md

@@ -0,0 +1,67 @@
+# DCAT-US - mdTranslator proposed mappings
+## Quick references
+  - DCAT-US [element definitions](https://resources.data.gov/resources/dcat-us/)
+  - DCAT-US v1.1 [catalog.json schema](https://resources.data.gov/schemas/dcat-us/v1.1/schema/catalog.json)
+  - DCAT-US v1.1 [dataset.json schema](https://resources.data.gov/schemas/dcat-us/v1.1/schema/dataset.json)
+  - DCAT-US v1.1 [JSON-LD catalog.json schema](https://resources.data.gov/schemas/dcat-us/v1.1/schema/catalog.jsonld)
+  - [Element crosswalks](https://resources.data.gov/resources/podm-field-mapping/#field-mappings) to other standards
+
+## DCAT-US - mdTranslator
+
+### Always (always required)
+
+| Field Name | DCAT Name | Condition | mdJson Source |
+| --- | --- | --- | --- |
+| Title | title | exists | citation.title |
+| Description | description | exists | resourceInfo.abstract |
+| Tags | keyword | exists | [resourceInfo.keyword.keyword[0, n] *flatten*] |
+| Last Update | modified | if resourceInfo.citation.date[any].dateType = "lastUpdated" or "lastRevised" or "revision" | resourceInfo.citation.date[most recent] |
+| Publisher | publisher{name} | if citation.responsibleParty.[any].role = "publisher" |  contactId -> contact.name where isOrganization IS TRUE |
+| | | if exists resourceDistribution.distributor.contact | [first contact] contactId -> contact.name where isOrganization IS TRUE |
+| Publisher Parent Organization | publisher{subOrganizationOf} | if citation.responsibleParty[any].role = "publisher" and exists contactId -> memberOfOrganization[0] and isOrganization is true | contactId -> contact.name |
+| | | if exists resourceDistribution.distributor.contact and exists contactId -> memberOfOrganization[0] and isOrganization IS TRUE | contactId -> contact.name |
+| Contact Name | contactPoint{fn} | exists | resourceInfo.pointOfContact.parties[0].contactId -> contact.name |
+| Contact Email | contactPoint{email} | exists | resourceInfo.pointOfContact.parties[0].contactId -> contact.eMailList[0] |
+| Unique Identifier | identifier | if resourceInfo.citation.identifier.namespace = "DOI" | resourceInfo.citation.onlineResource.uri |
+| | | if "DOI" within resourceInfo.citation.onlineResource.uri | resourceInfo.citation.onlineResource.uri |
+| Public Access Level | accessLevel | [*extend codelist MD_RestrictionCode to include "public",  "restricted  public", "non-public"*] <br> if resourceInfo.constraints.legal[any] one of {"public", "restricted public", "non-public"} | resourceInfo.constraints.legal[first]. Also resourceInfo.constraint.security.classification [[MD_ClassificationCode](https://mdtools.adiwg.org/#codes-page?c=iso_classification)] |
+| Bureau Code | bureauCode | | [*extend role codelist to include "bureau", extend namespace codelist to include "bureauCode"*] <br> for each resourceInfo.citation.responsibleParty[any] role = "bureau" <br>contactId -> contact.identifier [*identifier must conform to https://resources.data.gov/schemas/dcat-us/v1.1/omb_bureau_codes.csv*] |
+| Program Code | programCode | | [*add new element of program resourceInfo.programCode, add new codelist of programCode*] <br> resourceInfo.program[0,n] |
+
+### If-Applicable (required if it exists)
+
+| Field Name | DCAT Name | Condition | mdJson Source |
+| --- | --- | --- | --- |
+| Distribution | distribution | if exists resourceDistribution[any] and if exists resourceDistribution.distributor[any].transferOption[any].onlineOption[any].uri <br> for each resourceDistribution[0, n] where exists resourceDistribution.distributor.transferOption.onlineOption.uri then <br> {description, accessURL, downloadURL, mediaType, title} |
+| - Description | distribution.description | exists | resourceDistribution.description |
+| - AccessURL | distribution.accessURL | if citation.onlineResources[first occurence].uri [path ends in ".html"] [*required if applicable*] | resourceDistribution.distributor.transferOption.onlineOption.uri |
+| - DownloadURL | dcat.distribution.downloadURL | if citation.onlineResources[first occurence].uri [path does not end in ".html"] [*required if applicable*] |resourceDistribution.distributor.transferOption.onlineOption.uri |
+| - MediaType | distribution.mediaType | [*add codelist of "dataFormat"*] <br> transferOption.distributionFormat.formatSpecification.title [dataFormat] [*dataFormat should conform to: https://www.iana.org/assignments/media-types/media-types.xhtml*] |
+| - Title | distribution.title | exists | resourceDistribution.distributor.transferOption.onlineOption.name |
+| License | license | [*add resourceInfo.constraint.reference to mdEditor*] <br> if exists resourceInfo.constraint.reference[0] | resourceInfo.constraint.reference[0] <br> |
+| | | else | https://creativecommons.org/publicdomain/zero/1.0/ <br> [*allows author to identify a license to use, or default to CC0 if none provided, CC0 would cover international usage as opposed to publicdomain*] <br> [*others: http://www.usa.gov/publicdomain/label/1.0/, http://opendatacommons.org/licenses/pddl/1.0*] |
+| Rights | rights | if constraint.accessLevel in {"restricted public", "non-public"} | resourceInfo.constraint.releasibility.statement + " " + each constraint.releasibility.dessiminationConstraint[0, n] |
+| Endpoint | *removed* | *ignored* | *ignored* |
+| Spatial | spatial | if exists resourceInfo.extents[0].geographicExtents[0].boundingBox | boundingBox.eastLongitude + "," + boundingBox.southLatitude + "," + boundingBox.westLongitude + "," + boundingBox.northLatitude [*decimal degrees*] |
+| | | else | if exists resourceInfo.extents[0].geographicExtents[0].geographicElement[0].type = "point" then <br> geographicElement[0].coordinate[1] + "," + geographicElement[0].coordinate[0] [*lat, long decimal degrees*] |
+| Temporal | temporal | if exists resourceInfo.extent[0].temporalExtent[0] then <br> if exists tempororalExtent[0].timePeriod.startDate and exists temporaralExtent[0].timePeriod.endDate | timePeriod[0].startDate + "/" + timePeriod.endDate |
+| | | if exists  tempororalExtent[0].timePeriod.startDate and not exists temporaralExtent[0].timePeriod.endDate | tempororalExtent[0].timePeriod.startDate |
+| | | if not exists temporalExtent[0].timePeriod.startDate and exists temporaralExtent[0].timePeriod.endDate | tempororalExtent[0].timePeriod.endDate <br> [*may need revisiting relative to decision on date only formatting*] |
+
+### No (not required)
+
+| Field Name | DCAT Name | Condition | mdJson Source |
+| --- | --- | --- | --- |
+| Release Date | issued | if resourceInfo.citation.date[any].dateType = "publication" or "distributed" | resourceInfo.citation.date[earliest] |
+| Frequency | accrualPeriodicity | | [*ISO codelist MD_maintenanceFrequency can be used and several codes intersect with accrualPeriod codelist they are partially corresponding. A column of ISO8601 code equivalents could be added to MD_maintenanceFrequency to provide the coding expected https://resources.data.gov/schemas/dcat-us/v1.1/iso8601_guidance/#accrualperiodicity, community valuation should be determined*]  |
+| Language | language | | [*language codelist could be used but needs to be bound with country corresponding to the RFC 5646 format https://datatracker.ietf.org/doc/html/rfc5646, such as "en-US", community valuation should be determined* |
+| Data Quality | dataQuality | | [*this is a boolean to indicate whether data "conforms" to agency standards, value seems negligble*] |
+| Category | theme | where resourceInfo.keyword[any].thesaurus.title = "ISO Topic Category" | [resourceInfo.keyword.keyword[0, n] *flatten*]  |
+| Related Documents | references | | associatedResource[all].resourceCitation.onlineResource[all].uri + additionalDocumentation[all].citation[all].onlineResource[all].uri [*comma separated*]|
+| Homepage URL | landingPage | [*Add code "landingPage" to CI_OnlineFunctionCode*] <br> if resourceInfo.citation.onlineResource[any].function = "landingPage" | resourceInfo.citation.onlineResource.uri |
+| Collection | isPartOf | for each associatedResource[0, n].initiativeType = "collection" and associatedResource.associationType = "collectiveTitle" | associatedResource.resourceCitation[0].uri |
+| System of Records | systemOfRecords | [*Add code "sorn" to DS_InitiativeTypeCode*] <br> for each associatedResource[0, n].initiativeType = "sorn"   | associatedResource.resourceCitation[0].uri |
+| Primary IT Investment | primaryITInvestmentUII | | [*Links data to an IT investment identifier relative to Exhibit 53 docs, community valuation should be determined*] |
+| Data Dictionary | describedBy | if dataDictionary.dictionaryIncludedWithResource IS NOT TRUE and citation.onlineResource[0].uri exists | dataDictionary.citation.onlineResource[0].uri |
+| Data Dictionary Type | describedByType | | [*For simplicity, leave blank implying html page, community decision needed whether to support other format types using mime type and in the form of "application/pdf"*]|
+| Data Standard | conformsTo | | [*Currently not able to identify the schema standard the data conforms to, though this has been proposed. Should this be built and there is community decision to support it, then it can be mapped*] |

data/Gemfile.lock

@@ -1,9 +1,9 @@
 PATH
   remote: .
   specs:
-    adiwg-mdtranslator (2.21.0.pre.beta.0)
-      adiwg-mdcodes (= 2.10.0)
-      adiwg-mdjson_schemas (= 2.10.0.pre.beta.5)
+    adiwg-mdtranslator (2.21.0.pre.beta.1)
+      adiwg-mdcodes (= 2.10.1)
+      adiwg-mdjson_schemas (= 2.10.1)
       builder (~> 3.2)
       coderay (~> 1.1)
       jbuilder (~> 2.5)
@@ -35,9 +35,9 @@ GEM
       tzinfo (~> 2.0)
     addressable (2.8.6)
       public_suffix (>= 2.0.2, < 6.0)
-    adiwg-mdcodes (2.10.0)
+    adiwg-mdcodes (2.10.1)
       json (~> 2.0)
-    adiwg-mdjson_schemas (2.10.0.pre.beta.5)
+    adiwg-mdjson_schemas (2.10.1)
     base64 (0.2.0)
     bigdecimal (3.1.8)
     builder (3.2.4)

data/README.md

@@ -23,6 +23,27 @@ Or install it yourself as:
 
     $ mdtranslator help translate
 
+## Development
+
+### Requirements
+
+Requires
+- [Ruby](https://www.ruby-lang.org/en/documentation/installation/)
+- bundler (`gem install bundler`)
+- rake (`gem install rake`)
+
+### Tests
+
+In order to run the tests, first install the dependencies
+
+    $ bundle install
+
+Then, run the rake command
+
+    $ bundle exec rake
+
+_TODO: There are currently 4 tests that are not passing, related to mdJSON readers and writers_
+
 ## Contributing
 
 1. Fork it ( https://github.com/[my-github-username]/mdTranslator/fork )

data/Rakefile

@@ -23,6 +23,7 @@ Rake::TestTask.new do |t|
       'test/writers/iso19115-3/tc*.rb',
       'test/writers/mdJson/tc*.rb',
       'test/writers/sbJson/tc*.rb',
+      'test/writers/dcat_us/tc*.rb',
       'test/translator/tc*.rb'
    ]
    t.verbose = true

data/adiwg-mdtranslator.gemspec

@@ -34,8 +34,8 @@ Gem::Specification.new do |spec|
    spec.add_runtime_dependency "thor", "~> 0.19"
    spec.add_runtime_dependency "uuidtools", "~> 2.1"
    spec.add_runtime_dependency "json-schema", "~> 2.7"
-   spec.add_runtime_dependency "adiwg-mdjson_schemas", "2.10.0.pre.beta.5"
-   spec.add_runtime_dependency "adiwg-mdcodes", "2.10.0"
+   spec.add_runtime_dependency "adiwg-mdjson_schemas", "2.10.1"
+   spec.add_runtime_dependency "adiwg-mdcodes", "2.10.1"
    spec.add_runtime_dependency "jbuilder", "~> 2.5"
    spec.add_runtime_dependency "kramdown", ">= 1.13", "< 3.0"
    spec.add_runtime_dependency "coderay", "~> 1.1"

data/lib/adiwg/mdtranslator/internal/internal_metadata_obj.rb

@@ -579,6 +579,7 @@ class InternalMetadata
    # data dictionary ------------------------
    def newDataDictionary
       {
+         dictionaryId: nil,
          description: nil,
          subjects: [],
          citation: {},

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

@@ -56,8 +56,10 @@ module ADIWG
                         # data quality 2.1.2.2 (attracce) - Attribute Accuracy Explanation
                         xEvaluationMethod = xQuantitativeAccuracy.xpath('./attracce')
                         unless xEvaluationMethod.empty?
-                           report[:evaluationMethod] = intMetadataClass.newEvaluationMethod
-                           report[:evaluationMethod][:methodDescription] = xEvaluationMethod.text
+                           evaluationMethod = intMetadataClass.newEvaluationMethod
+                           evaluationMethod[:name] = 'Attribute Accuracy Explanation'
+                           evaluationMethod[:methodDescription] = xEvaluationMethod.text
+                           report[:evaluationMethod] << evaluationMethod
                         end
                         hDataQuality[:report] << report unless report[:quantitativeResult].empty? && report[:evaluationMethod].empty?
                      end
@@ -101,35 +103,29 @@ module ADIWG
                      unless xHorizontalAccuracy.empty?
                         report = intMetadataClass.newDataQualityReport
                         report[:type] = 'DQ_AbsoluteExternalPositionalAccuracy'
-                        # data quality 2.4.1.1 (horizpar) - Horizontal Positional Accuracy Report
+                        # Combine Horizontal Positional Accuracy Report and Explanation
+                        descriptive_result_text = ''
                         xHorizontalAccuracyReport = xHorizontalAccuracy.xpath('./horizpar')
                         unless xHorizontalAccuracyReport.empty?
-                           descriptiveResult = intMetadataClass.newDescriptiveResult
-                           descriptiveResult[:name] = 'Horizontal Positional Accuracy Report'
-                           descriptiveResult[:statement] = xHorizontalAccuracyReport.text
-                           report[:descriptiveResult] << descriptiveResult
+                           descriptive_result_text += xHorizontalAccuracyReport.text
                         end
-                        # data quality 2.4.1.2 (qhorizpa) - Quantitative Horizontal Positional Accuracy Assessment
                         xQuantitativeHorizontalAccuracy = xHorizontalAccuracy.xpath('./qhorizpa')
                         unless xQuantitativeHorizontalAccuracy.empty?
-                           # data quality 2.4.1.2.1 (horizpav) - Horizontal Positional Accuracy Value
                            xHorizontalAccuracyValue = xQuantitativeHorizontalAccuracy.xpath('horizpav')
                            unless xHorizontalAccuracyValue.empty?
-                              quantitativeResult = intMetadataClass.newQuantitativeResult
-                              value = xHorizontalAccuracyValue.text
-                              quantitativeResult[:name] = 'Horizontal Positional Accuracy Value'
-                              quantitativeResult[:values] << value
-                              report[:quantitativeResult] << quantitativeResult
+                              descriptive_result_text += " Value: #{xHorizontalAccuracyValue.text}"
                            end
-                           # data quality 2.4.1.2.2 (horizpae) - Horizontal Positional Accuracy Explanation
                            xHorizontalAccuracyExplanation = xQuantitativeHorizontalAccuracy.xpath('horizpae')
                            unless xHorizontalAccuracyExplanation.empty?
-                              descriptiveResult = intMetadataClass.newDescriptiveResult
-                              descriptiveResult[:name] = 'Horizontal Positional Accuracy Explanation'
-                              descriptiveResult[:statement] = xHorizontalAccuracyExplanation.text
-                              report[:descriptiveResult] << descriptiveResult
+                              descriptive_result_text += " Explanation: #{xHorizontalAccuracyExplanation.text}"
                            end
                         end
+                        unless descriptive_result_text.empty?
+                           descriptiveResult = intMetadataClass.newDescriptiveResult
+                           descriptiveResult[:name] = 'Horizontal Positional Accuracy Report'
+                           descriptiveResult[:statement] = descriptive_result_text
+                           report[:descriptiveResult] << descriptiveResult
+                        end
                         hDataQuality[:report] << report
                      end
                      # data quality 2.4.2 (vertacc) - Vertical Positional Accuracy
@@ -137,35 +133,29 @@ module ADIWG
                      unless xVerticalAccuracy.empty?
                         report = intMetadataClass.newDataQualityReport
                         report[:type] = 'DQ_AbsoluteExternalPositionalAccuracy'
-                        # data quality 2.4.2.1 (vertaccr) - Vertical Positional Accuracy Report
+                        # Combine Vertical Positional Accuracy Report and Explanation
+                        descriptive_result_text = ''
                         xVerticalAccuracyReport = xVerticalAccuracy.xpath('./vertaccr')
                         unless xVerticalAccuracyReport.empty?
-                           descriptiveResult = intMetadataClass.newDescriptiveResult
-                           descriptiveResult[:name] = 'Vertical Positional Accuracy Report'
-                           descriptiveResult[:statement] = xVerticalAccuracyReport.text
-                           report[:descriptiveResult] << descriptiveResult
+                           descriptive_result_text += xVerticalAccuracyReport.text
                         end
-                        # data quality 2.4.2.2 (qvertpa) - Quantitative Vertical Positional Accuracy Assessment
                         xVerticalAccuracyAssessment = xVerticalAccuracy.xpath('./qvertpa')
                         unless xVerticalAccuracyAssessment.empty?
-                           # data quality 2.4.2.2.1 (vertaccv) - Vertical Positional Accuracy Value
                            xVerticalAccuracyValue = xVerticalAccuracyAssessment.xpath('vertaccv')
                            unless xVerticalAccuracyValue.empty?
-                              quantitativeResult = intMetadataClass.newQuantitativeResult
-                              value = xVerticalAccuracyValue.text
-                              quantitativeResult[:name] = 'Vertical Positional Accuracy Value'
-                              quantitativeResult[:values] << value
-                              report[:quantitativeResult] << quantitativeResult
+                              descriptive_result_text += " Value: #{xVerticalAccuracyValue.text}"
                            end
-                           # data quality 2.4.2.2.2 (vertacce) - Vertical Positional Accuracy Explanation
                            xVerticalAccuracyExplanation = xVerticalAccuracyAssessment.xpath('vertacce')
                            unless xVerticalAccuracyExplanation.empty?
-                              descriptiveResult = intMetadataClass.newDescriptiveResult
-                              descriptiveResult[:name] = 'Vertical Positional Accuracy Explanation'
-                              descriptiveResult[:statement] = xVerticalAccuracyExplanation.text
-                              report[:descriptiveResult] << descriptiveResult
+                              descriptive_result_text += " Explanation: #{xVerticalAccuracyExplanation.text}"
                            end
                         end
+                        unless descriptive_result_text.empty?
+                           descriptiveResult = intMetadataClass.newDescriptiveResult
+                           descriptiveResult[:name] = 'Vertical Positional Accuracy Report'
+                           descriptiveResult[:statement] = descriptive_result_text
+                           report[:descriptiveResult] << descriptiveResult
+                        end
                         hDataQuality[:report] << report
                      end
                   end
@@ -190,4 +180,4 @@ module ADIWG
          end
       end
    end
-end
+end

data/lib/adiwg/mdtranslator/readers/mdJson/modules/module_dataDictionary.rb

@@ -38,6 +38,14 @@ module ADIWG
                   intMetadataClass = InternalMetadata.new
                   intDictionary = intMetadataClass.newDataDictionary
 
+                  # dictionary - id 
+                  if hDictionary.has_key?('dictionaryId')
+                     s = hDictionary['dictionaryId']
+                     if s != ''
+                        intDictionary[:dictionaryId] = s
+                     end
+                  end
+
                   # dictionary - description
                   if hDictionary.has_key?('description')
                      s = hDictionary['description']

data/lib/adiwg/mdtranslator/version.rb

@@ -109,7 +109,7 @@
 module ADIWG
    module Mdtranslator
       # current mdtranslator version
-      VERSION = "2.21.0-beta.0"
+      VERSION = "2.21.0-beta.1"
    end
 end
 

data/lib/adiwg/mdtranslator/writers/dcat_us/dcat_us_writer.rb

@@ -0,0 +1,98 @@
+require 'jbuilder'
+require_relative 'version'
+require_relative 'sections/dcat_us_dcat_us'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Dcat_us
+
+            def self.startWriter(intObj, responseObj)
+               # set the contact array for use by the writer
+               @contacts = intObj[:contacts]
+
+               # set output flag for null properties
+               Jbuilder.ignore_nil(!responseObj[:writerShowTags])
+
+               # set the format of the output file based on the writer specified
+               responseObj[:writerOutputFormat] = 'json'
+               responseObj[:writerVersion] = ADIWG::Mdtranslator::Writers::Dcat_us::VERSION
+
+               # write the dcat_us metadata record
+               metadata = Dcat_us.build(intObj, responseObj)
+
+               # set writer pass to true if no messages
+               # false or warning state will be set by writer code
+               responseObj[:writerPass] = true if responseObj[:writerMessages].empty?
+
+               # encode the metadata target as JSON
+               metadata.target!
+            end
+
+            # find contact in contact array and return the contact hash
+            def self.get_contact_by_index(contactIndex)
+               if @contacts[contactIndex]
+                  return @contacts[contactIndex]
+               end
+               {}
+            end
+
+            # find contact in contact array and return the contact hash
+            def self.get_contact_by_id(contactId)
+               @contacts.each do |hContact|
+                  if hContact[:contactId] == contactId
+                     return hContact
+                  end
+               end
+               {}
+            end
+
+            # find contact in contact array and return the contact index
+            def self.get_contact_index_by_id(contactId)
+               @contacts.each_with_index do |hContact, index|
+                  if hContact[:contactId] == contactId
+                     return index
+                  end
+               end
+               {}
+            end
+
+            # ignore jBuilder object mapping when array is empty
+            def self.json_map(collection = [], _class)
+               if collection.nil? || collection.empty?
+                  return nil
+               else
+                  collection.map { |item| _class.build(item).attributes! }
+               end
+            end
+
+            # find all nested objects in 'obj' that contain the element 'ele'
+            def self.nested_objs_by_element(obj, ele, excludeList = [])
+               aCollected = []
+               obj.each do |key, value|
+                  skipThisOne = false
+                  excludeList.each do |exclude|
+                     if key == exclude.to_sym
+                        skipThisOne = true
+                     end
+                  end
+                  next if skipThisOne
+                  if key == ele.to_sym
+                     aCollected << obj
+                  elsif obj.is_a?(Array)
+                     if key.respond_to?(:each)
+                        aReturn = nested_objs_by_element(key, ele, excludeList)
+                        aCollected = aCollected.concat(aReturn) unless aReturn.empty?
+                     end
+                  elsif obj[key].respond_to?(:each)
+                     aReturn = nested_objs_by_element(value, ele, excludeList)
+                     aCollected = aCollected.concat(aReturn) unless aReturn.empty?
+                  end
+               end
+               aCollected
+            end
+
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/dcat_us/readme.md

@@ -0,0 +1,10 @@
+
+## dcat_us
+
+### Supported versions
+
+> 0.0.x (dcat_us is not currently versioned)
+
+### Writer for Data Catalog Vocabulary (DCAT) v1.1
+
+

data/lib/adiwg/mdtranslator/writers/dcat_us/sections/dcat_us_access_level.rb

@@ -0,0 +1,55 @@
+require 'jbuilder'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Dcat_us
+            module AccessLevel
+
+               def self.build(intObj)
+
+                  publicArray = ['unclassified', 'unrestricted', 'licenseUnrestricted', 'licenseEndUser']
+                  nonPublicArray = ['restricted','confidential','secret','topSecret','forOfficialUseOnly','protected','intellectualPropertyRights','restricted','otherRestrictions','private','statutory','confidential','traditionalKnowledge','personallyIdentifiableInformation']
+                  restrictedPublicArray = ['sensitiveButUnclassified','limitedDistribution','copyright','patent','patentPending','trademark','license','licenseDistributor','in-confidence','threatenedOrEndangered']
+
+                  resourceInfo = intObj[:metadata][:resourceInfo]
+                  legalConstraints = resourceInfo[:constraints]&.select { |constraint| constraint[:type] == 'legal' }
+                  securityConstraints = resourceInfo[:constraints]&.select { |constraint| constraint[:type] == 'security' }
+
+                  accessLevelCodes = []
+
+                  # Gather codes from security constraints and legal constraints
+                  unless securityConstraints.empty?
+                     securityConstraints.each do |securityConstraint|
+                        code = securityConstraint[:securityConstraint][:classCode]
+                        accessLevelCodes << code                        
+                     end
+                  end
+                  unless legalConstraints.empty?
+                     legalConstraints.each do |legalConstraint|
+                        codes = legalConstraint.dig(:legalConstraint, :accessCodes)
+                        accessLevelCodes.push(*codes)
+                     end
+                  end
+
+                  # return access level that is most restrictive
+                  accessLevelCodes.uniq.each do |code|
+                     if nonPublicArray.include? code
+                        return 'non-public'
+                     end
+                  end
+                  accessLevelCodes.uniq.each do |code|
+                     if restrictedPublicArray.include? code
+                        return 'restricted public'
+                     end
+                  end
+                  
+                  return 'public'
+               end           
+
+            end
+         end
+      end
+   end
+end
+

data/lib/adiwg/mdtranslator/writers/dcat_us/sections/dcat_us_access_url.rb

@@ -0,0 +1,17 @@
+require 'jbuilder'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Dcat_us
+            module AccessURL
+
+               def self.build(option)
+                  option[:olResURI] if option[:olResURI].end_with?('.html')
+                end                
+
+            end
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/dcat_us/sections/dcat_us_accrualPeriodicity.rb

@@ -0,0 +1,45 @@
+require 'jbuilder'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Dcat_us
+            module AccrualPeriodicity
+
+               def self.build(intObj)
+
+                  frequency_mapping = {
+                     'decennial' => 'R/P10Y',
+                     'quadrennial' => 'R/P4Y',
+                     'annual' => 'R/P1Y',
+                     'bimonthly' => 'R/P2M or R/P0.5M',
+                     'semiweekly' => 'R/P3.5D',
+                     'daily' => 'R/P1D',
+                     'biweekly' => 'R/P2W or R/P0.5W',
+                     'semiannual' => 'R/P6M',
+                     'biennial' => 'R/P2Y',
+                     'triennial' => 'R/P3Y',
+                     'three times a week' => 'R/P0.33W',
+                     'three times a month' => 'R/P0.33M',
+                     'continuously updated' => 'R/PT1S',
+                     'monthly' => 'R/P1M',
+                     'quarterly' => 'R/P3M',
+                     'semimonthly' => 'R/P0.5M',
+                     'three times a year' => 'R/P4M',
+                     'weekly' => 'R/P1W',
+                     'hourly' => 'R/PT1H'
+                  }
+
+                  frequency = intObj[:metadata][:metadataInfo][:metadataMaintenance][:frequency]
+                  
+                  unless frequency.nil?
+                     frequency_code = frequency_mapping[frequency.downcase]
+                  end
+                  return frequency_code
+                end                
+
+            end
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/dcat_us/sections/dcat_us_bureau_code.rb

@@ -0,0 +1,33 @@
+require 'jbuilder'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Dcat_us
+            module BureauCode
+
+               def self.build(intObj)
+                
+                    responsibleParties = intObj[:metadata][:resourceInfo][:citation][:responsibleParties]
+                    contacts = []
+                    responsibleParties.each do |party|
+                        contactId = party[:parties][0][:contactId]
+                        contacts << Dcat_us.get_contact_by_id(contactId)
+                    end
+
+                    bureauContacts = contacts&.select { |contact| contact[:externalIdentifier].any? { |id| id[:namespace] == 'bureauCode'} }
+
+                    bureauCodes = []
+                    bureauContacts.each do |contact|
+                        bureauCode = contact[:externalIdentifier].find { |id| id[:namespace] == 'bureauCode' }
+                        bureauCodes << bureauCode[:identifier]
+                    end
+
+                    return bureauCodes
+                end
+                
+            end
+         end
+      end
+   end
+end

data/lib/adiwg/mdtranslator/writers/dcat_us/sections/dcat_us_contact_point.rb

@@ -0,0 +1,29 @@
+require 'jbuilder'
+
+module ADIWG
+   module Mdtranslator
+      module Writers
+         module Dcat_us
+            module ContactPoint
+
+               def self.build(intObj)
+                  resourceInfo = intObj[:metadata][:resourceInfo]
+                  pointOfContact = resourceInfo[:pointOfContacts][0]
+                  contactId = pointOfContact[:parties][0][:contactId]
+
+                  contact = Dcat_us.get_contact_by_id(contactId)
+                  fn = contact[:name]
+                  hasEmail = contact[:eMailList][0]
+
+                  Jbuilder.new do |json|
+                     json.set!('@type', 'vcard:Contact')
+                     json.set!('fn', fn)
+                     json.set!('hasEmail', hasEmail)
+                  end
+
+               end
+            end
+         end
+      end
+   end
+end