Projects

About

Project: An enterprise (potentially individual but typically collaborative), planned to achieve a particular aim. Use properties from Organization, subOrganization/parentOrganization to indicate project sub-structures.

Research Project

This is what a basic research project data graph might look like. We have the full record below, but this shows some of the basics we would be looking for.

This type is based on the Schema.org type Project which has a sub-type of ResearchProject.

Show code cell source Hide code cell source

import json
from rdflib.extras.external_graph_libs import rdflib_to_networkx_multidigraph
from rdflib.extras.external_graph_libs import rdflib_to_networkx_graph
from pyld import jsonld
import graphviz
import os, sys

currentdir = os.path.dirname(os.path.abspath(''))
parentdir = os.path.dirname(currentdir)
sys.path.insert(0, parentdir)
from lib import jbutils


with open("../../../odis-in/dataGraphs/thematics/projects/graphs/proj.json") as dgraph:
    doc = json.load(dgraph)

frame = {
  "@context": {"@vocab": "https://schema.org/"},
  "@explicit": "true",
  "@requireAll": "true",
  "@type":     "ResearchProject",
  "legalName": "",
  "name": "",
  "url": "",
  "description": "",
  "identifier": {} 
}

context = {
    "@vocab": "https://schema.org/",
}

compacted = jsonld.compact(doc, context)

framed = jsonld.frame(compacted, frame)
jd = json.dumps(framed, indent=4)
print(jd)

jbutils.show_graph(framed)

{
    "@context": {
        "@vocab": "https://schema.org/"
    },
    "@id": "https://example.org/id/resproj/X",
    "@type": [
        "ResearchProject",
        "PropertyValue"
    ],
    "description": "Repo description ... ",
    "identifier": {
        "@id": "https://grid.ac/institutes/grid.475727.4",
        "@type": "PropertyValue",
        "description": "UN Department of Economic and Social Affairs Sustainable Development",
        "propertyID": "https://registry.identifiers.org/registry/grid",
        "url": "https://grid.ac/institutes/grid.475727.4"
    },
    "legalName": "Example Data Repository",
    "name": "ExDaRepo",
    "url": [
        "https://dio.org/id/XYZ",
        "https://www.example-data-repository.org"
    ]
}

Details: Identifier

For each profile there are a few key elements we need to know about. One key element is what the authoritative reference or canonical identifier is for a resource.

Show code cell source Hide code cell source

import json
from rdflib.extras.external_graph_libs import rdflib_to_networkx_multidigraph
from rdflib.extras.external_graph_libs import rdflib_to_networkx_graph
from pyld import jsonld
import graphviz
import os, sys

currentdir = os.path.dirname(os.path.abspath(''))
parentdir = os.path.dirname(currentdir)
sys.path.insert(0, parentdir)
from lib import jbutils

with open("../../../odis-in/dataGraphs/thematics/projects/graphs/proj.json") as dgraph:
    doc = json.load(dgraph)

frame = {
  "@context": {"@vocab": "https://schema.org/"},
  "@explicit": "true",
  "@requireAll": "true",
  "@type":     "ResearchProject",
  "identifier": ""
}

context = {
    "@vocab": "https://schema.org/",
}

compacted = jsonld.compact(doc, context)

framed = jsonld.frame(compacted, frame)
jd = json.dumps(framed, indent=4)
print(jd)

jbutils.show_graph(framed)

{
    "@context": {
        "@vocab": "https://schema.org/"
    },
    "@id": "https://example.org/id/resproj/X",
    "@type": [
        "ResearchProject",
        "PropertyValue"
    ],
    "identifier": {
        "@id": "https://grid.ac/institutes/grid.475727.4",
        "@type": "PropertyValue",
        "description": "UN Department of Economic and Social Affairs Sustainable Development",
        "propertyID": "https://registry.identifiers.org/registry/grid",
        "url": "https://grid.ac/institutes/grid.475727.4"
    }
}

Full Research Project

Here is what our full record looks like. We have added in several more nodes to cover things like funding source, policy connections, spatial area served and parent organization.

{
  "@context": {
    "@vocab": "https://schema.org/"
  },
  "@type": "ResearchProject",
  "@id": "https://example.org/id/resproj/X",
  "legalName": "Example Data Repository",
  "name": "ExDaRepo",
  "url": "https://www.example-data-repository.org",
  "description": "Repo description ... ",
  "logo": {
    "@type": "ImageObject",
    "url": "https://www.example-data-repository.org/logo.jpg"
  },
  "identifier": {
    "@id": "https://grid.ac/institutes/grid.475727.4",
    "@type": "PropertyValue",
    "description": "UN Department of Economic and Social Affairs Sustainable Development",
    "propertyID": "https://registry.identifiers.org/registry/grid",
    "url": "https://grid.ac/institutes/grid.475727.4"
  },
  "contactPoint": {
    "@id": "https://www.example-data-repository.org/about-us",
    "@type": "ContactPoint",
    "name": "Support",
    "email": "info@example-data-repository.org",
    "url": "https://www.example-data-repository.org/about-us",
    "contactType": "customer support"
  },
  "funder": {
    "@type": "FundingAgency",
    "@id": "https://dx.doi.org/10.13039/10000001",
    "name": "National Science Foundation",
    "legalName": "National Science Foundation",
    "alternateName": "NSF",
    "url": "https://www.nsf.gov/",
    "identifier": {
      "@id": "https://example.org/id/resproj/X",
      "@type": "PropertyValue",
      "propertyID": "https://registry.identifiers.org/registry/doi",
      "value": "DOI value expressed as doi:{doi}",
      "url": "https://dio.org/id/XYZ"
    }
  },
  "funding": [
    {
      "@id": "{odo:hasAward -> odo:osprey_page}",
      "@type": "MonetaryGrant",
      "url": "http://www.someinstitute.edu",
      "name": "{odo:hasAward -> odo:hasAwardNumber}",
      "identifier": "{odo:hasAward -> odo:hasAwardNumber}",
      "funder": [
        {
          "@id": "https://dx.doi.org/10.13039/10000001"
        },
        {
          "@type": "FundingAgency",
          "name": "Some other org",
          "url": "https://example.funder.org/"
        }
      ]
    }
  ],
  "ethicsPolicy": {
    "@type": "CreativeWork",
    "@id": "https://example.org/id/XYZ",
    "name": "Name or title of the document",
    "description": "Description of the creative work ",
    "url": "https://www.foo.org/creativework/ethicsPolicy.pdf"
  },
  "diversityPolicy": {
    "@type": "CreativeWork",
    "@id": "https://example.org/id/ABC",
    "name": "Name or title of the document",
    "description": "Description of the creative work",
    "url": "https://www.foo.org/creativework/diversityPolicy.pdf"
  },
  "areaServed": [
    {
      "@type": "Place",
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": 39.3280,
        "longitude": 120.1633
      },
      "description": "Description of the area served"
    },
    {
      "@type": "Text",
      "description": "Textual description of area served"
    },
    {
      "@type": "AdministrativeArea",
      "geo": {
        "@type": "GeoCoordinates",
        "latitude": 39.3280,
        "longitude": 120.1633
      },
      "description": "Needs to be subset of Place, Review Place"
    }
  ],
  "parentOrganization": {
    "@type": "Organization",
    "@id": "http://www.someinstitute.edu",
    "legalName": "Some Institute",
    "name": "SI",
    "url": "http://www.someinstitute.edu",
    "address": {
      "@type": "PostalAddress",
      "streetAddress": "234 Main St.",
      "addressLocality": "Anytown",
      "addressRegion": "ST",
      "postalCode": "12345",
      "addressCountry": "USA"
    }
  }
}

Show code cell source Hide code cell source

import json
from pyld import jsonld
import os, sys

currentdir = os.path.dirname(os.path.abspath(''))
parentdir = os.path.dirname(currentdir)
sys.path.insert(0, parentdir)
from lib import jbutils

with open("../../../odis-in/dataGraphs/thematics/projects/graphs/proj.json") as dgraph:
    doc = json.load(dgraph)

context = {
    "@vocab": "https://schema.org/",
}

compacted = jsonld.compact(doc, context)
jbutils.show_graph(compacted)

References

• https://schema.org/Project