Skip to content

Strawmen Relationship

Jump to bottom
Philip Crotwell edited this page Oct 7, 2025 · 1 revision

Some examples of various styles of adding relationships to JSON to consider and provoke discussion.

Code to generate these is in the strawmen folder in the repo.

Generic relationships with type included

{
  "@context": {
    "name": "http://fdsn.org"
  },
  "meta": {
    "source": "IRIS-DMC",
    "sender": "IRIS-DMC",
    "module": "IRIS WEB SERVICE: fdsnws-station | version: 1.1.52",
    "moduleUri": "https://service.iris.edu/fdsnws/station/1/query?net=CO,XD&level=station&format=xml&includecomments=true&nodata=404",
    "created": "2025-10-07T18:34:27.8731"
  },
  "data": [
    {
      "@type": "network",
      "@id": "FDSN:CO@1987-01-01T00:00:00.0000/3",
      "data": {
        "sourceid": "FDSN:CO",
        "restrictedStatus": "open",
        "startDate": "1987-01-01T00:00:00.0000",
        "description": "South Carolina Seismic Network (SCSN)",
        "identifier": {
          "type": "DOI",
          "id": "10.7914/SN/CO"
        }
      },
      "meta": {
        "pubVersion": "3",
        "otherNS": "stuff here",
        "totalNumberStations": "19",
        "selectedNumberStations": "19"
      },
      "relationships": [
        {
          "@type": "station",
          "@id": "FDSN:CO_ADSC@2012-10-08T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_BARN@2021-12-31T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_BELLE@2025-01-17T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_BIRD@2010-08-25T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_C1SC@2012-10-08T19:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_C2SC@2012-10-08T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_CASEE@2009-12-07T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_CSB@2009-04-13T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_HAW@2010-03-11T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_HODGE@2010-03-25T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_JKYD@2022-10-18T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_JSC@2009-04-13T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_MONT@2021-11-04T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_PARR@2023-11-28T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_PAULI@2011-04-26T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_RGR@2009-04-13T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_SUMMV@2015-04-21T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_TEEBA@2018-04-25T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:CO_TRSC@2012-10-08T00:00:00.0000/4"
        }
      ]
    },
    {
      "@type": "network",
      "@id": "FDSN:XD1994@1994-01-01T00:00:00.0000/3",
      "data": {
        "sourceid": "FDSN:XD1994",
        "endDate": "1995-12-31T23:59:59.9999",
        "restrictedStatus": "open",
        "startDate": "1994-01-01T00:00:00.0000",
        "description": "Seismic investigations of the Lithospheric Structure of the Tanzanian Craton (Tanzania)",
        "identifier": {
          "type": "DOI",
          "id": "10.7914/SN/XD_1994"
        }
      },
      "meta": {
        "pubVersion": "3",
        "otherNS": "stuff here",
        "totalNumberStations": "21",
        "selectedNumberStations": "21"
      },
      "relationships": [
        {
          "@type": "station",
          "@id": "FDSN:XD1994_AMBA@1994-10-31T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_BASO@1994-06-07T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_GOMA@1994-06-02T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_HALE@1994-06-03T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_INZA@1994-06-04T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_KIBA@1994-06-01T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_KIBE@1994-06-02T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_KOMO@1994-06-08T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_KOND@1994-05-31T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_LONG@1994-06-09T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_MBWE@1994-05-23T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_MITU@1994-05-24T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_MTAN@1994-05-25T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_MTOR@1994-05-22T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_PAND@1994-05-27T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_PUGE@1994-05-27T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_RUNG@1994-05-25T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_SING@1994-05-20T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_TARA@1994-06-10T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_TUND@1994-05-27T00:00:00.0000/4"
        },
        {
          "@type": "station",
          "@id": "FDSN:XD1994_URAM@1994-05-29T00:00:00.0000/4"
        }
      ]
    }
  ]
}

Type specific station with type implied by field

{
  "@context": {
    "name": "http://fdsn.org"
  },
  "meta": {
    "source": "IRIS-DMC",
    "sender": "IRIS-DMC",
    "module": "IRIS WEB SERVICE: fdsnws-station | version: 1.1.52",
    "moduleUri": "https://service.iris.edu/fdsnws/station/1/query?net=CO,XD&level=station&format=xml&includecomments=true&nodata=404",
    "created": "2025-10-07T18:34:27.8731"
  },
  "data": [
    {
      "@type": "network",
      "@id": "FDSN:CO@1987-01-01T00:00:00.0000/3",
      "data": {
        "sourceid": "FDSN:CO",
        "restrictedStatus": "open",
        "startDate": "1987-01-01T00:00:00.0000",
        "description": "South Carolina Seismic Network (SCSN)",
        "identifier": {
          "type": "DOI",
          "id": "10.7914/SN/CO"
        },
        "stations": [
          "FDSN:CO_ADSC@2012-10-08T00:00:00.0000/4",
          "FDSN:CO_BARN@2021-12-31T00:00:00.0000/4",
          "FDSN:CO_BELLE@2025-01-17T00:00:00.0000/4",
          "FDSN:CO_BIRD@2010-08-25T00:00:00.0000/4",
          "FDSN:CO_C1SC@2012-10-08T19:00:00.0000/4",
          "FDSN:CO_C2SC@2012-10-08T00:00:00.0000/4",
          "FDSN:CO_CASEE@2009-12-07T00:00:00.0000/4",
          "FDSN:CO_CSB@2009-04-13T00:00:00.0000/4",
          "FDSN:CO_HAW@2010-03-11T00:00:00.0000/4",
          "FDSN:CO_HODGE@2010-03-25T00:00:00.0000/4",
          "FDSN:CO_JKYD@2022-10-18T00:00:00.0000/4",
          "FDSN:CO_JSC@2009-04-13T00:00:00.0000/4",
          "FDSN:CO_MONT@2021-11-04T00:00:00.0000/4",
          "FDSN:CO_PARR@2023-11-28T00:00:00.0000/4",
          "FDSN:CO_PAULI@2011-04-26T00:00:00.0000/4",
          "FDSN:CO_RGR@2009-04-13T00:00:00.0000/4",
          "FDSN:CO_SUMMV@2015-04-21T00:00:00.0000/4",
          "FDSN:CO_TEEBA@2018-04-25T00:00:00.0000/4",
          "FDSN:CO_TRSC@2012-10-08T00:00:00.0000/4"
        ]
      },
      "meta": {
        "pubVersion": "3",
        "otherNS": "stuff here",
        "totalNumberStations": "19",
        "selectedNumberStations": "19"
      }
    },
    {
      "@type": "network",
      "@id": "FDSN:XD1994@1994-01-01T00:00:00.0000/3",
      "data": {
        "sourceid": "FDSN:XD1994",
        "endDate": "1995-12-31T23:59:59.9999",
        "restrictedStatus": "open",
        "startDate": "1994-01-01T00:00:00.0000",
        "description": "Seismic investigations of the Lithospheric Structure of the Tanzanian Craton (Tanzania)",
        "identifier": {
          "type": "DOI",
          "id": "10.7914/SN/XD_1994"
        },
        "stations": [
          "FDSN:XD1994_AMBA@1994-10-31T00:00:00.0000/4",
          "FDSN:XD1994_BASO@1994-06-07T00:00:00.0000/4",
          "FDSN:XD1994_GOMA@1994-06-02T00:00:00.0000/4",
          "FDSN:XD1994_HALE@1994-06-03T00:00:00.0000/4",
          "FDSN:XD1994_INZA@1994-06-04T00:00:00.0000/4",
          "FDSN:XD1994_KIBA@1994-06-01T00:00:00.0000/4",
          "FDSN:XD1994_KIBE@1994-06-02T00:00:00.0000/4",
          "FDSN:XD1994_KOMO@1994-06-08T00:00:00.0000/4",
          "FDSN:XD1994_KOND@1994-05-31T00:00:00.0000/4",
          "FDSN:XD1994_LONG@1994-06-09T00:00:00.0000/4",
          "FDSN:XD1994_MBWE@1994-05-23T00:00:00.0000/4",
          "FDSN:XD1994_MITU@1994-05-24T00:00:00.0000/4",
          "FDSN:XD1994_MTAN@1994-05-25T00:00:00.0000/4",
          "FDSN:XD1994_MTOR@1994-05-22T00:00:00.0000/4",
          "FDSN:XD1994_PAND@1994-05-27T00:00:00.0000/4",
          "FDSN:XD1994_PUGE@1994-05-27T00:00:00.0000/4",
          "FDSN:XD1994_RUNG@1994-05-25T00:00:00.0000/4",
          "FDSN:XD1994_SING@1994-05-20T00:00:00.0000/4",
          "FDSN:XD1994_TARA@1994-06-10T00:00:00.0000/4",
          "FDSN:XD1994_TUND@1994-05-27T00:00:00.0000/4",
          "FDSN:XD1994_URAM@1994-05-29T00:00:00.0000/4"
        ]
      },
      "meta": {
        "pubVersion": "3",
        "otherNS": "stuff here",
        "totalNumberStations": "21",
        "selectedNumberStations": "21"
      }
    }
  ]
}

Network to Station Relationship as Top Level

Would require a new level-like parameter in web service.

{
  "@context": {
    "name": "http://fdsn.org"
  },
  "meta": {
    "source": "IRIS-DMC",
    "sender": "IRIS-DMC",
    "module": "IRIS WEB SERVICE: fdsnws-station | version: 1.1.52",
    "moduleUri": "https://service.iris.edu/fdsnws/station/1/query?net=CO,XD&level=station&format=xml&includecomments=true&nodata=404",
    "created": "2025-10-07T18:34:27.8731"
  },
  "data": [
    {
      "@type": "networkstation",
      "@id": "FDSN:CO@1987-01-01T00:00:00.0000/3",
      "data": {
        "stationid": [
          "FDSN:CO_ADSC@2012-10-08T00:00:00.0000/4",
          "FDSN:CO_BARN@2021-12-31T00:00:00.0000/4",
          "FDSN:CO_BELLE@2025-01-17T00:00:00.0000/4",
          "FDSN:CO_BIRD@2010-08-25T00:00:00.0000/4",
          "FDSN:CO_C1SC@2012-10-08T19:00:00.0000/4",
          "FDSN:CO_C2SC@2012-10-08T00:00:00.0000/4",
          "FDSN:CO_CASEE@2009-12-07T00:00:00.0000/4",
          "FDSN:CO_CSB@2009-04-13T00:00:00.0000/4",
          "FDSN:CO_HAW@2010-03-11T00:00:00.0000/4",
          "FDSN:CO_HODGE@2010-03-25T00:00:00.0000/4",
          "FDSN:CO_JKYD@2022-10-18T00:00:00.0000/4",
          "FDSN:CO_JSC@2009-04-13T00:00:00.0000/4",
          "FDSN:CO_MONT@2021-11-04T00:00:00.0000/4",
          "FDSN:CO_PARR@2023-11-28T00:00:00.0000/4",
          "FDSN:CO_PAULI@2011-04-26T00:00:00.0000/4",
          "FDSN:CO_RGR@2009-04-13T00:00:00.0000/4",
          "FDSN:CO_SUMMV@2015-04-21T00:00:00.0000/4",
          "FDSN:CO_TEEBA@2018-04-25T00:00:00.0000/4",
          "FDSN:CO_TRSC@2012-10-08T00:00:00.0000/4"
        ]
      }
    },
    {
      "@type": "networkstation",
      "@id": "FDSN:XD1994@1994-01-01T00:00:00.0000/3",
      "data": {
        "stationid": [
          "FDSN:XD1994_AMBA@1994-10-31T00:00:00.0000/4",
          "FDSN:XD1994_BASO@1994-06-07T00:00:00.0000/4",
          "FDSN:XD1994_GOMA@1994-06-02T00:00:00.0000/4",
          "FDSN:XD1994_HALE@1994-06-03T00:00:00.0000/4",
          "FDSN:XD1994_INZA@1994-06-04T00:00:00.0000/4",
          "FDSN:XD1994_KIBA@1994-06-01T00:00:00.0000/4",
          "FDSN:XD1994_KIBE@1994-06-02T00:00:00.0000/4",
          "FDSN:XD1994_KOMO@1994-06-08T00:00:00.0000/4",
          "FDSN:XD1994_KOND@1994-05-31T00:00:00.0000/4",
          "FDSN:XD1994_LONG@1994-06-09T00:00:00.0000/4",
          "FDSN:XD1994_MBWE@1994-05-23T00:00:00.0000/4",
          "FDSN:XD1994_MITU@1994-05-24T00:00:00.0000/4",
          "FDSN:XD1994_MTAN@1994-05-25T00:00:00.0000/4",
          "FDSN:XD1994_MTOR@1994-05-22T00:00:00.0000/4",
          "FDSN:XD1994_PAND@1994-05-27T00:00:00.0000/4",
          "FDSN:XD1994_PUGE@1994-05-27T00:00:00.0000/4",
          "FDSN:XD1994_RUNG@1994-05-25T00:00:00.0000/4",
          "FDSN:XD1994_SING@1994-05-20T00:00:00.0000/4",
          "FDSN:XD1994_TARA@1994-06-10T00:00:00.0000/4",
          "FDSN:XD1994_TUND@1994-05-27T00:00:00.0000/4",
          "FDSN:XD1994_URAM@1994-05-29T00:00:00.0000/4"
        ]
      }
    }
  ]
}

Clone this wiki locally