Guide for Internet Archive IIIF endpoint

[sammeltassen]

For the documentation, would it be possible to specify which upload formats would work best with the current Cantaloupe integration? And to provide some best practices for pre-processing images?

For example, I presume that an image which is already compressed to jp2 before upload might significantly speed up the IIIF integration, compared to the original tif.

Related question: in the presentation it was mentioned that the current workflow uses IA's download link. How does it determine which file format to use, if multiple originals are available? Does it, for example, prefer jp2 over tif?

[glenrobson]

We agree this would be good to include in the documentation. Glen believes it does prioritise jp2s over tiffs but will have to check.

We can borrow some instructions from:

https://blog.archive.org/2012/05/24/uploading-images-for-text-items/

and

https://help.archive.org/help/how-to-upload-scanned-images-to-make-a-book/

[glenrobson]

Note we found in the htj2k testing that ptiff was the fastest format so it would be interesting to see if this works with the IA setup:

https://journal.code4lib.org/articles/17596

[benwbrum]

https://docs.google.com/presentation/d/1EnW99P6J8yiDyA6uDmXSBrOk_MtDFzd9MUS8hfso-cA/edit#slide=id.g2a0d03839fe_0_156 mentions the format needed for "book" style items in IA.

[glenrobson]

Glen to provide Sara with some pTiffs to test with.

[glenrobson]

Note there is also a request on twitter: https://x.com/Mehrandhn/status/1764412753383456972?s=20

[saracarl]

Based on this:

the *_images.zip will be scanned for files it contains, at any directory level, whose names end with .jp2, .jpg, .jpeg, .tif, .tiff, .bmp or .png, matched case-insensitively; any other files (.xml, .txt, etc.) will be ignored.

and this:

1. Use only jpg, jpeg, jp2, tif, tiff, png, gif or bmp files. Any combination of them is acceptable.

ptiffs aren't an option for upload.

[saracarl]

Whether to upload TIFFs or JP2s is dependent. Here's a ChatGPT generated summary of the trade-offs:

Performance Considerations:

Network Bandwidth vs. Server Processing: If network bandwidth is limited, JPEG 2000 may be preferable due to its smaller file sizes. However, if server processing power is limited, TIFF may be more efficient due to simpler decompression requirements.
Server Hardware: Some servers might have specific optimizations or hardware accelerators for JPEG 2000, which can greatly enhance its performance.
Client Requirements: If clients frequently request high-resolution partial images, the region decoding efficiency of JPEG 2000 might offer better performance.

[glenrobson]

Would be great to put this information in this file:

https://github.com/IIIF/guides/blob/main/guides/archive.org/index.md

Note discussion on slack also:

https://iiif.slack.com/archives/C06HUFT147P/p1714053128531299

[glenrobson]

Can you upload a ptiff with a tiff extension.

• Will it show in the archive.org/details
• Will it work in Cantaloupe?