Table of Contents
Introduction
Names are linguistic labels given to some entity, and represented as a common JSON structure in all endpoints.
Names are described in the base patterns of the model documentation, and examples are present for practically every class.
Property Definitions
Properties of Names
Property Name | Datatype | Requirement | Description |
---|---|---|---|
id |
string | Optional | If present, the value MUST be a URI identifying the name, from which a representation of the name can be retrieved |
type |
string | Required | The class for the name, which MUST be the value "Name" |
_label |
string | Optional | A human readable label, intended for developers |
_complete |
boolean | Optional | Non-Semantic. If there is an id property with a URI, and there is more information about the name 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 |
content |
string | Required | The string form of the Name |
classified_as |
array | Recommended | An array of json objects, each of which is a further classification of the name and MUST follow the requirements for Type |
language |
array | Recommended | An array of json objects, each of which is a language present in the content of the name and MUST follow the requirements for Language |
part |
array | Optional | An array of json objects, each of which is a part of the current name, and MUST follow these requirements for Names |
identified_by |
array | Optional | An array of json objects, each of which is a name for this Name and follows the Name pattern |
referred_to_by |
array | Optional | An array of json objects, each of which is either a reference to a textual work that refers to the name, or an embedded statement about the Name. |
assigned_by |
array | Optional | An array of json objects, each of which is an assignment of the Name, and MUST follow the requirements for Assignments |
Property Diagram
Incoming Properties
Name instances are typically found as the object of the following properties. This list is not exhaustive, but is intended to cover the likely cases.
Property Name | Source Class | Description |
---|---|---|
identified_by |
All | Names are used to provide an identifying label to the entity via identified_by. |
(And that's all!)
Example
An object is given the name "Hacha (Ceremonial Axe)", with a note that the original form was 'hacha'.
- It has a URI given in
id
(that identifies the Name itself, not the object) - It has a
type
of "Name" - It is
classified_as
a primary name, withid
of aat:300404670 and atype
of "Type" - It has
content
of "Hacha (Ceremonial Axe)" - It has a display label of "Assigned Title"
- It is
referred_to_by
a statement, with atype
of "LinguisticObject",classified_as
a note withid
of aat:300027200 and withcontent
of "Title was originally ..." - It has languages of English, with an
id
of aat:300388277 andtype
of "Language", and Spanish, with anid
of aat:300389311 andtype
of "Language" - It has a specific
part
, which ...- ... also has a
type
of "Name" - ... is
classified_as
a subtitle, with anid
of aat:300312006 - ... has
content
of "Ceremonial Axe" - ... and a language of English, as above.
- ... also has a
{
"@context": "https://linked.art/ns/v1/linked-art.json",
"id": "https://linked.art/example/object/9",
"type": "HumanMadeObject",
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404670",
"type": "Type",
"_label": "Primary Name"
}
],
"content": "Hacha (Ceremonial Axe)",
"identified_by": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300404669",
"type": "Type",
"_label": "Display Title"
}
],
"content": "Assigned Title"
}
],
"referred_to_by": [
{
"type": "LinguisticObject",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300027200",
"type": "Type",
"_label": "Note",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300418049",
"type": "Type",
"_label": "Brief Text"
}
]
}
],
"content": "Title was originally given as 'hacha'"
}
],
"language": [
{
"id": "http://vocab.getty.edu/aat/300389311",
"type": "Language",
"_label": "Spanish"
},
{
"id": "http://vocab.getty.edu/aat/300388277",
"type": "Language",
"_label": "English"
}
],
"part": [
{
"type": "Name",
"classified_as": [
{
"id": "http://vocab.getty.edu/aat/300312006",
"type": "Type",
"_label": "Subtitle"
}
],
"content": "Ceremonial Axe",
"language": [
{
"id": "http://vocab.getty.edu/aat/300388277",
"type": "Language",
"_label": "English"
}
]
}
]
}
]
}
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/9)
class O1 object;
O1-- type -->O1_0[HumanMadeObject]
class O1_0 classstyle;
O2( _ )
class O2 name;
O2-- type -->O2_0[Name]
class O2_0 classstyle;
O3(aat:300404670)
class O3 type;
O3-- type -->O3_0[Type]
class O3_0 classstyle;
O3-- _label -->O3_3("''Primary Name''")
class O3_3 literal;
O2-- classified_as -->O3
O2-- content -->O2_3("''Hacha (Ceremonial Axe)''")
class O2_3 literal;
O4( _ )
class O4 name;
O4-- type -->O4_0[Name]
class O4_0 classstyle;
O5(aat:300404669)
class O5 type;
O5-- type -->O5_0[Type]
class O5_0 classstyle;
O5-- _label -->O5_3("''Display Title''")
class O5_3 literal;
O4-- classified_as -->O5
O4-- content -->O4_3("''Assigned Title''")
class O4_3 literal;
O2-- identified_by -->O4
O6( _ )
class O6 infoobj;
O6-- type -->O6_0[LinguisticObject]
class O6_0 classstyle;
O7(aat:300027200)
class O7 type;
O7-- type -->O7_0[Type]
class O7_0 classstyle;
O7-- _label -->O7_3("''Note''")
class O7_3 literal;
O8(aat:300418049)
class O8 type;
O8-- type -->O8_0[Type]
class O8_0 classstyle;
O8-- _label -->O8_3("''Brief Text''")
class O8_3 literal;
O7-- classified_as -->O8
O6-- classified_as -->O7
O6-- content -->O6_3("''Title was originally given as 'hacha'''")
class O6_3 literal;
O2-- referred_to_by -->O6
O9(aat:300389311)
class O9 type;
O9-- type -->O9_0[Language]
class O9_0 classstyle;
O9-- _label -->O9_3("''Spanish''")
class O9_3 literal;
O2-- language -->O9
O10(aat:300388277)
class O10 type;
O10-- type -->O10_0[Language]
class O10_0 classstyle;
O10-- _label -->O10_3("''English''")
class O10_3 literal;
O2-- language -->O10
O11( _ )
class O11 name;
O11-- type -->O11_0[Name]
class O11_0 classstyle;
O12(aat:300312006)
class O12 type;
O12-- type -->O12_0[Type]
class O12_0 classstyle;
O12-- _label -->O12_3("''Subtitle''")
class O12_3 literal;
O11-- classified_as -->O12
O11-- content -->O11_3("''Ceremonial Axe''")
class O11_3 literal;
O11-- language -->O10
O2-- part -->O11
O1-- identified_by -->O2
Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)
Future Considerations
- Assignments, as described for Identifiers, could easily be added for Names, but there has not been a use case proposed.