Audio Work
About
Audio works are works where the primary fileset(s) are derived from one or more audio files. The fileset(s) should be served to a IIIF viewer on the Work page by a IIIF Presentation 3 manifest. While there may be multiple filesets, there should only be one canvas with multiple annotations.
The audio work MAY have a pcdmuse:IntermediateFile and a pcdmuse:PreservationFile. In the case that
there is only one file, that fileset should include a file that is both a pcdmuse:IntermediateFile and a
pcdmuse:PreservationFile. That way, the pcdmuse:IntermediateFile will always be served to the viewer on
the work page. In the case where there are 2 files, the pcdmuse:IntermediateFile has had additional processing done to
it beyond what would happen through standard programmatic derivative generation and thus may need to be in its own
fileset. The representative thumbnail for the work should be derived from the pcdmuse:IntermediateFile when it
is not curated. In the case that there is only one file, the file should be both a pcdmuse:PreservationFile and
a pcdmuse:IntermediateFile.
Audio works may have closed-captioning or transcript files and may have them in multiple languages.
Audio works may have hierarchical structure described by metadata properties that should be converted into IIIF
Presentation structures and ranges and therefore pcdmworks:Range and :code:`pcdmworks:TopRange`s.
An audio work may have other filesets of any mime type available to the user for download.
All filesets may have restrictions that prohibit view / access.
Metadata Properties
Descriptive Properties
Descriptive properties are described in our vendor supplied MAP.
Structural Properties
Audio works may be derived from one or more filesets but will always be treated as a single canvas in the viewer.
Suggested structure for 1 primary fileset is described here.
1@prefix : <https://location-of-future-repository/extra/paths/> .
2@prefix bibframe: <http://id.loc.gov/ontologies/bibframe/> .
3@prefix dcterms: <http://purl.org/dc/terms/> .
4@prefix fedora: <http://fedora.info/definitions/v4/repository#> .
5@prefix identifiers: <http://id.loc.gov/vocabulary/identifiers/> .
6@prefix pcdm: <http://pcdm.org/models#> .
7@prefix pcdmff: <http://pcdm.org/file-format-types#> .
8@prefix pcdmuse: <http://pcdm.org/use#> .
9@prefix pcdmworks: <http://pcdm.org/works#> .
10@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
11
12:sample-audio a pcdmworks:Work ;
13 dcterms:title "Interview with Andrea Ludden, 2017-02-06" ;
14 identifiers:local "Andrea_Ludden_2_6_17_RNC014", "rfta:118" ;
15 pcdm:hasMember :sample-audio-original-mods, :sample-audio-fileset, :sample-audio-release, :sample-audio-transcript .
16
17:sample-audio-original-mods a pcdmworks:Fileset ;
18 rdfs:label "MODS from Islandora - Fileset" ;
19 pcdm:memberOf :sample-audio ;
20 pcdm:hasFile :sample-file-mods-xml .
21
22:sample-file-mods-xml a pcdmff:Markup ;
23 rdfs:label "MODS XML from Islandora" ;
24 pcdm:fileOf :sample-audio-original-mods ;
25 fedora:hasVersions :path-to-the-actual-mods .
26
27:sample-audio-fileset a pcdmworks:Fileset ;
28 rdfs:label "Audio Files for Interview with Andrea Ludden, 2017-02-06" ;
29 pcdm:memberOf :sample-audio ;
30 pcdm:hasFile :sample-file-intermediate, :sample-file-preservation .
31
32:sample-file-preservation a pcdmuse:PreservationFile, pcdmff:Audio ;
33 rdfs:label "Preservation File for Interview with Andrea Ludden, 2017-02-06" ;
34 pcdm:fileOf :sample-audio-fileset ;
35 bibframe:duration 2349 ;
36 fedora:hasVersions :path-to-the-preservation-file-for-sample-file-preservation .
37
38:sample-file-intermediate a pcdmuse:IntermediateFile, pcdmff:Audio ;
39 rdfs:label "Intermediate File for Interview with Andrea Ludden, 2017-02-06" ;
40 pcdm:fileOf :sample-audio-fileset ;
41 bibframe:duration 2349 ;
42 fedora:hasVersions :path-to-the-preservation-file-for-sample-file-intermediate .
43
44:sample-audio-release a pcdmworks:Fileset ;
45 rdfs:label "Release File for Interview with Andrea Ludden, 2017-02-06" ;
46 pcdm:memberOf :sample-audio ;
47 pcdm:hasFile :sample-release-file .
48
49:sample-release-file a pcdmff:Document ;
50 rdfs:label "Release File for Interview with Andrea Ludden, 2017-02-06" ;
51 pcdm:fileOf :sample-audio-release ;
52 fedora:hasVersions :path-to-the-actual-release-file .
53
54:sample-audio-transcript a pcdmworks:Fileset ;
55 rdfs:label "Transcripts for Interview with Andrea Ludden, 2017-02-06" ;
56 pcdm:memberOf :sample-audio ;
57 pcdm:hasFile :sample-english-transcript .
58
59:sample-english-transcript a pcdmuse:Transcript ;
60 rdfs:label "English Web/VTT Interview with Andrea Ludden, 2017-02-06" ;
61 pcdm:fileOf :sample-audio-release ;
62 dcterms:language "en" ;
63 fedora:hasVersions :path-to-the-actual-transcript .
Suggested structure for more than one fileset is described here.
1@prefix : <https://location-of-future-repository/extra/paths/> .
2@prefix bibframe: <http://id.loc.gov/ontologies/bibframe/> .
3@prefix dcterms: <http://purl.org/dc/terms/> .
4@prefix fedora: <http://fedora.info/definitions/v4/repository#> .
5@prefix iana: <http://www.iana.org/assignments/relation/> .
6@prefix identifiers: <http://id.loc.gov/vocabulary/identifiers/> .
7@prefix ore: <http://www.openarchives.org/ore/terms/> .
8@prefix pcdm: <http://pcdm.org/models#> .
9@prefix pcdmff: <http://pcdm.org/file-format-types#> .
10@prefix pcdmuse: <http://pcdm.org/use#> .
11@prefix pcdmworks: <http://pcdm.org/works#> .
12@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
13
14:sample-audio-multi a pcdmworks:Work ;
15 dcterms:title "McClain, William A.: WWII Oral History" ;
16 identifiers:local "wwiioh:2002", "wwiioh:2003" ;
17 iana:first :proxy-for-sample-audio-range-part1 ;
18 iana:last :proxy-for-sample-audio-range-part2 ;
19 bibframe:duration 3373 ;
20 pcdm:hasMember :sample-audio-multi-original-mods, :sample-audio-range-part1, :sample-audio-range-part2 .
21
22:sample-audio-range-part1 a pcdmworks:Range ;
23 rdfs:label "Part 1";
24 pcdm:hasMember :sample-audo-multi-fileset-part1 .
25
26:sample-audio-range-part2 a pcdmworks:Range ;
27 rdfs:label "Part 2";
28 pcdm:hasMember :sample-audo-multi-fileset-part2 .
29
30:sample-audio-multi-original-mods a pcdmworks:Fileset ;
31 rdfs:label "MODS from Islandora - Fileset" ;
32 pcdm:memberOf :sample-audio-multi ;
33 pcdm:hasFile :sample-audio-multi-file-mods-xml .
34
35:sample-audio-multi-mods-xml a pcdmff:Markup ;
36 rdfs:label "MODS XML from Islandora" ;
37 pcdm:fileOf :sample-audio-multi-original-mods ;
38 fedora:hasVersions :path-to-the-actual-mods .
39
40:sample-audio-multi-fileset-part1 a pcdmworks:Fileset ;
41 rdfs:label "Audio Files for McClain, William A.: WWII Oral History - Part 1" ;
42 pcdm:memberOf :sample-audio-multi ;
43 pcdm:hasFile :sample-file-intermediate, :sample-file-preservation .
44
45:sample-file-preservation a pcdmuse:PreservationFile, pcdmff:Audio ;
46 rdfs:label "Preservation File for McClain, William A.: WWII Oral History - Part 1" ;
47 pcdm:fileOf :sample-audio-multi-fileset-part1 ;
48 bibframe:duration 1519 ;
49 fedora:hasVersions :path-to-the-preservation-file-for-sample-file-preservation-part1 .
50
51:sample-file-intermediate a pcdmuse:IntermediateFile, pcdmff:Audio ;
52 rdfs:label "Intermediate File for McClain, William A.: WWII Oral History - Part 1" ;
53 pcdm:fileOf :sample-audio-multi-fileset-part1 ;
54 bibframe:duration 1519 ;
55 fedora:hasVersions :path-to-the-intermediate-file-for-sample-file-intermediate-part-1 .
56
57:sample-audio-multi-fileset-part2 a pcdmworks:Fileset ;
58 rdfs:label "Audio Files for McClain, William A.: WWII Oral History - Part 2" ;
59 pcdm:memberOf :sample-audio-multi ;
60 pcdm:hasFile :sample-file-intermediate, :sample-file-preservation .
61
62:sample-file-preservation a pcdmuse:PreservationFile, pcdmff:Audio ;
63 rdfs:label "Preservation File for McClain, William A.: WWII Oral History - Part 2" ;
64 pcdm:fileOf :sample-audio-multi-fileset-part2 ;
65 bibframe:duration 1854 ;
66 fedora:hasVersions :path-to-the-preservation-file-for-sample-file-preservation-part2 .
67
68:sample-file-intermediate a pcdmuse:IntermediateFile, pcdmff:Audio ;
69 rdfs:label "Intermediate File for Interview with Andrea Ludden, 2017-02-06" ;
70 pcdm:fileOf :sample-audio-multi-fileset-part2 ;
71 bibframe:duration 1854 ;
72 fedora:hasVersions :path-to-the-preservation-file-for-sample-file-intermediate-part2 .
73
74:proxy-for-sample-audio-range-part1 a ore:Proxy ;
75 iana:next :proxy-for-sample-audio-range-part2 ;
76 ore:proxyIn :sample-audio-multi ;
77 ore:proxyFor :sample-audio-range-part1 .
78
79:proxy-for-sample-audio-range-part2 a ore:Proxy ;
80 iana:prev :proxy-for-sample-audio-range-part1 ;
81 ore:proxyIn :sample-audio-multi ;
82 ore:proxyFor :sample-audio-range-part2 .
Technical Properties
Technical properties are identified and listed in our metadata application profile in the files tab.
Viewing Experience
IIIF Viewer
Audio works should be rendered to the user in a IIIF presentation viewer like IIIF React Media Player, Universal Viewer, Clover IIIF, or Mirador. Our current IIIF configuration along with “viewing experience” for images is described in our Audio IIIF Recipe document.
In the case where a Audio work has a pcdmuse:PreservationFile and pcdmuse:IntermediateFile file, the
pcdmuse:IntermediateFile should be displayed in the viewer to users by default on the work page. A work may have both
types of files when the intermediate is not derived programmatically from the preservation file.
An audio work may also have multiple files that should be served to the single canvas in the items property.
While we expect to use a IIIF viewer for display, it is important to note that we have closed captioning files and
structural metadata that should be transformed into IIIF structures and ranges. Currently, we use our own internal viewer
for displaying this, but we should adopt a community viewer. As of the time of this writing, only the
IIIF React Media Player supports this as part of its
<StructuredNavigation /> component. To keep things simple, we are okay with using this viewer for all audio and
video works. A sample of this viewer can be seen here and below:
Our current viewer with structures and ranges can be seen here:
In addition to structures and ranges, most of our audio and video works have caption files and transcripts in 1 or more languages. HTML 5 does not support caption files for audio, so showing the caption as a navigable transcript is important. Here is an example of one of our current audio objects in Clover IIIF:
If helpful, see our `Audio IIIF Recipe documentation<https://utk-iiif-cookbook.readthedocs.io/en/latest/contents/audio.html>`_ for how this should be implemented.
Location-based Viewing
Our metadata currently includes cartographic and coordinate information so that the metadata record can be easily intermixed with a location-based viewer. An item should not be playable from this view, but it should pop out into a new window. We also include a URI that points at a Geonames object that includes this same information.
If needed, we can continue to store cartographic and coordinate information in a separate field to make this easy.
Some sample location-based display might be:
If possible, we would also like our location information to be shared as a navPlace extension in our IIIF
manifests.
Rights Viewing
While we store our rights as uris (see metadata application profile), we’d like these statements to be actionable and render the appropriate badge and usage information to the user in both the IIIF viewer (when metadata is on) and in our metadata display below.
File Viewer
Users should be able to easily download the primary filesets.
If a fileset is only a pcdm:PreservationFile it should never be publicly visible.
Interoperability
OAI-PMH
Like other work types, audio works should be represented by an OAI-PMH record based on its metadata application profile. The work should be a record of an OAI set for each corresponding collection to which the object belongs. Our metadata application profile should have a rule that states which field values should be remixed to OAI-PMH for a given metadata format (simple dublin core, dcterms).
IIIF Presentation v3
All audio works should have a corresponding IIIF presentation v3 manifest that allows the object to be shared and remixed in other projects. For our current system, we have a description of our current presentation 3 mapping in the corresponding recipe.
For audio works, our expectations are that structures and ranges be stored in the structures property with accompanying ranges that target the video canvas. Also, all caption files should be annotations in the annotations property with the motivation of supplementing.
Finally, audio works should always be single canvased. If there are multiple files, they should be ordered based on
the corresponding ore:Proxy like this example.
Bulkrax
Import
Like all work types, images should be importable according to our Metadata Application Profile via Bulkrax import using CSV and XXXXXXX file storage solution.
Export
In addition to import functionality, images should have a variety of export options including the ability to export only filesets related to preservation for easy transfer to Chronopolis. Those filesets should include:
pcdmuse:PreservationFilepcdmff:Documentpcdmuse:Transcript
Restrictions
Like other work types, video works may have restrictions at the work and fileset / file level.