vra.config

This is a config file to read and write VRA Core Essentials XMP embedded metadata using ExifTool.

VRA Core schema is a data standard for the description of works of visual culture as well as the images that document them.

VRA Essentials is made up select VRA Core properties adapted to the Adobe XMP embedded metadata specification.

The prefered XMP prefix is "vrae" and the namespace is http://www.vraweb.org/vracore/4.0/essential/

Properties are defined as either Collection, Work, or Image

• Collection: describes an aggregate of Work and Image objects
• • Only CollectionRefid, CollectionHref, and CollectionSource are currently supported
• • Note that Collection Name uses dc:publisher (exiftool tag Publisher)
• Work: describes the creative artwork, object or performance shown in the image/photo.
• • All Work display and indexed properties and sub-properties are supported, but only selected attributes are supported.
• Image: describes the photo as a visual surrogate of the Artwork/Object.
• • When possible, VRA Image properties use IPTC XMP properties in order to maximize interoperability in image processing/editing/database applications.

Properties have a set of indexed values, e.g., WorkAgentIndexed and a corresponding display element, e.g., WorkAgent

• Indexed values are repeatable, i.e., you can have multiple Agents (architect, landscape architect, etc.). An indexed set is an XMP sequential array or structures.
• Display values concatenate Indexed values into a single text string that can be modified for readability. A display element is a simple XMP text property.

Use

Install exiftool v 10.70 or greater.

• Place the vrae.config file in the same directory as exiftool.exe. -- To read/write metadata, start the exiftool command with -config vrae.config
• Rename vrae.config to .ExifTool_config and place it in your home directory or the exiftool application directory. -- To read/write metadata, start the exiftool command with -config [path to vrae.config]

More information on exiftool config files

See the Documentation folder for

• Excel spreadsheet with vrae tags, definitions, and example commands

See the Examples folder for

• JPEG file with all VRAE XMP properties
• XMP file
• ExifTool read files (flattened list, CSV, JSON)

Example commands

Read all vrae tags

exiftool -config vrae.config -xmp-vrae:all test.jpg

Read WorkMaterial

exiftool -config vrae.config -xmp-vrae:WorkMaterial test.jpg

Read WorkMaterialIndexed to JSON (more useful than flattened tag list)

exiftool -config vrae.config -T -j -xmp-vrae:WorkMaterialIndexed -S -struct test.jpg

Write WorkMaterial

exiftool -config vrae.config -xmp-vrae:WorkMaterial="bronze, on a marble base material" test.jpg

Write Work MaterialIndexed

exiftool -config vrae.config -xmp-vrae:WorkMaterialIndexed="[{value=bronze, vocab=AAT, refid=300010957, href=http://vocab.getty.edu/aat/300010957}, {value=marble, vocab=AAT, refid=300011443, href=http://vocab.getty.edu/aat/300011443, extent=base}]" test.jpg

ExifTool Tags

Tag	/Struct Field	//Struct Field	Type	Controled values
CollectionRefid			(text)
CollectionHref			(text)
CollectionSource			(text)
WorkMetadataDate			(date)	YYYY-MM-DDThh:mm:ss.sTZD
WorkMetadataId			(text)
WorkMetadataSource			(text)
WorkMetadataHref			(text)	URL
WorkHref			(text)	URL
WorkRefid			(text)
WorkAgent			(text)
WorkAgentIndexed			[seq] of [structure]
	Extent		(text)
	Attribution		(text)	after, assistant to, associate of, atelier of, attributed to, circle of, copyist of, follower of, formerly attributed to, manner of, manufactory of, office of, possibly by, probably by, pupil of, school of, studio of, style of, workshop of
	Name		(text)
	NameType		(text)	personal, corporate, family, other
	NameVocab		(text)
	NameRefid		(text)
	NameHref		(text)	URL
	NameSource		(text)
	DateEarliest		(text)
	DateLatest		(text)
	DateType		(text)	life, activity, unknown, other
	Culture		[seq] of [structure]
		Value	(text)
		Href	(text)	URL
		Refid	(text)
		Source	(text)
		Vocab	(text)
	Role		[seq] of [structure]
		Value	(text)
		Href	(text)	URL
		Source	(text)
		Refid	(text)
		Vocab	(text)
	Source		(text)
WorkCulturalContext			(text)
WorkCulturalContextIndexed			[seq] of [structure]
	Value		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
	Extent		(text)
	Source		(text)
WorkDate			(text)
WorkDateIndexed			[seq] of [structure]
	Type		(text)	alteration, broadcast, bulk, commission, creation, design, destruction, discovery, exhibition, inclusive, performance, publication, restoration, view, other
	EarliestDate		(date)	ISO 8601
	LatestDate		(date)	ISO 8601
	Extent		(text)
	Source		(text)
WorkDescription			(text)
WorkDescriptionIndexed			[seq] of [structure]
	Value		(text)
	Lang		(text)	ISO 639-1 Code
	Refid		(text)
	Href		(text)	URL
	Extent		(text)
	Source		(text)
WorkInscription			(text)
WorkInscriptionIndexed			[seq] of [structure]
	Text		(text)
	TextType		(text)	signature, mark, caption, date, text, translation, other
	TextSource		(text)
	Lang		(text)	ISO 639-1 Code
	Position		(text)
	Extent		(text)
	Author		(text)
	AuthorVocab		(text)
	AuthorRefid		(text)
	AuthorHref		(text)	URL
	AuthorSource		(text)
WorkLocationCreation (deprecated)			(text)
WorkLocationDiscovery (deprecated)			(text)
WorkLocationExhibition (deprecated)			(text)
WorkLocationFormerOwner (deprecated)			(text)
WorkLocationFormerRepository (deprecated)			(text)
WorkLocationFormerSite (deprecated)			(text)
WorkLocationInstallation (deprecated)			(text)
WorkLocationintended (deprecated)			(text)
WorkLocationOther (deprecated)			(text)
WorkLocationOwner (deprecated)			(text)
WorkLocationPerformance (deprecated)			(text)
WorkLocationPublication (deprecated)			(text)
WorkLocationRepository (deprecated)			(text)
WorkLocationSite (deprecated)			(text)
WorkLocation			(text)	Display value for all locationIndexed properties
WorkLocationNotes			(text)
WorkLocationIndexed			[seq] of [structure]
	Type		(text)	creation, discovery, exhibition, formerOwner, formerRepository, formerSite, installation, intended, owner, performance, publication, repository, site, other
	Name		(text)
	NameVocab		(text)
	NameRefid		(text)
	NameHref		(text)	URL
	NameType		(text)	personal, corporate, family, other
	Refid		(text)
	RefidType		(text)	accession, barcode, shelfList, other
	Geo		(text)
	GeoVocab		(text)
	GeoRefid		(text)
	GeoHref		(text)	URL
	GeoExtent		(text)	neighborhood, district (urban), city, county, district, region, province, nation, empire, ruins
WorkMaterial			(text)
WorkMaterialIndexed			[seq] of [structure]
	Value		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
	Extent		(text)
	Source		(text)
WorkMeasurements			(text)
WorkMeasurementsIndexed			[seq] of [structure]
	Unit		(text)	mm, cm, dm, m, km, mil, in, ft, yd, mi, pix, mm2, cm2, m2, km2, in2, ft2, yd2, c, g, kg, Mg, t, oz, lb, cwt, ton, ppcm, ppi, ms, s, min, h, d, B, kB, MB, GB
	Extent		(text)
	Rules		(text)
	Source		(text)
	Measurements		[seq] of [structure]
		Value	(text)
		Type	(text)	area, base, bitDepth, circumference, count, depth, diameter, distanceBetween, duration, fileSize, height, length, resolution, running time, scale, size, target, weight, width, other
WorkRelation			(text)
WorkRelationIndexed			[seq] of [structure]
	Value		(text)
	Type		(text)	cartoonFor, cartoonIs, componentOf, componentIs, copyAfter, copyIs, counterProofFor, counterProofIs, depicts, depictedIn, derivedFrom, sourceFor, designedFor, contextIs, exhibitedAt, venueFor, facsimileOf, facimileIs, formerlyPartOf, formerlyLargerContextFor, imageOf, imageIs, mateOf, modelFor, modelIs, partOf, largerContectFor, partnerInSetWith, pendantOf, planFor, planIs, preparationFor, basedOn, printingPlateFor, printingPlateIs, prototypeFor, prototypeIs, relatedTo, reliefFor, impressionIs, replicaOf, replicaIs, studyFor, studyIs, versionOf, versionIs
	Href		(text)	URL
	Refid		(text)
	Relids		(text)
	Source		(text)
WorkRights			(text)
WorkRightsIndexed			[seq] of [structure]
	Type		(text)	copyrighted, publicDomain, undetermined, other
	Extent		(text)
	Refid		(text)
	Href		(text)	URL
	Text		(text)
	Lang		(text)	ISO 639-1 Code
	TextVocab		(text)
	TextHref		(text)	URL
	Holder		(text)
	HolderVocab		(text)
	HolderRefid		(text)
	HolderHref		(text)	URL
	Notes		(text)
WorkSource			(text)
WorkSourceIndexed			[seq] of [structure]
	Extent		(text)
	Refid		(text)
	RefidType		(text)	citation, ISBN, ISSN, openURL, URI, vendor, other
	Href		(text)	URL
	Value		(text)
	Type		(text)	book, donor, electronic, serial, vendor, other
	NameVocab		(text)
	NameRefid		(text)
	NameHref		(text)	URL
WorkStateEdition			(text)
WorkStateEditionIndexed			[seq] of [structure]
	Type		(text)	state, edition, impression, other
	Number		(text)
	Count		(text)
	Name		(text)
	Description		(text)
	Refid		(text)
	Href		(text)	URL
	Source		(text)
WorkStylePeriod			(text)
WorkStylePeriodIndexed			[seq] of [structure]
	Value		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
	Extent		(text)
	Source		(text)
WorkSubject			(text)
WorkSubjectIndexed			[seq] of [structure]
	Value		(text)
	Type		(text)	conceptTopic, descriptiveTopic, iconographicTopic, otherTopic, builtworkPlace, geographicPlace, otherPlace, corporateName, familyName, personalName, scientificName, otherName
	Lang		(text)	ISO 639-1 Code
	Extent		(text)
	Rules		(text)
	Source		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
WorkTechnique			(text)
WorkTechniqueIndexed			[seq] of [structure]
	Value		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
	Lang		(text)	ISO 639-1 Code
	Extent		(text)
	Source		(text)
WorkTextref			(text)
WorkTextrefIndexed			[seq] of [structure]
	Name		(text)
	NameType		(text)	book, catalog, corpus, electronic, serial, other
	Refid		(text)
	RefidType		(text)	citation, ISBN, ISSN, openURL, URI, vendor, other
	Href		(text)	URL
	Extent		(text)
	Source		(text)
WorkTitle			(text)
WorkTitleIndexed			[seq] of [structure]
	Value		(text)
	Type		(text)	brandName, cited, creator, descriptive, former, generalView, inscribed, owner, partialView, popular, repository, translated, other
	Lang		(text)	ISO 639-1 Code
	Pref		(boolean)	True, False
	Relids		(text)
	Href		(text)	URL
	Vocab		(text)
	Refid		(text)
	Source		(text)
WorkWorktype			(text)
WorkWorktypeIndexed			[seq] of [structure]
	Value		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
	Extent		(text)
	Source		(text)
ImageMetadataDate			(date)	YYYY-MM-DDThh:mm:ss.sTZD
ImageMetadataId			(text)
ImageMetadataSource			(text)
ImageMetadataHref			(text)	URL
ImageRefid			(text)
ImageHref			(text)	URL
Creator			[seq] of (text)
AuthorsPosition			(text)
ImageAgentIndexed			[seq] of [structure]
	Value		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
DateCreated			(date)	ISO 8601
ImageDescription			(text)
ImageDescriptionIndexed			[seq] of [structure]
	Value		(text)
	Lang		(text)	ISO 639-1 Code
	Refid		(text)
	Href		(text)	URL
	Extent		(text)
	Source		(text)
ImageInscription			(text)
ImageInscriptionIndexed			[seq] of [structure]
	Text		(text)
	TextType		(text)	signature, mark, caption, date, text, translation, other
	TextSource		(text)
	Lang		(text)	ISO 639-1 Code
	Position		(text)
	Extent		(text)
	Author		(text)
	AuthorVocab		(text)
	AuthorRefid		(text)
	AuthorHref		(text)	URL
	AuthorSource		(text)
ImageRelation			(text)
ImageRelationIndexed			[seq] of [structure]
	Value		(text)
	Type		(text)	facsimile of, image of, part of, preparatory for, related to
	Href		(text)	URL
	Refid		(text)
	Relids		(text)
	Source		(text)
Rights			[langAlt]
Marked			((boolean))	True, False
CopyrightOwnerName			(text)
Credit			[seq] of (text)
WebStatement			(text)	URL
Instructions			(text)
License			(text)	URL
ImageSource			(text)
ImageSourceIndexed (seq struct)			[seq] of [structure]
	Extent		(text)
	Refid		(text)
	RefidType		(text)	citation, ISBN, ISSN, openURL, URI, vendor, other
	Href		(text)	URL
	Value		(text)
	Type		(text)	book, donor, electronic, serial, vendor, other
	NameVocab		(text)
	NameRefid		(text)
	NameHref		(text)	URL
ImageSubject			(text)
ImageSubjectIndexed			[seq] of [structure]
	Value		(text)
	Type		(text)	conceptTopic, descriptiveTopic, iconographicTopic, otherTopic, builtworkPlace, geographicPlace, otherPlace, corporateName, familyName, personalName, scientificName, otherName
	Lang		(text)	ISO 639-1 Code
	Extent		(text)
	Rules		(text)
	Source		(text)
	Vocab		(text)
	Refid		(text)
	Href		(text)	URL
ImageTitle			(text)
ImageTitleIndexed (seq struct)			[seq] of [structure]
	Value		(text)
	Type		(text)	generalView, partialView
	Lang		(text)	ISO 639-1 Code
	Pref		(boolean)	True, False
	Relids		(text)
	Href		(text)	URL
	Vocab		(text)
	Refid		(text)
	Source		(text)
custom1			[struct] (text)
	_label		(text)
	Data		(text)
custom2			[struct] (text)
	_label		(text)
	Data		(text)
custom3			[struct] (text)
	_label		(text)
	Data		(text)
custom4			[struct] (text)
	_label		(text)
	Data		(text)
custom5			[struct] (text)
	_label		(text)
	Data		(text)
custom6			[struct] (text)
	_label		(text)
	Data		(text)
Publisher			[bag] of (text)
TransmissionReference			(text)
CaptionWriter			(text)
CreatorContactInfo			[struct] (text)
CreatorAddress			(text)
CreatorCity			(text)
CreatorRegion			(text)
CreatorCountry			(text)
CreatorPostalCode			(text)
CreatorWorkEmail			(text)
CreatorWorkTelephone			(text)
CreatorWorkURL			(text)	URL
Source			(text)
Credit			(text)
UsageTerms			[langAlt]
Instructions			(text)
Title			[langAlt]
Headline			(text)
Description			[langAlt]
Keywords			[bag] of (text)