Skip to content

Commit

Permalink
Shart DCMI from VRA
Browse files Browse the repository at this point in the history
  • Loading branch information
zimeon committed Oct 27, 2023
1 parent b29d54d commit aa5187d
Show file tree
Hide file tree
Showing 292 changed files with 6,211 additions and 3 deletions.
40 changes: 40 additions & 0 deletions dcmi-workshop/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# DCMI 2023 IIIF Workshop

This is part the [DCMI 2023 IIIF Workshop]().

## About the workshop
Access to image-based resources is fundamental to research, scholarship and the transmission of cultural knowledge. Digital images are a container for much of the information content in the Web-based delivery of images, books, newspapers, manuscripts, maps, scrolls, single sheet collections, and archival materials. Yet much of the Internet's image-based resources are locked up in silos, with access restricted to bespoke, locally built applications. A large community of the world's leading research libraries and image repositories have embarked on an effort to collaboratively produce an interoperable technology and community framework for image delivery.

This workshop will introduce the basics of the International Image Interoperability Framework (IIIF) starting with demonstrating the use cases it supports; including side by side comparison, annotations and layering of images. It will then go on to look into the Image API and provide a method for participants to upload their own images to the Internet Archive so they can access the IIIF Image support the IA provides.

The second part of the workshop will focus on linking multiple IIIF images together with metadata to provide a IIIF Presentation API manifest and look at the different tools that are available to work with these manifests. Participants will create their own manifests and look to create an exhibit showing off their work.

## Speaker Bios:

Tom Cramer is the Chief Technology Strategist, Associate University Librarian & Director of Digital Library Systems & Services for the Stanford University Libraries. He directs the technical development and delivery of Stanford’s digital library services, including digitization, management, preservation and access of digital resources that support teaching, learning and research. He is the founder of the International Image Interoperability Framework (IIIF), a founder of the Samvera Community, the first adopter and an active contributor to Blacklight, and a member of the FOLIO Community Council. He is the President of the Open Library Foundation and co-chair of the CLOCKSS Board of Directors. He has served as a co-PI for the suite of LD4L and LD4P grants from their inception to present day.

Simeon Warner is Associate University Librarian for IT and Open Scholarship at Cornell University Library. His responsibilities include oversight of IT operations, user experience, web programming, digital preservation, and open scholarly publishing. I have particular interest in interoperability between information systems and the development of standards and collaborations to facilitate that. Current work includes digital preservation (OCFL), evolution of the FOLIO library services platform, use of linked open data for description and discovery of library resources (LD4L/LD4P), image and A/V interoperability (IIIF), and repositories for open-access scholarly publishing (including work with Samvera and ORCID). Past projects include technical direction of the arXiv e-print archive and development of the OAI-PMH and ResourceSync standards.

## Contributor Bio:

Glen Robson works as the IIIF Technical Coordinator and runs a monthly 5 day online training course along with designing custom training for different institutions on IIIF and AV and reusing IIIF resources in various research systems like Omeka, Zooniverse and other annotation systems. Glen has been involved in the IIIF community since 2014 and previously worked at the National Library of Wales and worked on their IIIF implementation to support various crowdsourcing, maps and Newspaper projects.

## Plan:

### Day 1:
* Introductions and intro to IIIF - 1 hour
* Introduce exercise on taking a manifest from an institution and opening it in a viewer
* Break - 15mins
* Exercise time - 15mins
* Looking at the image API - 1 hour
* Introduce exercise on uploading image to the internet archive and leave as home work

### Day 2:
* Presentation API - 30mins
* Introduce exercise on using the Manifest Editor and using the images from day 1
* Exercise time - 15 mins
* Things to do with Manifests - 30mins
* Introduce Exhibit exercise
* Break - 15 mins
* Exercise time - 30 mins
* Project demos and summary - 30 mins
36 changes: 36 additions & 0 deletions dcmi-workshop/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
# Summary

- [Overview](README.md)
- [What is IIIF](part1/whatisiiif.md)
- [Exercise](part1/guides.md)

## Image API
- [Image API](part2/image-api.md)
- [Identifier](part2/image-api/identifier.md)
- [Region](part2/image-api/region.md)
- [Size](part2/image-api/size.md)
- [Rotation](part2/image-api/rotation.md)
- [Quality](part2/image-api/quality.md)
- [Format](part2/image-api/format.md)
- [File formats](part2/fileformats.md)
- [Uses](part2/uses.md)
- [Getting started](part2/image-servers/README.md)
- [Hosted - Internet Archive](part2/image-servers/iiif-hosting-ia.md)
- [Static Images - Workbench](part2/image-servers/level0-workbench.md)
- [Cantaloupe (Advanced)](part2/image-servers/setting-up-cantaloupe.md)
- [Scaling IIIF Images](part2/scaling.md)

## Presentation API
- [Presentation API](part3/prezi-intro.md)
- [How do people create Manifests?](part3/prezi-how.md)
- [Create a Manifest](part3/digirati-editor/standalone.md)
- [Create a AV Manifest](part3/digirati-editor/Add_video_manifest.md)
- [Things to do with Manifests](manifests.md)
- [Annotating with Mirador](part4/annotations-exercises.md)
- [Book of Remembrance](part4/annotations-stores.md)
- [Book of Remembrance - Results](part4/annotations-stores-results.md)
- [Transcription for Pedagogy](annotation-use-cases/FromThePage.md)
- [Pandemic Crowdsourcing with Wikidata](annotation-use-cases/wikidata.md)

- [Create an Exhibit](exhibit/exhibit.md)
- [Project demos and summary](demos.md)
39 changes: 39 additions & 0 deletions dcmi-workshop/annotation-use-cases/AV.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Audio and Visual Annotations

In the last few years there have been a number of tools developed to support Audio and Visual annotations. A/V was added in IIIF version 3 so it is a relatively recent addition and the tool support is rapidly improving.

## Timeliner

Timeliner is an annotation tool for music education. It allows students and educators to describe the structure of a piece of music (or any audio), creating a hierarchy of parts and visualising the parts as nested bubbles.

https://cultural-heritage.digirati.com/our-work/timeliner/

<iframe width="100%" height="415" src="https://www.youtube-nocookie.com/embed/gn37PAO9X2s" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

## Europeana Video Editor

Another powerful annotation tool for AV is the Europeana Video Player/Editor. As well as playing IIIF AV resources the EU Player also has annotation functionality that allows you to create general annotations and also video subtitles.

https://video-editor.eu/

### Annotations

![EU Player annotations](eu_player_annotations.png)


### Subtitle editing

![EU Player subtitles](eu_player_subtitles.png)


## AudiAnnotate

AudiAnnotate is a publication platform for audio transcriptions created by various existing audio tools like [Sonic Visualiser](https://www.sonicvisualiser.org/). The idea is that you can use your existing tool workflow to create a transcription then upload it to AudiAnnotate. AudiAnnotate will then convert the transcription into IIIF annotations and use a IIIF viewer to displayer the results. You can see a list of projects here:

http://audiannotate.brumfieldlabs.com/

and one project example here:

https://tanyaclement.github.io/sexton_sweetbriar_1966/pages/anne-sexton-class-visit-at-sweetbriar-college-1966.html#?c=&m=&s=&cv=

AudiAnnotate uses GitHub for storage so it can be run as a free service.
29 changes: 29 additions & 0 deletions dcmi-workshop/annotation-use-cases/FromThePage.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Transcription for Pedagogy

I came across [this article](https://content.fromthepage.com/transcription-for-pedagogy/) on using an annotation system called FromThePage for teaching. FromThePage is a transcription tool that provides a wiki like interface for transcribing IIIF Manifests. You can see a full list of features on the [about FromThePage](https://content.fromthepage.com/about/) site. It is open source but also offers a hosted transcription interface.

For a more in depth workshop including and how to sign up for a trial membership and annotate your own manifests please see the [FromThePage guest presentation](https://training.iiif.io/iiif-online-workshop/GuestPresentations.html#crowdsourced-transcription-using-fromthepage--iiif) which is part of the 5 day IIIF online training.

![Screenshot of FromThePage](FromThePage.png)

The pedagogy use case mentioned in the article has the following stages:

## Step 1: Find the Archival Collection

In this case this is a physical challenge where students are tasked with going to the archive to find a set of letters. You could imagine this would also work in a digital only session where students are tasked with finding items in an online catalogue.

## Step 2: Transcribe

Once the Students have found the material the course tutor sends round a link to the students so they can start transcribing the letters.

## Step 3: Review and Edit

Once the students have finished their assigned transcriptions the course tutor is able to review and edit the transcriptions to provide the students with feedback.

## Step 4: Write a Paper.

Finally using the archival material they are now familiar with they are asked to write a report using the letters as historical sources.

# Review

This is a use case which could be used in a wide variety of situations particularly with the wealth of IIIF material available. With FromThePage being hosted you don't need any infrastructure to support the project as long as the material you are working with is available as IIIF.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
41 changes: 41 additions & 0 deletions dcmi-workshop/annotation-use-cases/allmaps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Annotations and Maps

One of the nice things about IIIF is that it is constantly evolving. By allowing a standard interface to access Cultural Heritage objects it allows new tools to be developed and one of these is [AllMaps.org](https://allmaps.org/). This tool allows you to Geo-reference a IIIF Map so it can be overlaid onto a modern map.

It starts the same way as many of the solutions discussed earlier with a IIIF Manifest. For this example I am going to use a map of Washington D.C. from the Library of Congress:

* [https://www.loc.gov/resource/g3850.cw0678500/?r=-0.34,0,1.679,0.982,0](https://www.loc.gov/resource/g3850.cw0678500/?r=-0.34,0,1.679,0.982,0)
* [Manifest](https://www.loc.gov/item/88694013/manifest.json)

The first stage is to navigate to [https://editor.allmaps.org](https://editor.allmaps.org) and enter the Manifest URL:

![Enter IIIF Manifest URL into Allmaps](all_maps_start.png)

The second stage is to navigate to Mask to start geo-referencing.

![Select Mask on allmaps Menu](all_maps_menu.png)

The first process of geo-referencing is to cut out the parts of the image that contain the map. This is called Masking. In this example part of the Map contains the title so is cut out of the Map that needs geo-referencing.

![Masking with allmaps](all_maps_masking.png)

Now the real geo-referencing can start. Select a point on the modern map and then select the corresponding location on the IIIF map. Once you have added enough points allmaps will be able to warp and fit the historical map on top of the modern map.

![geo-referencing](all_maps_georeferencing.png)

You can then view the resulting transformation by clicking the modern map.

![visualising the geo-referencing with allmaps](all_maps_demo.png)

This type of geo-referencing can be very useful if you are trying to co-locate different data for example maps from different periods or annotations from related documents.

For example there is this [Cynefin project](https://www.library.wales/digitisation-projects/places-of-wales/about-places-of-wales) from the National Library of Wales which shows the 1800s Tithe maps of Wales linked to apportionments which detail land use at the time the maps were created:

https://places.library.wales/browse/52.415/-4.084

This was a crowdsourcing project which used a similar Geo-referencing tool called [Georeferencer](https://georeferencer.com/).

![cynefin.png](cynefin.png)



1 change: 1 addition & 0 deletions dcmi-workshop/annotation-use-cases/annotations.json

Large diffs are not rendered by default.

Binary file added dcmi-workshop/annotation-use-cases/cynefin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 15 additions & 0 deletions dcmi-workshop/annotation-use-cases/ida.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# The Indigenous Digital Archive

This project is an important demonstration of a community reclaiming ownership of their records and re-contextualizing them to make sure the story is heard. The first part of the project was to make available 78 linear feet of microfilmed government records from the National Archives relating to the Indian boarding schools in New Mexico.

"The era of government-run Indian boarding schools is a controversial and sometimes shameful
chapter in American history. Many children were sent away for years at a time, forced to wear
European clothes and forbidden from speaking their Native languages. They dressed in military-
style uniforms, marched to meals and were sent out to work during school vacations, a practice
called “outing.”

The schools were designed to disperse and mix students to separate them from their culture."

From an article in the *[Santa Fe New Mexican](https://perma.cc/7G2P-V934)*.

Once the material was available as IIIF they could use various automated tools to extract the names of schools and tribes to make the content discoverable. They thought very carefully about what items to make available and enlisted fellows from the indigenous community to vet content and also add annotations using Madoc to re-interpret some of the content in the Archive. For more information on this process see the [Respectful Online Access](https://omeka.dlcs-ida.org/s/ida/page/respect) statement on the project website.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit aa5187d

Please sign in to comment.