IIIF

概要 IIIFマニフェストの生成を行うOmeka Sのモジュール「IIIF Server」において、Image APIを使用しない設定を行うことができます。これにより、レンタルサーバなどのリソースが限られた環境において、IIIFマニフェストの配信などが容易となります。 以前、以下の記事を執筆しました。 https://nakamura196.hatenablog.com/entry/2021/07/22/171657 2022年5月時点において、モジュールのアップデートにより、設定の方法が変わりましたので、設定方法をあらためて記事にします。なお、Image APIを使用しないメリットやデメリットについては、上記の記事をご参照ください。 設定方法 確認した環境は以下です。 Omeka S version 3.2.0 IIIF Server version 3.6.6.6 モジュールの一覧画面から「IIIF Server」をみつけ、「設定」ボタンをクリックします。 遷移先のページで最下部に移動すると、「External image server」 > 「Default IIIF image api version」という設定項目があります。ここで以下に示すように、「No image server」のオプションを選択することにより、Image APIを使用しないマニフェストファイルの生成が可能になります。 まとめ レンタルサーバなどのリソースが限られた環境でOmekaを運用しており、タイル画像の生成に時間がかかってしまう場合などに、本記事が参考になりましたら幸いです。

概要 Omeka SにIIIF マニフェスト URI のアイコンとビューアを表示するためのモジュール「IIIF Viewers」を開発・公開しています。本モジュールの開発にあたっては、国文学研究資料館にご協力いただきました。 https://github.com/omeka-j/Omeka-S-module-IiifViewers 以下、本モジュールの使い方について説明します。 インストール Omeka Sにおける標準的な方法でインストール可能です。 具体的には、まず以下の「Releases」欄のリンクをクリックします。 次に、以下のリンクをクリックすることで、zipファイルをダウンロードできます。ダウンロードしたファイルを展開して、インストール済みのOmeka Sの「modules」フォルダに展開したフォルダ「IiifViewers」を配置してください。 本記事執筆時点では、以下のURLで最新版をダウンロードすることができます。 https://github.com/omeka-j/Omeka-S-module-IiifViewers/releases/download/0.0.5/IiifViewers.zip 使い方 インストール後、以下の設定画面に遷移します。本モジュールで使用する各種IIIF対応ビューアへのリンクを指定することができます。（デフォルト設定のままでも問題ありません。） また、画面左部の「モジュール > IIIF Viewers」のリンクをクリックすることで、各ビューアのアイコンを指定することができます。 カスタマイズ例 たとえば、「TIFY」を設定している箇所について、神崎正英氏が開発されている「Image Annotator」に変更してみます。 https://www.kanzaki.com/works/2016/pub/image-annotator まず以下の画面から、ロゴを変更します。 次に、モジュールの一覧画面から、以下の「設定」ボタンを選択します。 そして、「TIFY」のURLの値を以下に変更します。 http://www.kanzaki.com/works/2016/pub/image-annotator?u= 結果、以下のように追加したアイコンが表示され、アイコンをクリックすると、Image Annotatorで画像を閲覧することができます。 まとめ 今後、任意の数のIIIF対応ビューアを設定できるように修正したいと思います。 新機能やバグ修正のご要望などございましたらお知らせください。またプルリクエストも歓迎いたします。 ご活用いただけますと幸いです。

Nuxt 2を用いたMirador 3の使用例を以下のGitHubリポジトリで紹介しています。 https://github.com/nakamura196/nuxt-mirador ただ上記のリポジトリにおいて、production環境において不具合が生じることがわかりました。具体的には、ページ遷移後にMiradorの表示が崩れてしまう不具合です。 送っていただいたissue https://github.com/nakamura196/nuxt-mirador/issues/1 このissueについて、さらに不具合を修正したPull requestも送っていただきました。 https://github.com/nakamura196/nuxt-mirador/pull/2 具体的には、以下に示すように、beforeDestroyでunmountする必要がありました。 https://github.com/nakamura196/nuxt-mirador/pull/2/files 自分では不具合の解消方法が分かりかねたので、大変助かりました。 Nuxt（Vue）におけるMirador 3の使用において、参考になりましたら幸いです。

国立国会図書館「次世代デジタルライブラリー」で公開されているOCR結果をIIIFビューアで閲覧するアプリについて、OCR結果をTEI/XML形式でダウンロードする機能を追加しました。 https://static.ldas.jp/ndl-ocr-iiif/ 本アプリについては、以下の記事も参考にしてください。 本機能の追加にあたり、UIを更新しました。結果を「ビューア」と「データ」に分けています。 「ビューア」については、従来から提供していた「Mirador」と「Curation Viewer」に加えて、「Universal Viewer」、「Image Annotator」を追加しました。また、「次世代デジタルライブラリー」へのリンクと、TEI/XMLファイルの簡易ビューアとして「TEI Viewer」というページを実装して追加しています。 「データ」については、「マニフェストファイル」「キュレーションリスト」「TEI/XML」の3種類を提供します。 用途に応じてご活用いただけますと幸いです。

概要 以下の記事で、AWSサーバーレスアプリケーションによるIIIF Image Serverの構築方法について説明しました。 今回は、サイズが比較的大きい画像を登録し、タイル画像の配信が可能かを確認します。 対象 今回は、『鉱山借区図』（東京大学駒場図書館所蔵）を対象とします。 https://iiif.dl.itc.u-tokyo.ac.jp/repo/s/ichiko/document/4120a330-2f1c-4e2c-5d48-21aed4d42704 元画像は 300 MB弱のtif画像です。 pyramidal tiled tiffの作成 以下のサイトを参考に、VIPSとImageMagickの両方を試してみました。 https://github.com/samvera-labs/serverless-iiif#creating-tiled-tiffs Using VIPS v i p s t i f f s a v e s o u r c e _ i m a g e . t i f o u t p u t _ i m a g e . t i f - t i l e - p y r a m i d - c o m p r e s s i o n j p e g - t i l e - w i d t h 2 5 6 - t i l e - h e i g h t 2 5 6 Using ImageMagick c o n v e r t s o u r c e _ i m a g e . t i f - d e f i n e t i f f : t i l e - g e o m e t r y = 2 5 6 x 2 5 6 - c o m p r e s s j p e g ' p t i f : o u t p u t _ i m a g e . t i f ' 結果、VIPSの場合は 35.6 MB、ImageMagickの場合は 107.4 MB になりました。 ...

Vue3でOpenSeadragonを使用するサンプルリポジトリを作成しました。 以下が動作例です。 https://static.ldas.jp/vue3-osd/ ソースコードは以下です。 https://github.com/ldasjp8/vue3-osd Vue3初学者のため、誤りなどがあるかもしれませんが、参考になりましたら幸いです。

Omeka SのIIIF Serverモジュールについて、デフォルト設定では、以下のようなURLでIIIFマニフェストファイルにアクセスすることができます。 <インストールしたパス>/iiif/<presentation apiのバージョン>/<omekaの内部ID>/manifest 例（version 2の場合）： https://shared.ldas.jp/omeka-s/iiif/2/1267/manifest 例（version 3）： https://shared.ldas.jp/omeka-s/iiif/3/1267/manifest ただ、このままではOmekaの内部IDが使用されてしまうため、独自の識別子の利用を推奨します。 対応方法としては、Clean Urlモジュールを追加でインストールし、以下に示すIIIF Serverモジュールの設定画面において、Use the identifiers from Clean Urlを有効にします。 これにより、例えば、先のサイテムに99999という識別子を与えた場合、以下のURLでも同じマニフェストファイルにアクセスすることができます。 https://shared.ldas.jp/omeka-s/iiif/2/99999/manifest 今回は数字の識別子を与えましたが、abcやabc1234など、英数字などでも問題ありません。 IIIF Serverモジュールを利用される際の参考になりましたら幸いです。

Omeka SのIIIF Serverモジュールでは、様々な設定を行うことができます。その一つとして、attributionの設定があります。 以下に示すように、Default attributionに入力した値が、IIIFマニフェストファイルなどのattribution項目に表示されます。組織名など、適切な値に変更することをお勧めします。 または、上記で示した項目の一つ上にあるように、attributionの値を入力するプロパティを指定することで、アイテム毎にattributionの値を変更することもできます。 IIIF Serverモジュールを利用される際の参考になりましたら幸いです。

概要 先日、以下の記事に書いた通り、IIIFのマニフェストファイルの配信と、IIIF Content Search APIを提供するアプリを開発しました。 ただそれぞれ、APIに準拠しない記述をしていた部分がありました。 本記事では、その修正内容を共有するとともに、バリデーションを行うPresentation API Validatorの使用方法について、実例とともに紹介します。 https://presentation-validator.iiif.io/ マニフェストファイルの修正 上記のPresentation API Validatorのサイトにアクセスし、URL of Manifest to ValidateにマニフェストファイルのURLを入力し、対応したAPIのバージョン（今回は3.0）を選択します。 その結果、以下のように、エラーがある場合には、その内容が表示されます。 冒頭で紹介した私が開発したアプリが配信するマニフェストファイルは、そのサイズが大きいため、そのまま本バリデータにURLを入力すると、検証結果が表示されるまで時間がかかります。 そのため、マニフェストファイルの1canvas目のデータのみを残したマニフェストファイルを別途作成しました。それをバリデータにかけた結果、59件のエラーメッセージが表示されました。 以下、それぞれのエラー内容への対応方法を記述します。 Error 1 of 59. Message: ['https://ocr.aws.ldas.jp/v1/manifest/3437686.json'] is not of type 'string' before { } " ] i " d h " t : t p [ s : / / o c r . a w s . l d a s . j p / v 1 / m a n i f e s t / 3 4 3 7 6 8 6 . j s o n " 誤って、マニフェストファイルのidを配列の形で与えていました。以下のように修正しました。 ...

Omeka SのImage Serverモジュールでは、アップロードされた画像に対して、動的にタイル画像を生成する機能があります。本機能を用いることにより、ユーザはJPG画像やPNG画像をアップロードするだけで、Omeka側でリクエストに応じたタイル画像の動的生成を行い、IIIF Image APIに準拠した画像配信を行うことができます。 ※ 一方、サーバのスペックが限られている場合などは、この動的なタイル画像生成の処理に時間がかかる場合があります。この場合には、事前にタイル画像を生成しておく、といったオプションも選択可能です。こちらについては、後述します。 この動的なタイル画像の生成機能を用いる際、Image Serverモジュールの設定画面において、画像サイズの上限が指定されています。以下の例では、20MB以下の画像に対して動的なタイル画像生成を行い、それより大きな画像に対しては行わない、という設定になります。 デフォルト値では10MBになっており、10MBより大きい画像をアップロードした場合には、この上限設定により、タイル画像の動的な生成が行われず、解像度の低い画像しか配信されません。この問題にあたったケースがありました。同様のことでお困りの方がいらっしゃれば、今回のようなケースに該当しないか、ご確認いただくことをお勧めします。 なお、本モジュールのリポジトリでは、以下のような説明がなされています。サーバのスペックが高い場合には、10MB以上の画像に対してもタイル画像の動的な生成は可能であるが、そうでない場合は、事前にタイル画像を生成しておくことが推奨されています。 In case of big files, it is recommended to use vips or the command line version of ImageMagick, that is not limited by the php memory. Furthermore, the limit of the size (10000000 bytes by default) can be increased if you have enough memory, so images won’t appear blurry even if they are not tiled. Vips bypasses this limitation. ...

概要 国立国会図書館「次世代デジタルライブラリー」で公開されているOCR結果をIIIFビューアで閲覧するアプリを作成しました。使用方法を以下の記事にまとめています。 今回は、上記アプリの構築方法について説明します。 構築方法 バックエンド AWSを利用しました。また、主にSAM（Serverless Application Model)を用いて構築しています。 IIIFマニフェスト&キュレーションリストの作成 次世代デジタルライブラリーで公開されているOCR結果を反映したIIIFマニフェストおよびキュレーションリストを生成する流れは以下です。 ポイントとして、AWS Lambdaが担う処理に時間がかかっため、AWS Step Functionsを導入しています。 具体的には、AWS Lambdaは、OCR結果をIIIFマニフェストおよびキュレーションリストに変換する処理、およびその変換結果をS3にアップロードする処理を行いますが、これがAPI Gatewayのタイムアウト（29秒）に引っかかってしまいました。そのため、以下の記事を参考に、Step Functionsを組み合わせた非同期処理を採用しています。 https://dev.classmethod.jp/articles/apigateway-stepfunctions-asynchronous/ IIIF Content Search APIの構築 本アプリのもう一つの工夫点として、IIIF Content Search APIを構築しています。 https://iiif.io/api/search/1.0/ こちらについては、以下に示すシンプルな構成をとっています。S3から取得したIIIFマニフェストに対して、検索語に対応したデータ（文字列および座標情報）を返却するAWS Lambda関数を作成しました。 フロントエンド フロントエンドはNuxt.jsを用いて開発しています。ソースコードは以下です。GitHub Pagesを用いて公開しています。 https://github.com/ldasjp8/ndl-ocr-iiif Step Functionsを実行後、定期的（3秒ごと）にステータスを取得し、SUCCEEDEDとなれば、MiradorとCuration Viewer（CODH提供）へのリンクを表示します。 Miradorについては、以下に示すように、デフォルトですべてのアノテーションを表示するhighlightAllAnnotations: true、かつ、サイドパネルでアノテーションを表示するdefaultSideBarPanel: 'annotations'ようにしています。 https://github.com/ldasjp8/ndl-ocr-iiif/blob/3b474ea1cb960a4d2e322ba04e131c11ed70529b/pages/_id/mirador/index.vue#L34-L40 まとめ AWS勉強中の身ですが、他の方の参考になる部分がありましたら幸いです。

概要 国立国会図書館「次世代デジタルライブラリー」で公開されているOCR結果をIIIFビューアで閲覧するアプリを作成しました。 以下のURLからお試しいただけます。 https://static.ldas.jp/ndl-ocr-iiif/ 使い方 入力フォームに、「次世代デジタルライブラリー」で公開されている資料のIDを入力します。 しばらくすると、「Mirador」とCODHが公開する「Curation Viewer」のボタンが表示されます。それぞれのビューアで、OCR結果をご確認いただけます。 Miradorでの表示例 特に、「Mirador」については、「IIIF Content Search API」にも対応し、資料内検索が可能です。 https://iiif.io/api/search/1.0/ Curation Viewerでの表示例 まとめ 本記事では本アプリの使い方について説明しました。別の記事では、本アプリの構築方法について説明したいと思います。

概要 AWS LambdaとDockerとpyvipsを用いて、S3に格納された画像から、Pyramid Tiled Tiffファイルを作成するイメージを作成しました。 Amazon ECR Public Galleryは以下です。 https://gallery.ecr.aws/nakamura196/lambda-docker-vips-python ソースコードは以下です。 https://github.com/ldasjp8/lambda-docker-vips-python 以下、使用方法について説明します。 Amazon ECRリポジトリの作成 まず、ECRリポジトリを作成します。 次に、「プッシュコマンドの表示」から、コマンドを確認して、イメージをpushします。 以下、コマンドの例です。 g c a d d d i d w o o o t s c c c l k k k c a e e e e l m c r r r o b r n d b t p e a g u a u - e i g s h d t l h t o - d l t c l a X p k o - m X s e g t b X : r i d X / - n l a . / v - a - d g i p m d k i p a b o r t s s d c . h - s a k e u p w - e c b y o d r r . t r o - . c h d c v u o o k i s m n e p - / - r s e l r - - a d e v p s a g i y t s i p t - j o s h 1 p n - o . 8 p n a / u y : m l s t l a a - h a z m e o t o b a n e n d s s a a t . t w - - s d 1 X . o X c c | X o k X m e d . / r o d l - c k a v k r m i e . b p r e d s c a - l r - p o . d y g u o t i s c h n - k o e e n a r . - s - g u t v i s - i t e 1 p r . s n a - a m p m a y e z t o h A n o W a n S w : s l . a - c t p o e a m s s / t s l w a o m r b d d - a s - t d d o i c n k e X r X - X v X i . p d s k - r p . y e t c h r o . n u : s l - a e t a e s s t t - 1 . a m a z o n a w s . c o m 結果、以下のようにイメージがECRリポジトリに表示されます。 ...

概要 pyvipsを用いてPyramid Tiled Tiffファイルを作成するプログラムを作成しました。以下のGoogle Colabでお試しいただけます。 https://colab.research.google.com/drive/1VO1PgKgS3H21zXpg4g2inN-mtIrON5TQ?usp=sharing IIIFを用いた画像配信において、Pyramid Tiled Tiffファイルを作成する場面がありますが、PythonおよびVipsを用いた画像変換を行う際の参考になりましたら幸いです。 なお、パラメータ等は以下を参考にしています。 https://github.com/samvera-labs/serverless-iiif#using-vips また、変換したPyramid Tiled Tiffファイルを配信する方法の一例 として、以下の記事も参考になりましたら幸いです。 ポイント vipsのインストール pyvipsを使用するのは、vipsを事前にインストールしておく必要があります。以下が参考になります。 https://www.libvips.org/install.html pyvipsを用いたPyramid Tiled Tiffファイルの作成 以下のように使用します。 i i i m n n p s s o . r = t t c p t t t i i o y i i p f l m r l l p y f e p a e e y v s = r m _ _ v i a T e i w h i p v r s d i e p s e u s = d i s . ( e i T t g I < , o r h h m 出 n u = t a 力 = e 2 = g 画 ' , 5 2 e 像 j 6 5 . フ p , 6 n ァ e ) e イ g w ル ' _ の , f パ r ス o > m , _ f i l e ( < 入 力 画 像 フ ァ イ ル の パ ス > ) 上記は、以下と同じ結果が得られる（はず）です。 ...

Omeka ClassicとIIIF Toolkitプラグインを用いたIIIF画像へのアノテーション付与環境を構築します。Omeka Classicの基本的なインストールと合わせて説明します。 はてなブログのまとめ記事と、Zennの本の2種類を作成しました。 Zenn https://zenn.dev/nakamura196/books/2a0aa162dcd0eb はてなブログ https://nakamura196.hatenablog.com/entry/2022/03/22/234917 Omeka.net（Classic）の使い方の参考になりましたら幸いです。

概要 Omeka SのIIIF Serverモジュールは、IIIFマニフェストファイルの自動生成に加えて、IIIFコレクション（IIIFマニフェストを一つにまとめたもの）を自動生成することもできます。 https://omeka.org/s/modules/IiifServer/ 本記事では、このIIIFコレクション機能の使い方について説明します。 データ（アイテムセット）の準備 Omeka Sでは「アイテムセット」という、複数のアイテムをまとめて管理するための単位があります。例えば今回の例では、以下のように、「tei」「iiif」「oss」の三つのアイテムセットを作成します。 今回登録した、OmekaのIDとタイトルの関係は下の表の通りです。 Omeka ID タイトル 1266 tei 1265 iiif 1264 oss そして、それぞれのアイテムセットに、複数のアイテムを関連づけます。例えば、アイテムセット「oss」には、23のアイテムを関連づけます。 関連づけの方法としては、以下のように、個々のアイテムの編集ページでアイテムセットを与えるか、 以下のように、アイテムの一覧画面から複数のアイテムを選択して、画面上部の一括処理のフォームから、複数のアイテムのアイテムセットを変更することができます。 単一コレクション（アイテムセット） 上記の結果、例えば、アイテムセット「oss」に関連づけられたアイテムのIIIFマニフェスト群から構成されるIIIFコレクションは、以下のURLから取得できます。 https://shared.ldas.jp/omeka-s/iiif/2/collection/1264 IIIF Presentation API v3でのIIIFコレクションは、以下からアクセスできます。（2を3に変更します。） https://shared.ldas.jp/omeka-s/iiif/3/collection/1264 神崎正英氏が作成されているImage Annotatorで表示した例が以下です。 https://www.kanzaki.com/works/2016/pub/image-annotator?u=https://shared.ldas.jp/omeka-s/iiif/2/collection/1264 また、Mirador 3で表示した例が以下です。 http://www.kanzaki.com/ext/viewer/mirador3?manifest=https://shared.ldas.jp/omeka-s/iiif/2/collection/1264 さらに、Cultural Japanプロジェクトで作成している「Self Museum」で表示した例が以下です。 https://self-museum.cultural.jp/?collection=https://shared.ldas.jp/omeka-s/iiif/2/collection/1264&build=1 複数コレクション（アイテムセット） 以下のようなURLを与えることで、複数のIIIFコレクション（アイテムセット）から構成されるIIIFコレクションを作成することができます。 https://example.org/iiif/set/:id,:id,:id,:id 例えば、以下のURLです。 https://shared.ldas.jp/omeka-s/iiif/set/1264,1265,1266 まとめ 本記事で紹介したように、Omeka SのIIIF Server モジュールを使うことにより、IIIFマニフェストファイルの生成に加えて、Omeka Sのアイテムセットに基づくIIIFコレクションの自動生成、かつ、IIIF Presentation APIのv2とv3に対応することができます。 IIIFコレクションを自動生成することにより、Self Museumなど、IIIFコレクションに対応した他のアプリケーションに読み込ませることができる点も有益かと思います。 Omeka Sを用いたIIIFデータの活用において、本記事がお役に立てば幸いです。

お知らせ 以下に、2024年時点の使用方法を記載しました。参考にしてください。 概要 本記事では、Awesome IIIFで紹介されている、AWSサーバーレスアプリケーションによるIIIF Image Serverの構築方法を紹介します。 https://github.com/samvera-labs/serverless-iiif なお、本記事の手続きにより、AWSのサービス利用料金が発生しますので、試される場合にはご注意ください。 想定読者 上記リポジトリでは、以下のように紹介されています。 AWSの基本的な知識があること。 コンソールやコマンドラインからリソースを作成する権限を持つAmazon Web Servicesアカウントを持つこと。 IIIF で提供するソース画像を格納する Amazon S3 バケットを持つこと。 準備 S3のバケット準備 IIIF で提供するソース画像を格納する Amazon S3 バケットを作成します。今回は、「serverless-iiif-s3-dd」というバケットを作成し、その中に「ezu」というディレクトリを作成しました。 tiled TIFFファイルの作成 今回は、国立国会図書館で公開されている以下の国絵図をサンプルデータとして用いました。 https://dl.ndl.go.jp/info:ndljp/pid/1286201 JPG画像をダウンロードし、以下の変換コマンドを参考に、tiled TIFFファイルを作成します。 Using VIPS vips tiffsave source_image.tif output_image.tif –tile –pyramid –compression jpeg –tile-width 256 –tile-height 256 Using ImageMagick convert source_image.tif -define tiff:tile-geometry=256x256 -compress jpeg ‘ptif:output_image.tif’ S3へのtiled TIFFファイルのアップロード 変換して得られたファイルを以下のようにアップロードします。 Image Serverの構築 セットアップ まず、冒頭で紹介した、以下のリポジトリページにアクセスし、Quick Startにある「Deploy the Serverless Application」のリンクをクリックします。 https://github.com/samvera-labs/serverless-iiif ...

IIIFマニフェストファイルからの画像一括ダウンロードプログラムを作成しました。 以下のGoogle Colabからご利用いただけます。 https://colab.research.google.com/drive/1XL6cnY6fdtYTB5EdNA_B_EfqKHXZMDQJ?usp=sharing なお、提供機関に配慮してご利用ください。また、IIIFマニフェストの利用条件を確認の上、ご利用ください。

概要 Omeka SにMiradorビューアを追加するモジュールについて紹介します。 GitHubリポジトリは以下です。 github.com Mirador2と3の両方が利用可能です。また、各種プラグインを設定画面から追加することができます。この記事では、画像の回転や左右反転を可能にする「Imgae tools」プラグインを追加する方法を紹介します。 本モジュールを利用するには、Omeka SにIIIFサーバ機能を持たせるか、外部のマニフェストファイルを参照する必要があります。前者の導入方法については、別の記事で紹介予定です。 インストール 特に注意点はありません。 使用方法 モジュールのインストール後、以下に示す各サイトの設定画面において、Miradorの設定を行うことができます。 特に、「Mirador plugins for v3」において、プラグインの追加を行うことができます。画像の回転やフリップなどを可能にする「Image tools」プラグイン等を導入可能です。 導入後、以下のように当該プラグインが表示されます。 Omeka SでMirador 3を使用する際の参考になれば幸いです。

IIIFマニフェストファイルからTEIのfacsimile要素を作成するプログラムを作成しました。以下のGoogle Colaboratoryでお試しいただけます。 colab.research.google.com IIIFとTEIの連携を検討されている方の参考になりましたら幸いです。