Comment exploiter les données de Numerabilis
Données ouvertes
Êtes-vous un chercheur qui souhaite utiliser des documents numérisés dans le cadre de vos recherches ? Êtes-vous un data scientist qui étudie l'architecture des données des bibliothèques ? Êtes-vous intéressé par l'exploration textuelle de la bibliothèque numérique Numerabilis afin de rechercher des tendances et des idées liées à votre domaine d'étude ?
Nous offrons un accès libre à nos métadonnées et à nos images par l'intermédiaire de nos interfaces et outils.
Comment mentionner la provenance ?
Les documents que nous diffusons sont pour la plupart des documents scientifiques mis en ligne pour favoriser la recherche et l’exploitation savante. D'où l'importance pour la DGDBM de réclamer la mention de la provenance du document (c’est ainsi que nous interprétons la notion de « paternité » obligatoire incluse dans le texte de la Licence ouverte).
L’appartenance à une collection fait partie de la valeur d’un document. Nous souhaitons que cette valeur soit préservée autant que possible lors de la diffusion de ses reproductions.
Selon l’usage que vous ferez des documents, vous pouvez être plus ou moins complet dans la mention de la provenance.
Au minimum :
- Mentionner l’institution qui a fourni le document : « Université Paris Cité », « Ecole nationale vétérinaire de Maisons Alfort », « Musée de l’AP-HP »... Vous trouverez cette information dans la notice du document.
- ET/OU établir un lien hypertexte : le mieux dans ce cas est de faire un lien vers la notice du document en utilisant l’adresse permanente qui y figure (https://numerabilis.u-pariscite.fr/s/numerabilis/ark:xxxxxx).
Bonnes pratiques recommandées :
- Aller plus loin dans les références qui accompagnent votre réutilisation des documents. Il est souhaitable que les documents soient accompagnés de leurs métadonnées (auteur, titre, éditeur, date) et si possible de leur cote. Vous trouverez ces informations dans les notices des documents.
- Maintenir la Licence ouverte pour que d'éventuels réutilisateurs sachent dans quelles conditions le document peut être réutilisé.
- Afficher un lien hypertexte : en le faisant, vous encouragez d’autres utilisateurs à visiter nos ressources, vous stimulez leur réutilisation, vous valorisez notre offre et vous nous aidez à trouver des moyens pour rendre un meilleur service.
- Aider la bibliothèque à conserver, à numériser et à rendre disponibles les collections. Les dons en argent bénéficient de réductions fiscales : pensez-y, notamment si vous utilisez des ressources mises à votre disposition gratuitement dans un but commercial.
Attention !
Certains documents reproduits dans Numerabilis n’appartiennent pas au domaine public.
Certains propriétaires de documents qui n’appartiennent pas au domaine public ont autorisé leur reproduction dans Numerabilis. Ils ont souhaité que ces documents soient gratuitement consultables pour un usage strictement personnel.
Cependant leurs documents n’appartiennent pas pour autant au domaine public. Ils ne peuvent donc en aucun cas être réutilisés sans l’accord explicite de leurs ayants droit.
Certains documents diffusés dans Numerabilis et de portraits ne sont pas sous Licence ouverte.
Une partie des documents présents dans Numerabilis sont fournis par des partenaires de la BIU Santé qui n’ont pas souhaité les placer sous Licence ouverte.
Dans tous les cas où la Licence ouverte n’est pas explicitement mentionnée, la réutilisation est donc soumise à l’autorisation des personnes ou des institutions qui ont fourni les documents : voyez dans le tableau en bas de cette page à quelle adresse les contacter.
Images en haute définition
Si vous désirez obtenir des images en haute définition adaptées à l’édition, à l’usage audiovisuel, etc., contactez l’institution à laquelle appartiennent les documents.
Pour toute demande concernant les fonds de la DGDBM :
- Dans la Banque d'images, les images sous Licence ouverte peuvent être téléchargées via un lien situé en bas de la notice descriptive.
- Pour les portraits et les vues d'établissements hospitaliers, les images peuvent également être récupérées en haute définition sur Wikimedia Commons (pour toutes les images dont l’identifiant commence par « CIP » ou « CIS »).
- Contactez-nous ici. La fourniture des images en haute définition peut être soumise à un tarif qui contribue au fonctionnement de la bibliothèque.
Si les images diffusées sont placées sous Licence ouverte, alors leur version haute définition sont également sous Licence ouverte.
Pourquoi y a-t-il un © sur les images du document sous Licence libre qui m’intéresse ?
Nous avons pris la décision de placer la majorité des documents numérisés sous Licence libre alors que plus de 3,2 millions de pages étaient déjà en ligne. Avant ce passage à la Licence libre, toutes les images dans Medica étaient marquées, le plus souvent avec la mention « © BIU Santé ». De même, la version PDF des documents de Medica portait une mention de propriété.
La modification de toutes ces images sera longue et coûteuse. Nous comptons sur votre compréhension.
Dans les cas où la Licence ouverte s’applique à un document marqué, c'est bien la Licence ouverte qui prime.
Entrepôt OAI-PMH
Les données de Numerabilis sont moissonnables via le protocole OAI-PMH.
L'URL de l'entrepôt OAI-PMH est de la forme https://numerabilis.u-pariscite.fr/oai/. Il faudra donc utiliser https://numerabilis.u-pariscite.fr/oai/ comme URL de base (baseURL) et https://numerabilis.u-pariscite.fr/oai?verb=Identify pour le verbe Identify par exemple.
Liste des Collections (Sets) : https://numerabilis.u-pariscite.fr/oai?verb=ListSets
Serveur IIIF
International Image Interoperability Framework, (à prononcer « triple-I-F») est un ensemble de spécifications visant à définir un cadre international d’interopérabilité des images diffusées sur le Web par des bibliothèques numériques ou d’autres projets de valorisation de documents patrimoniaux. Il s’agit d’un protocole d’échange ayant pour objectif la manipulation homogène d’images via des URL sans tenir compte de l’établissement qui les héberge.
Les manifestes IIIF sont accessibles via le serveur Cantaloupe de Numerabilis.
Exemple : https://numerabilis.u-pariscite.fr/iiif-presentation/3/item/219172/manifest
Visionneuse Mirador
Mirador est un visualiseur d’images interopérable et compatible avec les protocoles IIIF.
Grâce à son environnement multi-fenêtres, il permet d’afficher dans une interface commune des documents numérisés provenant de plusieurs sources. Il dispose de fonctionnalités permettant de zoomer, de comparer et d’annoter des images haute résolution, indépendamment de l’entrepôt numérique qui les héberge.
La plupart des images de Numerabilis s'affichent dans le visualiseur Mirador. Des options d'affichage sont disponibles depuis la visionneuse :
- Affichage en plein écran
- Affichage en mode Galerie
- Affichage des vignettes
- Zoom profond (selon la résolution des ressources)
- Intégration de ressources externes
D'autres services seront progressivement ouverts.
La visionneuse peut être intégrée dans tout site web. Par exemple, via la balise HTML <script> :
<html>
<head>
<script src="https://numerabilis.u-pariscite.fr/modules/Mirador/asset/js/mirador.js"></script>
</head>
<body>
<div id="mirador"></div>
</body>
</html>
Plus d'informations sur Mirador : https://demos.biblissima.fr/visualiseur-mirador/
API REST
La plateforme Omeka S fournit une interface de programmation d'applications (API) qui permet d'effectuer des opérations CRUD (Create Read Update Delete) sur ses ressources. Les ressources de l'API sont des objets avec un type, des données associées, des relations avec d'autres ressources et des ensembles de méthodes qui opèrent sur eux. Seules les opérations de lecture (Read) sont librement accessibles.
Point d'entrée : https://numerabilis.u-pariscite.fr/api
Documentation des API (en anglais) : https://omeka.org/s/docs/developer/api/rest_api/