Linked Art API: Embedded Activity Structure

Table of Contents

Introduction
Property Definitions
Example

Introduction

Although the data model is activity-centric, it is often more efficient to embed the descriptions of activities within the description of the entity that the activity created, destroyed or used. This pattern is used for bringing things into existence (Productions, Creations, Formations), taking things out of existence (Destruction, Dissolution, Death) and activities that are carried out by people such as their professional activities.

Property Definitions

The activity data structure has the following properties.

Properties of Activities

Property Name	Datatype	Requirement	Description
`id`	string	Optional	If present, the value MUST be a URI identifying the activity, from which a representation of the activity can be retrieved
`type`	string	Required	The class for the activity, the value for which MUST be taken from the table below
`_label`	string	Recommended	Non-Semantic. A human readable label for the activity, intended for developers
`_complete`	boolean	Optional	Non-Semantic. If there is an `id` property with a URI, and there is more information about the activity available from the representation at that URI, then `_complete` MUST be present with a value of `false` to inform the consuming application that it might want to retrieve it
`identified_by`	array	Recommended	An array of json objects, each of which is a name of the activity and MUST follow the requirements for Name, or an identifier for the activity and MUST follow the requirements for Identifier
`classified_as`	array	Recommended	An array of json objects, each of which is a further classification of the activity and MUST follow the requirements for Type
`referred_to_by`	array	Optional	An array of json objects, each of which is an embedded statement about the activity
`took_place_at`	array	Optional	An array of json objects, each of which is a reference to a Place where the activity occured
`timespan`	json object	Optional	A json object which describes when the activity occured, and MUST follow the requirements for timespans
`during`	array	Optional	An array of json objects, each of which is a reference to a Period during which the activity occured
`caused_by`	array	Optional	An array of json objects, each of which is a reference to an Event that caused this event to occur
`carried_out_by`	array	Optional	An array of json objects, each of which is a reference to a Person or Group which carried out the activity. NOT usable when the `type` is `"Birth"` or `"Death"`
`influenced_by`	array	Optional	An array of json objects, each of which is a reference to an entity that influenced or motivated the activity in some noticable fashion. NOT usable when the `type` is `"Birth"` or `"Death"`
`used_specific_object`	array	Optional	An array of json objects, each of which is a reference to an entity that was instrumental in the carrying out of this activity. NOT usable when the `type` is `"Birth"` or `"Death"`
`technique`	array	Optional	An array of json objects, each of which is a technique used in the activity and MUST follow the requirements for Type. NOT usable when the `type` is `"Birth"` or `"Death"`
`part`	array	Optional	An array of json objects, each of which is another instance of this same event type. NOT usable when the `type` is `"Birth"` or `"Death"`
`diminished`	json object	Optional	A json objects which is a reference to another Physical Object that this object was removed from by this event. Only usable when the `type` is `"PartRemoval"`

Activity Classes Available

Endpoint / Pattern	Beginning	Ending	Other
Abstract Work	Creation	-	-
Concept	Creation	-	-
Digital Object	Creation	-	Activity
Group	Formation	Dissolution	Activity
Person	Birth	Death	Activity
Physical Object	Production, PartRemoval	Destruction	Encounter, Activity
Set	Creation	-	Activity
Textual Work	Creation	-	Activity
Visual Work	Creation	-	Activity
Statement	Creation	-	-

Property Diagram

Incoming Properties

Activity instances are typically found as the object of the following properties.

Property Name	Class	Description
`created_by`	Creation	The beginning of a conceptual or digital thing
`formed_by`	Formation	The beginning of a group
`dissolved_by`	Dissolution	The end of a group
`born`	Birth	The beginning of a person
`died`	Death	The end of a person
`produced_by`	Production	The beginning of a physical thing
`removed_by`	PartRemoval	The beginning of a physical thing, when it is removed from something else
`destroyed_by`	Destruction	The ending of a physical thing
`encountered_by`	Encounter	The discovery or interaction with a physical thing
`used_for`	Activity	The use of a thing for some activity, typically publication
`participated_in`	Activity	An activity that a Person or Group participated in
`carried_out`	Activity	An activity that a Person or Group carried out directly

Example

The Mona Lisa:

... was produced by Leonardo da Vinci
... between 1503 and 1506
... in Florence
... using the painting technique
... the production was influenced by Lisa del Giocondo

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/object/4",
  "type": "HumanMadeObject",
  "_label": "Mona Lisa",
  "classified_as": [
    {
      "id": "http://vocab.getty.edu/aat/300033618",
      "type": "Type",
      "_label": "Painting",
      "classified_as": [
        {
          "id": "http://vocab.getty.edu/aat/300435443",
          "type": "Type",
          "_label": "Type of Work"
        }
      ]
    }
  ],
  "produced_by": {
    "type": "Production",
    "technique": [
      {
        "id": "http://vocab.getty.edu/aat/300054216",
        "type": "Type",
        "_label": "Painting Technique"
      }
    ],
    "timespan": {
      "type": "TimeSpan",
      "identified_by": [
        {
          "type": "Name",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300404669",
              "type": "Type",
              "_label": "Display Title"
            }
          ],
          "content": "1503-1506"
        }
      ],
      "begin_of_the_begin": "1503-01-01T00:00:00Z",
      "end_of_the_end": "1506-12-31T23:59:59Z"
    },
    "took_place_at": [
      {
        "id": "http://vocab.getty.edu/tgn/7000457",
        "type": "Place",
        "_label": "Florence, Italy"
      }
    ],
    "carried_out_by": [
      {
        "id": "http://vocab.getty.edu/ulan/500010879",
        "type": "Person",
        "_label": "Leonardo da Vinci"
      }
    ],
    "influenced_by": [
      {
        "id": "http://vocab.getty.edu/ulan/500341678",
        "type": "Person",
        "_label": "Lisa del Giocondo"
      }
    ]
  }
}

graph TD classDef object stroke:black,fill:#E1BA9C,rx:20px,ry:20px; classDef actor stroke:black,fill:#FFBDCA,rx:20px,ry:20px; classDef type stroke:red,fill:#FAB565,rx:20px,ry:20px; classDef name stroke:orange,fill:#FEF3BA,rx:20px,ry:20px; classDef dims stroke:black,fill:#c6c6c6,rx:20px,ry:20px; classDef infoobj stroke:#907010,fill:#fffa40,rx:20px,ry:20px classDef timespan stroke:blue,fill:#ddfffe,rx:20px,ry:20px classDef place stroke:#3a7a3a,fill:#aff090,rx:20px,ry:20px classDef event stroke:#1010FF,fill:#96e0f6,rx:20px,ry:20px classDef literal stroke:black,fill:#f0f0e0; classDef classstyle stroke:black,fill:white; O1(object/4) class O1 object; O1-- type -->O1_0[HumanMadeObject] class O1_0 classstyle; O1-- _label -->O1_4("''Mona Lisa''") class O1_4 literal; O2(aat:300033618) class O2 type; O2-- type -->O2_0[Type] class O2_0 classstyle; O2-- _label -->O2_3("''Painting''") class O2_3 literal; O3(aat:300435443) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''Type of Work''") class O3_3 literal; O2-- classified_as -->O3 O1-- classified_as -->O2 O4( _ ) class O4 event; O4-- type -->O4_0[Production] class O4_0 classstyle; O5(aat:300054216) class O5 type; O5-- type -->O5_0[Type] class O5_0 classstyle; O5-- _label -->O5_3("''Painting Technique''") class O5_3 literal; O4-- technique -->O5 O6( _ ) class O6 timespan; O6-- type -->O6_0[TimeSpan] class O6_0 classstyle; O7( _ ) class O7 name; O7-- type -->O7_0[Name] class O7_0 classstyle; O8(aat:300404669) class O8 type; O8-- type -->O8_0[Type] class O8_0 classstyle; O8-- _label -->O8_3("''Display Title''") class O8_3 literal; O7-- classified_as -->O8 O7-- content -->O7_3("''1503-1506''") class O7_3 literal; O6-- identified_by -->O7 O6-- begin_of_the_begin -->O6_3("''1503-01-01T00:00:00Z''") class O6_3 literal; O6-- end_of_the_end -->O6_4("''1506-12-31T23:59:59Z''") class O6_4 literal; O4-- timespan -->O6 O9(tgn:7000457) class O9 place; O9-- type -->O9_0[Place] class O9_0 classstyle; O9-- _label -->O9_3("''Florence, Italy''") class O9_3 literal; O4-- took_place_at -->O9 O10(ulan:500010879) class O10 actor; O10-- type -->O10_0[Person] class O10_0 classstyle; O10-- _label -->O10_3("''Leonardo da Vinci''") class O10_3 literal; O4-- carried_out_by -->O10 O11(ulan:500341678) class O11 actor; O11-- type -->O11_0[Person] class O11_0 classstyle; O11-- _label -->O11_3("''Lisa del Giocondo''") class O11_3 literal; O4-- influenced_by -->O11 O1-- produced_by -->O4

Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)