Specific Assertions
Introduction
It is useful for research to have access to historical information, such as which artist was previously believed to be the creator of a work, or previous valuations of an object. The majority of use cases, however, are to get the current information. The assignment of attributes model allows for this additional information to be associated, without making every property a list of historical values.
This pattern is also used for context-specific assertions, such as when an object is given a label or description for the purposes of an exhibition or other event. This exhibition label does not replace the owning museum's title, but is useful for historical comparison and research purposes.
The use of context specific assertions or other attribute assignments should be kept to a minimum if possible. The data structure is significantly more complex than other patterns, which reduces the likelihood of implementation and increases the difficult of search queries. This pattern should only be used if there is no other way to express the knowledge, and it is important to capture with all of the details.
Assigning Attributes
The AttributeAssignment
class is an Activity
, typically carried out by curators or researchers rather than by artists or collectors, that assigns information to entities in the model. This can be used to assign any property or relationship on any entity that can be the subject of such a property. The general Activity properties of carried_out_by
, timespan
and took_place_at
are available for when and where the assignment happened, and who made it. The timespan
is the moment when the assignment took place, rather than the length of time that the assignment was held to be true by some audience.
This pattern is useful when you do not want to assert the relationship directly, such as for a name that was previously given to the object but is no longer actively used. Or an attribution of an artist that is possibly true, but might only be an informed guess.
The value of the assignment is given using assigned
, and it can be a reference to any entity. The entity that the value is assigned to is given using the attributed_by
property on that entity, and the relationship between them is given using assigned_property
. Thus an AttributeAssignment
can assign an Actor
to a Production
with the carried_out_by
relationship or a Material
to an object with the made_of
property. In terms of the relationship that the AttributeAssignment
expresses, the entity with the attributed_by
property is the subject of the relationship, the relationship itself is given in assigned_property
, and the object of the relationship is given in assigned
, thereby making up a regular 'triple' of subject, predicate, object.
Example:
It is asserted in 2015 that "Spring" has a material of canvas.
NOTE WELL This is an illustrative example only, and without further reason, the simple made_of
property should instead be used.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/spring/21",
"type": "HumanMadeObject",
"_label": "Spring",
"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"
}
]
}
],
"attributed_by": [
{
"type": "AttributeAssignment",
"timespan": {
"type": "TimeSpan",
"begin_of_the_begin": "2015-01-01T00:00:00Z",
"end_of_the_end": "2015-12-31T23:59:59Z"
},
"assigned_property": "made_of",
"assigned": [
{
"id": "http://vocab.getty.edu/aat/300014078",
"type": "Material"
}
]
}
]
}
Assigned Value as Subject Entity
In other situations the appropriate entity with which to associate the AttributeAssignment
is the one being assigned. In this case we flip the AttributeAssignment
around and use assigned_by
on the value of the assignment (the object of the relationship), and do not specify the subject of the relationship as it's the entity which refers to it. For example, it is very useful to be able to assert which organization created and assigned an Identifier
to an object in order to disambiguate that organization's identifier from another organization's identifier of the same type, such as accession numbers. Another use case is giving further information about a particular Dimension
associated with the object, such as who measured it, when, with which instrument, and so on.
In this case, the subject of the relationship is the entity which refers to the value, the predicate is that relationship, and the object is the entity with the assigned_by
property which refers to the AttributeAssignment.
Example:
The Kehinde Wiley painting "Portrait of Lynette Yiadom-Boakye, Jacob Morland of Capplethwaite" is jointly owned by the Yale University Art Gallery and the Yale Center for British Art. Both organizations have assigned their own accession numbers to the painting, and both are correct simultaneously.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/yiadom-boakye/1",
"type": "HumanMadeObject",
"_label": "Portrait of Lynette Yiadom-Boakye",
"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"
}
]
}
],
"identified_by": [
{
"type": "Identifier",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300312355",
"type": "Type",
"_label": "Accession Number"
}
],
"content": "2021.25.1",
"assigned_by": [
{
"type": "AttributeAssignment",
"carried_out_by": [
{
"id": "https://linked.art/example/group/yuag",
"type": "Group",
"_label": "Yale University Art Gallery",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300312281",
"type": "Type",
"_label": "Museum"
}
]
}
]
}
]
},
{
"type": "Identifier",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300312355",
"type": "Type",
"_label": "Accession Number"
}
],
"content": "B2021.5",
"assigned_by": [
{
"type": "AttributeAssignment",
"carried_out_by": [
{
"id": "https://linked.art/example/group/ycba",
"type": "Group",
"_label": "Yale Center for British Art",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300312281",
"type": "Type",
"_label": "Museum"
}
]
}
]
}
]
}
]
}
Source of Knowledge
It is useful to be able to assert the source of information, such as the text which provides an authority or witness for a particular form of a name of an entity. This is modeled using the attribute assignment pattern, with a reference to the entity that provided the information in the used_specific_object
field. This could be a database, or the text of a book, a physical object or other entity types. The requirement, however, is that it is a reference to this entity, rather than a string citation.
For citations as strings, the regular Statement pattern can be used with referred_to_by
, again on the attribute assignment.
Example:
The name form "Rembrandt van Rijn" was added from Gardner's "Art through the Ages".
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/person/rembrandt/10",
"type": "Person",
"_label": "Rembrandt",
"identified_by": [
{
"type": "Name",
"content": "Rembrandt van Rijn",
"assigned_by": [
{
"type": "AttributeAssignment",
"used_specific_object": [
{
"id": "https://linked.art/example/text/gardner-art",
"type": "LinguisticObject",
"_label": "Art through the Ages"
}
]
}
]
}
]
}
Creation Details of Embedded Statements
In order to give credit for the creation of statements embedded within other records, it is possible to add a created_by
property on to the statement as if it were a full textual work record. This allows the creator and other creation information to be recorded in the regular way using carried_out_by
. This is especially useful for noting contributions from external or more junior participants who might not otherwise receive any acknowledgement for their participation in the knowledge creation.
The use of artificial intelligence can be recorded as the technique
of the creation, with a recommended vocabulary term of "aat:300456842", or if a particular AI tool is used, it can be listed with used_specific_object
on the Creation
. The URIs to use for specific AI tools are not recommended at the moment, however if certain tools become popular they will be added to the vocabulary section. Note that if AI is used but there is no other information about the creation of the statement, then an easier option is to use classified_as
on the Statement directly, with a vocabulary term of "aat:300456841" for "AI Generated Content". The technique or the classification can also be used with AttributeAssignment
when the assignment is being made by an AI. Consumers of content that is marked in these ways as being generated using an AI system might wish to tag the content as such in a user interface, or otherwise allow filtering or sorting of such artificial content.
Scope of Description
Please note that this pattern does not allow for individual relationships to be flagged as being generated by an
AI. For example, if software extracted the list of materials from a statement and created a series of made_of
references to actual Material
instances, these links cannot be reified to add the creation information, just
as they cannot be reified to add a human who asserted the relationship. The use of AttributeAssignment
, as above,
is possible but not encouraged.
Another use case is to associate rights information with the statement, separate from any asserted license on the overall dataset. This follows the regular subject_to
pattern, as described in the rights section. In this way the overall factual information about an object or person can have a more permissive license than text or other more custom or potentially valuable content.
It must be noted that all of this functionality is available for any LinguisticObject
record as well.
Example:
The description of The Night Watch was generated by an AI at a particular point in time, and is licensed as CC-BY.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/nightwatch/70",
"type": "HumanMadeObject",
"_label": "Night Watch",
"referred_to_by": [
{
"type": "LinguisticObject",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435416",
"type": "Type",
"_label": "Description",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300456841",
"type": "Type"
}
],
"content": "Rembrandt's The Night Watch is a dynamic 17th-century group portrait of an Amsterdam militia company ...",
"created_by": {
"type": "Creation",
"technique": [
{
"id": "http://vocab.getty.edu/aat/300456842",
"type": "Type"
}
],
"timespan": {
"type": "TimeSpan",
"begin_of_the_begin": "2024-11-07T20:50:00Z",
"end_of_the_end": "2024-11-07T20:50:00Z"
}
},
"subject_to": [
{
"type": "Right",
"classified_as": [
{
"id": "https://creativecommons.org/licenses/by/4.0/",
"type": "Type",
"_label": "CC-BY"
}
],
"identified_by": [
{
"type": "Name",
"content": "CC-BY 4.0"
}
]
}
]
}
]
}
Uncertain or Former Assignments
Similar to the approach taken in the first example above, it is possible to use attributed_by
on a Production
node to make either uncertain or previously held to be true claims about it. The assignment then creates another Production
to encapsulate the information that isn't certain, or was formerly held to be correct, including the artist(s) but also potentially other links such as the place of production, the date, or other influences.
Example:
The watercolor painting "Forum Romanum" was possibly produced by Salomon Corrodi
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/forum/1",
"type": "HumanMadeObject",
"_label": "Forum Romanum",
"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"
}
]
}
],
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404670",
"type": "Type",
"_label": "Primary Name"
}
],
"content": "Forum Romanum"
}
],
"produced_by": {
"type": "Production",
"attributed_by": [
{
"type": "AttributeAssignment",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404272",
"type": "Type",
"_label": "Possibly By"
}
],
"assigned": [
{
"type": "Production",
"carried_out_by": [
{
"id": "https://linked.art/example/person/corrodi",
"type": "Person",
"_label": "Salomon Corrodi"
}
]
}
],
"assigned_property": "part"
}
]
}
}
Context-Specific Assignments
Some assertions are only true within a specific context, and the most commonly known case of this is descriptions, names and identifiers assigned for a particular exhibition. In order to record these context-specific assertions, the attributed_by
pattern should be used, even for Names and Identifiers that might otherwise have the assigned_by
pattern, as this keeps the Identifer separated from the primary record.
We use the caused_by
relationship to connect the attribution to the exhibition.
Example:
Spring was exhibited at the National Gallery of Art's exhibition "Post-Impressionism: Cross-Currents in European and American Painting" in 1980, and was assigned a exhibition specific identifier (called a "dexid").
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/spring/31",
"type": "HumanMadeObject",
"_label": "Spring",
"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"
}
]
}
],
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404670",
"type": "Type",
"_label": "Primary Name"
}
],
"content": "Jeanne (Spring)"
}
],
"attributed_by": [
{
"type": "AttributeAssignment",
"carried_out_by": [
{
"id": "https://linked.art/example/group/nga",
"type": "Group",
"_label": "National Gallery of Art"
}
],
"assigned": [
{
"type": "Identifier",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300445023",
"type": "Type",
"_label": "Entry Numbers"
}
],
"content": "2497-12"
}
],
"assigned_property": "identified_by",
"caused_by": [
{
"id": "https://linked.art/example/event/post_impressionism",
"type": "Activity",
"_label": "Post-Impressionism Exhibition"
}
]
}
]
}
Relationships
Related Entities
Another use of AttributeAssignment
is to capture relationships between entities when the nature of that relationship is unknown. This will often appear in human-oriented user interfaces with a label like "Related Place" or "Related Person". The use of AttributeAssignment in this way should be as a last resort for when there isn't any way to be more specific that just "there is a relationship". A scenario in which this might be useful and justified is to explicitly connect "related" objects in a collection, where the related-ness is via some computed similarity measure. Equally, the underlying data format might not be explicit as to the relationship between the entities, and the attribute assignment pattern is as close as can be expressed.
This would also cover the use case of "representative objects" for an artist, or other similar "highlight" reels. There isn't a particular relationship between the artist and the object that isn't already covered by the model, but it's desirable to have some predetermined choices made rather than allowing a system to randomly pick which objects to use. These could have a reference to http://vocab.getty.edu/aat/300028875 in classified_as
on the AttributeAssignment
to distinguish them.
Example:
The Night Watch is related to another object in the Rijksmuseum collection "Nachtwacht", but the relationship is not captured specifically.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/nightwatch/57",
"type": "HumanMadeObject",
"_label": "The Night Watch",
"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"
}
]
}
],
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404670",
"type": "Type",
"_label": "Primary Name"
}
],
"content": "The Night Watch"
}
],
"attributed_by": [
{
"type": "AttributeAssignment",
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404669",
"type": "Type",
"_label": "Display Title"
}
],
"content": "Related Object"
}
],
"assigned": [
{
"id": "https://linked.art/example/object/rppob-28-106",
"type": "HumanMadeObject",
"_label": "Nachtwacht"
}
]
}
]
}
Unmodeled Relationships
Conversely, perhaps the relationship is known but there's no way to describe it in the model. For example the student/teacher relationship between people is a social construct that can't be captured easily, but is still of importance for art history. There are far too many such relationships, especially in the social arena, to model them all separately or create extension properties for each, and thus an AttributeAssignment
for the relationship is the approach taken. Finding appropriate properties to use to describe the relationship, either as classified_as
or assigned_property
is up to the implementer. Giving a display name with identified_by
on the AttributeAssignment
is recommended.
Social Constructs as Groups
Note that many social relationships could be modeled as Joining
and Leaving
a Group
with a particular role, via classified_as
on the Joining
activity. For example, the Group represents the social bond between the teacher and the student, the teacher joins the group as the teacher, the student as the student. This is possible, but introduces a lot of additional overhead with identity for the "Group" of the relationship.
Example:
Ferdinand Bol was a student of Rembrandt.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/person/bol/1",
"type": "Person",
"_label": "Ferdinand Bol",
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404670",
"type": "Type",
"_label": "Primary Name"
}
],
"content": "Ferdinand Bol"
}
],
"attributed_by": [
{
"type": "AttributeAssignment",
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404669",
"type": "Type",
"_label": "Display Title"
}
],
"content": "Student Of"
}
],
"assigned": [
{
"id": "https://linked.art/example/person/rembrandt",
"type": "Person",
"_label": "Rembrandt"
}
]
}
]
}