Introduction to the International Image Interoperability Framework (IIIF), Tutorial at Library Network Days, National Library of Finland, Helsinki, 2017-10-26
Introduction to the International Image Interoperability Framework (IIIF)
1. Introduction to the
International Image
Interoperability Framework
Simeon Warner https://orcid.org/0000-0002-7970-7855
(Director of IT for Library Linked Data and Repository
Architecture, Cornell University Library, USA)
National Library of Finland KirjastoverkkopÀivÀt (Library
Network Days), Helsinki, Finland, 2017-10-26, 14:30-16:00
2. Credits â There are no original IIIF slide decks!
â⯠These slides follow most closely the presentation of the IIIF Tutorial at
Open Repositories 2017 (Brisbane, Australia) given in collaboration
with Mike Appleby Jon Stroop, Sheila Rabun & Tom Cramer
â⯠Introduction slides taken from a set last arranged by Tom Cramer
â⯠They also include content from many others including Rob Sanderson,
Tom Crane, ...
3. Agenda
â⯠Introduction to IIIF
â⯠Overview of IIIF APIs
â⯠API Specifications Roadmap
â⯠IIIF Implementations & Demonstrations
â⯠IIIF Community
â⯠Discussion: Do try this at home
23. IIIF Vision
Create a global framework by which image-based resources
(images, books, maps, scrolls, manuscripts, musical scores, etc.)
âŠfrom participating institution can be
delivered in a standard way
âŠvia compatible image server
âŠfor display, manipulation and
annotation in application,
âŠto user on the Web.
24. IIIF Vision, continued
âąâŻ with of image-based
resources
âąâŻ backed by a consor1um of
âąâŻ supported by a rich and growing suite of
âąâŻ incorpora1ng the
, and
31. Community
1. Cambridge, Sept 2011
2. The Hague, April 2012
3. Edinburgh, July 2012
4. Paris, May 2013
5. Copenhagen, February 2014
6. London, October 2014
7. Washington DC, May 2015
8. Ghent, November 2015
9. New York City, May 2016
10. The Hague, October 2016
11. The Vatican, June 2017
12. Toronto, September 2018
âąâŻ A/V Technical SpeciïŹca1on Group
âąâŻ Discovery Technical SpeciïŹca1on Group
âąâŻ Manuscripts Community Group
âąâŻ Museums Community Group
âąâŻ Newspapers Community Group
âąâŻ Sooware Developers Community Group
Working Group
Mee1ngs
since 2011
Community Groups
12 30+
6
par1cipants on open
community calls
every 2 weeks
33. A Community
that develops Shared APIs,
implements them in Software,
and exposes interoperable Content
34. A world of silos & duplication
ââŻEvery site a silo (Ă no interoperability)
ââŻEvery app a one-off (Ă overhead to code and keep)
ââŻEvery user forced to cope (Ă many UIs, little integration)
39. IIIF APIs
Core:
â⯠Image API â access to bits of images and enough technical metadata
to use them
â⯠Presentation API â information about how sets images should be
displayed and related, contains display metadata and may contain links
to semantic metadata
Also:
â⯠Search API â Search within an object
â⯠Authentication API â Tie with authentication system
63. Content
Canvas
Sequence
Manifest
Collec1on
IIIF Presentation API
âThe objective of the IIIF Presentation API is to provide
the information necessary to allow a rich, online viewing
environment for primarily image-based objects to be
presented to a human user [...]. This is the sole
purpose of the API and therefore the descriptive
information is given in a way that is intended for
humans to read, but not semantically available to
machines. [... It] explicitly does not aim to provide
metadata that would drive discovery of the digitized
objects.â
â http://iiif.io/api/presentation/2.1/#objectives-and-scope
71. Other Properties
â⯠Descriptive Properties
(label, metadata, description, thumbnail)
â⯠Rights and Licensing Properties
(attribution, license, logo)
â⯠Technical Properties
(viewing direction, viewing hints, width, height, ...)
â⯠Linking Properties
(related, see also, start canvas, within, ... )
â⯠Paging Properties
(first, last, next, total)
72. Other Types
â⯠Annotation
â⯠Annotation List
â⯠Layer
â⯠Range
Content
Canvas
Sequence
Manifest
Collec1on
Annota1on
Annota1on
List
Layer
Range
74. Coming Soon: IIIF A/V & Presentation 3.0
â⯠British Library âSave our Soundsâ grant from Mellon Foundation
â⯠Add a time dimension to the Canvas model
â⯠Change to W3C Web Annotation Data Model (from Open Annotation)
â⯠Late 2018?
76. IIIF Content Search API
â⯠http://iiif.io/api/search/1.0
â⯠Specification for searching within annotations in a single IIIF resource --
implements ^F like functionality
80. Who is using the Search API?
â⯠The British Library
â⯠University College Dublin
â⯠National Library of Wales
â⯠The Wellcome Trust
â⯠North Carolina State University
â⯠34+ institutions investigating or developing support
81.
82.
83.
84. Live search example
â⯠Wellcome Library
â⯠Origin of Species (1st ed.) -- https://wellcomelibrary.org/item/b1802922x
â⯠Short link https://goo.gl/BVJjs6
â⯠E.g. âfinchesâ or âfitnessâ
Note that the IIIF Search API doesnât specify how the search interface is
presented to the user, it specifies the back-end mechanism by which the client can
query annotation content on any IIIF Search API compatible server.
85. But what about discovery?
â⯠Search API provides only search over annotations within IIIF resources
â⯠Discovery TSG working on ways to support discovery of IIIF resources
â⯠http://iiif.io/community/groups/discovery/charter/
â⯠4 areas of work
â⯠1. Crawling and Harvesting (recently agreed split into 2 subsections)
â⯠2. Content Indexing
â⯠3. Change Notification
â⯠4. Import to Viewers
87. IIIF Authentication API
â⯠http://iiif.io/api/auth/1.0/
ââŻv1.0 released January 19, 2017
ââŻ(18 months from first public draft)
Doesnât do authentication per se but provides an interaction
pattern allowing existing authentication infrastructure (CAS,
OAuth, etc.) to be used to control access to IIIF resources
88. IIIF Authentication API
Specification describes how to
ââŻFrom within a viewer, initiate an interaction with an access
control system so that a user can acquire the credentials
they need to view restricted content
ââŻGive the client just enough knowledge of the userâs state
with respect to the content provider to ensure a good user
experience (including providing alternate images)
89. Authentication patterns
Login
â⯠The user will be required to log in using a separate window with a UI
provided by an external authentication system.
Click through
â⯠The user will be required to click a button within the client using
content provided in the service description.
Kiosk
â⯠The user will not be required to interact with an authentication system,
the client is expected to use the access cookie service automatically.
External
â⯠The user is expected to have already acquired the appropriate cookie,
and the access cookie service will not be used at all.
93. IIIF Authentication API implementations
â⯠British Library
â⯠In copyright material
â⯠Staff access
â⯠Single user access within the building
â⯠The Wellcome Library
â⯠Getty
â⯠Staff access off site to private material
â⯠On site for copyright
â⯠Auth Playground:
ââŻhttps://iiifauth.digtest.co.uk/
ââŻpaste manifests into e.g.
http://universalviewer.io/examples/
94. HTTPS and mixed-content
All of the IIIF specs work over either HTTP or HTTPS (though you shouldnât ever
use authentication with HTTP)
BUT, plain HTTP and HTTPS do not play well together. Browsers block mixed-
content, see e.g.
â⯠https://developer.mozilla.org/en-US/docs/Web/Security/Mixed_content and
â⯠https://www.jack-reed.com/2017/05/23/the-case-for-serving-your-iiif-content-over-https.html
HTTPS â Just do it! Everyone should.
96. API Specifications Roadmap
â⯠Image and Presentation APIs 2.1.1 â 2016-05-12
â⯠Authentication API 1.0 â 2017-01-19
â⯠Image and Presentation APIs 3.0 (Open Annotation to Web Annotation,
support for A/V) â feature freeze 2017-12, beta draft 2018-05, publish fall
2018 if there are sufficient implementations
Later:
â⯠Search API 2.0 â will need updates from Open Annotation to Web Annotation to
match Presentation 3.0
â⯠Auth API 1.1 â with a view to controlling modifying events as well as read
â⯠REST & A/V bitstream APIs â deferred for the time being
104. Endangered Archives Programme
Hosted by the British Library, example Armenian text ŐŐœŐŻŐ„ŐĄŐ” ÔŽŐžÖŐŒŐ¶ ÔŽŐșÖŐĄŐżŐĄŐ¶
[Voskeay durn dpratan], 1699
â⯠http://eap.bl.uk/archive-file/EAP180-1-1-30
â⯠in UV:
http://eap.bl.uk/archive-file/EAP180-1-1-30#?
c=0&m=0&s=0&cv=13&xywh=-102%2C112%2C2337%2C2266
â⯠can also drag-and-drop into Mirador: http://projectmirador.org/demo/
109. Technical SpeciïŹcation Groups
As needs arise within the community, new
technical speciïŹcation groups are formed,
currently:
âąâŻIIIF A/V
âąâŻIIIF Discovery
âąâŻIIIF Text Granularity
New use cases considered as IIIF evolves:
âąâŻhttps://github.com/IIIF/iiif-stories
110. IIIF Consortium (IIIF-C)
http://iiif.io/community/consortium
âąâŻ47 institutional members
âąâŻSustainability and steering for IIIF
âąâŻOrganizational structure:
âąâŻ Executive Committee â core founding members, high level direction
âąâŻ Coordinating Committee â active leaders for week to week activities
âąâŻ Editorial Group â writes API speciïŹcations
âąâŻ Funds two staff positions:
âąâŻ Community Coordinator (Sheila Rabun)
âąâŻ Technical Coordinator (Glen Robson)
âąâŻAdditional Founding Members â through 2017
111. Consortial Business
â⯠Hiring a technical coordinator
â⯠Opening up new tiers of membership in 2018
â⯠Seeking partners
â⯠Software ïŹrms
â⯠Contractors & consultants
â⯠Training
â⯠Complementary projects & associations
â⯠Please join the IIIF Consortium
112. Partnerships and Projects
âąâŻOpenJPEG improvement project
âąâŻGrant-funded projects:
âąâŻNewspapers in Hydra (IMLS)
âąâŻAvalon Media System (IMLS)
âąâŻSave our Sounds (Mellon)
âąâŻDHSI Summer Institute 2018
âąâŻAmerican Art Collaborative consulting pilot
113. Emerging Trends
âąâŻIncreasing adoption & experimentation
âąâŻSTEM imaging, publishing, DH
âąâŻImproving documentation for implementers and
end users
âąâŻLowering the barriers to adoption
116. Europeana IIIF Task Force
Timeframe: February to June 2017
Led by: Austrian National Library
Purpose: Identify current trends and tendencies towards IIIF
by the Europeana content providers. Europeana has
adopted IIIF but a large portion of the Europeana Network
is unaware and unsure of IIIF.
Output: Recommendations Report