Introduction
There are several important physical features of artworks that it is important to capture, including the size, shapes, colors, and the materials that it is made of. The model allows for both being explicit in the data for these, as well as simply including a textual description. The explicit form is preferred, however it is recognized that not all systems will be able to provide it.
Beyond dimensions and materials, the model allows for the description of parts of objects, and parts of parts, using the base pattern. These parts can be thought of as objects in their own right, and thus have titles ("Left Panel" of a triptych), descriptions, rights, images, dimensions, materials, and so forth.
Dimensions
The physical dimensions of an object, such as height, width, diameter or weight, are included in the dimension
property, and consist of three primary pieces of information:
- The numeric value in
value
. - The type of dimension (e.g. height vs width) in
classified_as
, referencing an external vocabulary of dimension types. - The
unit
used to align the value with the real world such as inches, pounds or seconds. The unit should also be given from a controlled vocabulary.
Example:
A painting that measures 16 inches wide by 20 inches tall.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/43",
"type": "HumanMadeObject",
"_label": "Example 16x20 Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"dimension": [
{
"type": "Dimension",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300055647",
"type": "Type",
"_label": "Width"
}
],
"value": 16,
"unit": {
"id": "http://vocab.getty.edu/aat/300379100",
"type": "MeasurementUnit",
"_label": "inches"
}
},
{
"type": "Dimension",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300055644",
"type": "Type",
"_label": "Height"
}
],
"value": 20,
"unit": {
"id": "http://vocab.getty.edu/aat/300379100",
"type": "MeasurementUnit",
"_label": "inches"
}
}
]
}
Dimension Statement
If the dimension text is not recorded in a way that is condusive to generating the full set, then it can be given as a LinguisticObject
, classifed as dimensions by reference to aat:300435430, and the text provided in content
. This is an example of the Statements base pattern.
Example:
The same 16 by 20 inch painting, described only in a human-readable text.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/44",
"type": "HumanMadeObject",
"_label": "Example 16x20 Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"referred_to_by": [
{
"type": "LinguisticObject",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435430",
"type": "Type",
"_label": "Dimension Statement",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
}
],
"content": "The painting is approximately 16 inches wide, by 20 inches high"
}
]
}
Dimension Display Labels
Another method is to have the dimensions in the data include a human readable label for the value that the dimension is representing. This allows clients to present the data in a particular style, rather than having to generate the text from the dimension value, unit and type.
This same approach can be used on many data structures and is merely being called out here to compare with the machine oriented view of just the data structure, and the human oriented view of just the full description as a statement.
Example:
The same 16 by 20 inch painting once more, described with human readable labels on each dimension.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/45",
"type": "HumanMadeObject",
"_label": "Example 16x20 Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"dimension": [
{
"type": "Dimension",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300055647",
"type": "Type",
"_label": "Width"
}
],
"value": 16,
"unit": {
"id": "http://vocab.getty.edu/aat/300379100",
"type": "MeasurementUnit",
"_label": "inches"
},
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404669",
"type": "Type",
"_label": "Display Title"
}
],
"content": "16 inches wide"
}
]
},
{
"type": "Dimension",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300055644",
"type": "Type",
"_label": "Height"
}
],
"value": 20,
"unit": {
"id": "http://vocab.getty.edu/aat/300379100",
"type": "MeasurementUnit",
"_label": "inches"
},
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404669",
"type": "Type",
"_label": "Display Title"
}
],
"content": "20 inches high"
}
]
}
]
}
Measurements of Dimensions
In some contexts, it is also important to have more information about how the dimensions were measured. This could be useful, for example, to distinguish the time and method by which the measurement was taken, or to know who used which instrument in a conservation research setting to promote accuracy and reusability of results.
In order to build upon the dimension model described above, the model adds an AttributeAssignment
activity to the Dimension
which is the measuring activity, following the Assertion pattern. The Dimension
is assigned_by
the AttributeAssignment
, to the object which has the dimension. In this particular case, as dimensions are specific to the object, and the dimension
property is explicit in the model already, there is no need to link from the AttributeAssignment
back to the object, or to give the property that is being assigned. It is permitted, but no new information is being added and hence it is not recommended.
Example:
A particular curator measured the painting to be 20 inches high.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/46",
"type": "HumanMadeObject",
"_label": "Example Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"dimension": [
{
"type": "Dimension",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300055644",
"type": "Type",
"_label": "Height"
}
],
"value": 20,
"unit": {
"id": "http://vocab.getty.edu/aat/300379100",
"type": "MeasurementUnit",
"_label": "inches"
},
"assigned_by": [
{
"type": "AttributeAssignment",
"_label": "Measurement of Painting",
"carried_out_by": [
{
"type": "Person",
"_label": "Curator"
}
]
}
]
}
]
}
Colors
The main colors of an object can be determined and record in two very different ways - by capturing a very specific value for the wavelength of the light or composition of the color (in a Red/Green/Blue colorspace, for example), or categorizing the object into more broader, subjective color types ("pale green", "ochre"). The first approach might be done with instruments measuring the reflected light off the original, or via digital photography and computing the color from the resulting digital image. The second approach is likely carried out by a curator in describing the object in a collection management system, hopefully using a controlled set of terms. As it is desirable to have only a single place to look for information, the model for color tries to capture both of these possibilities at once in as simple a way as possible, allowing either or both to happen for any given color.
Measurements record a Dimension
, and thus we create an instance of the class to record the color, even if the measurement is a categorization. The dimension has a value
and unit
, just like the more obvious physical dimensions described above. For an RGB colorspace, the value must be converted into an integer from the more traditional three-part hexadecimal value, as values are always decimalized. This allows the true value to be recorded. The dimension can also be classified_as
a particular color family -- the object has a color which is a green color, for example. Either or both of these patterns can be used, and multiple dimensions using this pattern can be recorded without having to match up which categories map to which values.
Example:
A green painting has a vivid (00FF00
) green color, and is also categorized as being green (aat:300128438)
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/47",
"type": "HumanMadeObject",
"_label": "Green Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"dimension": [
{
"type": "Dimension",
"_label": "green",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300080438",
"type": "Type",
"_label": "Color"
},
{
"id": "http://vocab.getty.edu/aat/300128438",
"type": "Type",
"_label": "Green"
}
],
"value": 65280,
"unit": {
"id": "http://vocab.getty.edu/aat/300266239",
"type": "MeasurementUnit",
"_label": "rgb"
}
}
]
}
Implementation Note
In order to generate an integer value from a hexadecimal value is typically very easy in most programming languages. In Python, for example, it is simply int(hex_value, 16)
. The reverse is also true, with the equivalent being hex(int_value)
. As such, the unobvious value of 65280
is not wonderful from a data-readability perspective, but the implementation is very straightforward and thus the consistency is deemed to provide more usability than having a special case of value
that takes a string instead of an integer.
Shapes
While some combinations of dimensions can give a sense of the shape of the object, it is also often useful to be more explicit. For example, a shield-shaped painting (perhaps due to being painted on an actual shield) would likely still only have height and width given. Without the additional information of the shape, it might be concluded that the painting is rectangular. Similarly, a circular object could be mistaken as a square, as the height and width would be the same in either case.
Shapes are given as classifications on the object via the classified_as
property. The classification is then further classified as being a shape, with the term aat:300056273, in the same way that being a painting is further classified as being the type of work.
Example:
An oval-shaped painting.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/48",
"type": "HumanMadeObject",
"_label": "Oval Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
},
{
"id": "http://vocab.getty.edu/aat/300263817",
"type": "Type",
"_label": "Oval",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300056273",
"type": "Type",
"_label": "Shape"
}
]
}
]
}
Materials
Objects are created using different materials, such as canvas or marble. These are recorded using the made_of
property on the object directly. The materials are the type of material, rather than the specific bits of matter and therefore refer to entries in external vocabularies. When possible, it is good to use this model, and combined with the parts model described in the next section, allows for a comprehensive set of information about which parts are which sizes, shapes, colors, and made of which materials.
Note that the type-of-type pattern is not needed for materials, like it is for shape, as they have their own Material
class that is used to distinguish them.
Example:
A statue made of marble.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/49",
"type": "HumanMadeObject",
"_label": "Marble Sculpture",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300047090",
"type": "Type",
"_label": "Sculpture",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435443",
"type": "Type",
"_label": "Type of Work"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"made_of": [
{
"id": "http://vocab.getty.edu/aat/300011443",
"type": "Material",
"_label": "marble"
}
]
}
Materials Statement
Similarly to dimensions statements, it is possible to describe the materials using a LinguisticObject
classified as being about the materials of the object via aat:300435429.
Example:
A multi-media painting, with a description of the materials in human-readable text only.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/50",
"type": "HumanMadeObject",
"_label": "Multi-material Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"referred_to_by": [
{
"type": "LinguisticObject",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435429",
"type": "Type",
"_label": "Material Statement",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
}
],
"content": "Oil, French Watercolors on Paper, Graphite and Ink on Canvas, with an Oak frame"
}
]
}
Environmental conditions
Depending on their material, objects need to be kept in appropriate environmental conditions so that they do not deteriorate. Such conditions are often recommendations by conservators and collection care experts and can be documented using a LinguisticObject
classified as being about the environmental conditions of the object via aat:300229535.
Example:
A painting with a description of the recommended environmental conditions.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/51",
"type": "HumanMadeObject",
"_label": "Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"referred_to_by": [
{
"type": "LinguisticObject",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300229535",
"type": "Type",
"_label": "Environmental Conditions Statement",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
}
],
"content": "Light level: 150 ±50 lux; Relative humidity: 55 ±5%; Temperature 21 ±1 °C."
}
]
}
Parts
As described in the baseline patterns, one of the main modeling paradigms used is to separate parts of resources from the whole. Physical objects are particularly amenable to this, and allows reuse of the rest of the model as needed. The parts do not need to be physically separable without destroying the object, but do need to be objectively definable in terms of the matter that makes it up. For example, the arm of a sculpture could have dimensions and materials, but while an arch-shaped space in a rock formation might have dimensions, it could not be removed, nor is it made of anything, and thus it is not a part.
Physical parts are given using the part
property, and use the same HumanMadeObject
class, as per the full object. The classified_as
property can be used to be more specific as to the sort of part, in this case the support for the painting, which is in turn made of canvas. The type of part is then further classified as aat:300241583 to ensure that it can be distinguished as a part-type, rather than an object-type.
The model does not have a separate parts statement to describe this in a human-readable way, as this is traditionally done using the materials statement as demonstrated above.
Example:
A watercolor painting, that has a part which is the support and is made of canvas.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/52",
"type": "HumanMadeObject",
"_label": "Example Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"made_of": [
{
"id": "http://vocab.getty.edu/aat/300015045",
"type": "Material",
"_label": "watercolors"
}
],
"part": [
{
"type": "HumanMadeObject",
"_label": "Canvas Support",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300014844",
"type": "Type",
"_label": "Support",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300241583",
"type": "Type",
"_label": "Part Type"
}
]
}
],
"made_of": [
{
"id": "http://vocab.getty.edu/aat/300014078",
"type": "Material",
"_label": "canvas"
}
]
}
]
}
Sides of an Object
While some artworks can be treated as two dimensional, as the only part of interest is the front of a flat surface such as a painting, drawing or photograph, there are many other objects where it is desirable to record information separately about the front and back, or any number of other sides.
This pattern allows separate identities for the recto and verso of a page, the obverse and reverse of a coin, in the same manner as the frame or canvas of a painting. The use of the classification aat:300133025 (artwork) is important to distinguish between objects that should be treated as the complete artwork, and objects that are either parts of it, or those that it is part of.
Example:
A photograph that depicts the Example Painting, where the image is on the front part, and there is an inscription on the back that reads "Photograph of Example Painting, taken 1932". The use of the classification of being an artwork applies only to the front of the photograph, and not the back.
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/53",
"type": "HumanMadeObject",
"_label": "Photograph of Example Painting",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300128347",
"type": "Type",
"_label": "Color Photograph",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300435443",
"type": "Type",
"_label": "Type of Work"
}
]
}
],
"part": [
{
"type": "HumanMadeObject",
"_label": "Front of Photograph",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300190703",
"type": "Type",
"_label": "Front Part",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300241583",
"type": "Type",
"_label": "Part Type"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
],
"shows": [
{
"type": "VisualItem",
"represents": [
{
"type": "HumanMadeObject",
"_label": "Example Painting",
"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"
}
]
},
{
"id": "http://vocab.getty.edu/aat/300133025",
"type": "Type",
"_label": "Artwork"
}
]
}
]
}
]
},
{
"type": "HumanMadeObject",
"_label": "Back of Photograph",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300190692",
"type": "Type",
"_label": "Back Part",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300241583",
"type": "Type",
"_label": "Part Type"
}
]
}
],
"carries": [
{
"type": "LinguisticObject",
"content": "Photograph of Example Painting, taken 1932"
}
]
}
]
}