# Arches
Arches est une plateforme open source pour la gestion des données issues du patrimoine culturel. La DCSR met à disposition des chercheurs de l'UNIL des instances locales d'Arches.
# Présentation
[Arches](https://www.archesproject.org/) est une plateforme *open source* développée par le [Getty Conservation Institute](https://www.getty.edu/conservation) et le [World Monuments Fund](http://www.wmf.org/) pour la gestion de données issues du domaine du patrimoine culturel.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/arch.png)
Dans le but de **valoriser les données et les bases de données** des équipes de recherche de l'UNIL, la [DCSR](https://www.unil.ch/ci/fr/home/menuinst/calcul--soutien-recherche.html) met à la disposition des chercheurs des instances locales d'Arches adaptées à leurs besoins. La DCSR accompagne le processus de création par les équipes des bases de données exposées par Arches et forme les utilisateurs au maniement de la plateforme.
En plus de pouvoir être couplée à un serveur d'images [IIIF](https://iiif.io/) (protocole standard d'accès aux images à distance), Arches permet l'utilisation d'ontologies (ex. [CIDOC-CRM](https://www.cidoc-crm.org/)) et de référentiels (en [SKOS](http://www.w3.org/2004/02/skos/core.html)) standard sans l'imposer, laissant à la discrétion des équipes de recherche la manière de structurer leurs données. Cette plateforme intègre également des données géoréférencées et peut, le cas échéant, être associée à un SIG.
# Mode d'emploi général de l'utilisateur
## 1. Connexion
Cliquez sur “Sign in” et identifiez-vous avec l’adresse mail UNIL et le mot de passe fourni par la DCSR.
## 2. Le modèle de données dans Arches
Le modèle de données s’organise entre des types de ressources (= classes) et des propriétés. Un type de ressource (appelé “*Resource Model*”) se voit associé une ou plusieurs propriétés (appelées “*nodes*”) et chaque propriété correspond à un format de données défini, appelé *“datatype”:* texte, date, lien vers un autre type de ressource, nombre, etc.
## 3. Présentation de l'interface graphique
### Saisie des données
#### Création d’une ressource
Une fois authentifié, cliquez sur “*Manage*”, en haut à droite. On accède ensuite à l’écran du gestionnaire de ressources “*Resource Manager*”:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap1.png)
Sélectionnez le type de ressource (ou classe) que vous souhaitez créer. Cliquez sur “*Create Resource*”.
Pour créer une ressource, il faut créer toutes les propriétés (“*nodes*”) pertinentes pour une ressource donnée. Ces propriétés sont visibles dans le volet latéral gauche.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap2.png)
Lorsqu’on clique sur l’une de ces propriétés, les éléments qui doivent être renseignés s’affichent dans la partie centrale.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap3.png)
Les éléments obligatoires sont signalés par un **astérisque**. Les éléments surlignés en vert serviront pour identifier une ressource dans les résultats d’une recherche, par exemple; ils servent de titre et de description de la ressource.
Dans la partie centrale sont affichés dans indications concernant le format ou la nature des données attendues pour une propriété donnée.
Après avoir entré une propriété ou les différents éléments qui composent une propriété, on peut valider la saisie (“*+ Add*”) ou l’annuler (“*Cancel edit*”).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/D8Qcap5.png)
Si une valeur a été entrée pour une propriété sans que la saisie ait été validée, la propriété sera surlignée en **jaune**. On peut alors revenir sur la propriété en question et valider la saisie (“*+ Add*”).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/Aikcap18.png)
Les propriétés affichées en **vert** dans le volet latéral correspondent aux propriétés qui serviront de titre et de description pour la ressource. Ces propriétés qui permettront d’identifier une ressource parmi d’autres résultats de recherche (voir l’exemple ci-dessous).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap4.png)
#### Les formats de données
Les propriétés d’une ressource correspondent à différents formats de données.
##### • **texte brut**
##### • **texte avec mise en forme**
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap6.png)
##### • **téléchargement (*upload*) d’un document et/ou d’une image**:
Cliquer-déposer le document ou sélectionner le fichier à télécharger (upload) dans une arborescence de fichiers. Suivre les indications fournies par Arches.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap9.png)
##### • **date**
Les dates sont prises en charge avec différents niveaux de précision:
- date précise
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap7.png)
- date avec une précision affichée de l'ordre du mois ou de l'année
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap8.png)
Dans ces deux cas, on peut utiliser le calendrier pour choisir la date exacte ou entrer la date ou une partie de la date directement dans le champ, ce qui peut faire gagner du temps.
- dates avec une imprécision hétérogène ([Extended Date/Time Format](https://www.loc.gov/standards/datetime/edtf.html)):
- indications de fourchettes chronologiques lorsque la date exacte n’est pas connue: 1960/1971, 1971-06/1971-11, etc.
- les éléments de la date qui ne sont pas connus peuvent être remplacés par un `u` : 20uu-06-17, uuuu-12-11, 1978-uu-15.
##### • **vocabulaires contrôlés**
Plusieurs types de **vocabulaires contrôlés** (= liste de valeurs, thésaurus) sont pris en charge:
- vocabulaire contrôlé plat
- vocabulaire contrôlé hiérarchique
- thésaurus (SKOS, avec équivalence de terme, multilinguisme, etc.)
Selon les besoins du projet (vocabulaire plat ou hiérarchique, nécessité ou non de faire évoluer le vocabulaire (plat uniquement) en cours de projet), il est possible de choisir l’une ou l’autre manière de gérer ces vocabulaires. Ceux-ci peuvent être affichés sous la forme de cases à cocher ou de listes déroulantes.
Dans le cas de listes déroulantes, l’utilisateur peut faire dérouler l’ensemble de la liste ou entrer les premières lettres du terme recherché.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap10.png)
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap11.png)
##### • **URL**
L’utilisateur peut fournir uniquement l’URL ou associer également un texte auquel sera associé le lien hypertexte:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap12.png)
ou bien :
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap13.png)
##### • **lien vers une autre ressource**
Lien vers un autre type (classe) de ressource: en fonction du modèle de données défini pour un projet, il est possible de créer un lien entre deux types de ressource (par exemple un lien entre un “Livre” et un “Auteur”).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/VCocap14.png)
Si la ressource vers laquelle on veut créer un lien existe déjà, on entre quelques lettres correspondant au titre de la ressource ou à l’une de ses propriétés dans le champ correspondant. Arches affiche alors les résultats correspondants.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/mQ6cap15.png)
Si la ressource n’existe pas, on peut la créer depuis “*Create a new ...*”. Une fois entrée les différents propriétés pour cette ressource, on clique sur “*Return*”.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap16.png)
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap17.png)
Le lien est alors créé entre les deux ressources, il ne reste qu’à valider sa création en cliquant sur “*+ | Add*”.
##### • géolocalisation
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap22.png)
On peut localiser un élément sur un fond de carte. L’emprise de la carte est normalement définie par défaut pour le projet, tout comme le fond de carte (image satellite ou carte).
Selon la manière dont est paramétrer cette propriété, il est possible de placer sur la carte un point, une ligne ou un polygone via le menu “*Add new feature*”.
L’utilisateur peut modifier le fond de carte à partir du menu latéral, onglet “*Basemap*” et sélectionner celui qui lui convient.
À partir du même menu, l’onglet “*Overlays*” permet à l’utilisateur d’afficher les éléments déjà localisés pour les différentes types de ressources: on peut afficher/cacher ces éléments et régler leur niveau de transparence lorsqu’ils sont affichés (icône placée à droite du nom de la propriété).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/BUTcap23.png)
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/llWcap24.png)
#### Édition d’une ressource
Depuis la page de la ressource, en haut à droite, sélectionner l’icône “crayon” (=“*Edit Resource*”).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/edit1a.png)
Et puis pour éditer chaque propriété, choix entre l’icône “crayon” (=édition) ou “poubelle” (= suppression).
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/edit1b.png)
Si aucune valeur n'a été entrée pour une propriété et que vous souhaitez en ajouter une, il faut sélectionner directement la propriété dans la partie latérale gauche.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/edit1b-copie.png)
Après avoir entré une nouvelle valeur dans le champ de la propriété, l’utilisateur a le choix entre “*Delete this record*”, “*x Cancel edit*” et “*+ Save edit*”.
#### Suppression d’une ressource
Depuis la page de la ressource, en haut à gauche menu “*Manage ···*” > “*Delete Resource*”.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap19.png)
### Modification des permissions associées à une ressource
Pour **chaque ressource**, il est possible de paramétrer des permissions spécifiques: “*Manage permissions*” en bas de l’onglet latéral, quand on est en cours d’édition de ressource, quand l’utilisateur possède le statut “*Superuser*”.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap39.png)
Si l’utilisateur veut changer les permissions attribuées par défaut à la ressource, dès qu’il clique sur “*Manage permissions*”, il change les permissions courantes et se trouve, par défaut, le seul utilisateur à pouvoir accéder à la ressource en question: il est le seul à disposer des droits *“Read”,* “*Update*”, “*Delete*” sur la ressource, tous les autres utilisateurs individuels et membres de groupes se voient attribuer “*No Access*”.
Pour revenir au schéma de permission tel que défini par défaut pour la ressource, il faut cliquer sur “*Allow Normal Access*”. Et si l’utilisateur veut modifier les permissions associées à cette ressource, il doit sélectionner manuellement un à un tous les groupes **et** tous les utilisateurs individuels auxquels il souhaite donner les droits *“Read”, “Update”* et/ou *“Delete”* et cocher/décocher les droits correspondants.
### Consultation
Depuis la page d’une ressource, en haut à droite “*Hide Null Values*” permet de ne pas afficher les propriétés non renseignées.
### Recherche
Arches offre 4 types de recherche à partir du menu latéral gauche *“Search”,* représenté par l’icône d’une loupe:
- la recherche fondée sur la géolocalisation des ressources (onglet “*Map filter*”)
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap29.png)
- la recherche plein texte
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap26.png)
- la recherche par type de ressource
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap27.png)
- la recherche avancée (onglet *“Advanced”)*
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap28.png)
#### Recherche plein texte
Arches permet de visualiser immédiatement les correspondances avec le terme recherché. il est aussi possible de distinguer entre le terme recherché utilisé dans les champs textuels de la base de données (“*Term Matches*”) et le terme s’il fait partie d‘un vocabulaire contrôlé *(“Concept”).*
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap35.png)
Le caractère `*` permet de remplacer un ou plusieurs caractères:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap36.png)
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap37.png)
Mais placé en début de mot, il ne donne pas de résultat (ici, Rimbaud n'apparaît pas parmi les résultats de recherche):
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap38.png)
#### Recherche par type de ressource (en construction)
#### Recherche par date (en construction)
#### Recherche sur la géolocalisation (en construction)
#### Recherche avancée
Cette recherche permet de combiner différents critères (ou facettes) et différents opérateurs (“et” et “ou”).
La partie droite sous “*Search Facets*” liste les types de ressources ainsi que leurs propriétés qui peuvent être utilisés pour la recherche. Dans le champ *“Find...”* sous “*Search Facets*”, l’utilisateur peut trier les types de ressource ou les propriétés à afficher.
Une fois sélectionné un type de ressource, l’utilisateur peut ensuite sélectionner la ou les propriétés pertinentes pour construire sa recherche. Pour combiner les différents critères, une fois la première propriété choisie, il suffit d’en sélectionner une autre, qui s’ajoutera sous la première. L’utilisateur doit ensuite définir l’opérateur pertinent *(“And”* ou *“Or”).*
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap25.png)
En fonction du format de données associé à la propriété,
Les paramètres de recherche proposés pour chaque propriété dépendent du format de données associé:
- pour du texte:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap30.png)
- pour un nombre:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap31.png)
- pour un booléen (vrai/faux, oui/non):
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap32.png)
- pour un lien entre deux types de ressources:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap33.png)
- pour un vocabulaire contrôlé:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-01/cap34.png)
- pour des données géolocalisées:
Le format de données “géolocalisation” n’est pas pris en charge dans la recherche avancée; l’onglet “*Map filter*” permet de filtrer les résultats de recherche en fonction de la localisation des ressources ou de leurs propriétés.
# Import des images (Val d'Hérens/Smapshot)
***Cette section ne concerne que le projet Val d'Hérens 1950/2050.***
### Préambule
La plateforme Arches permet de télécharger une image (*upload*) de [manière autonome](https://wiki.unil.ch/ci/books/research-support/page/mode-demploi-general-de-lutilisateur#bkmrk-%E2%80%A2-t%C3%A9l%C3%A9chargement-%28up).
Cependant, la gestion des images doit suivre ce protocole pour deux raisons :
1. l'espace de stockage (200 Go) alloué sur la machine virtuelle (VM) sur laquelle est déployé Arches impose de rationaliser la gestion des images, compte tenu des paramètres avec lesquels les documents ont été numérisés ;
2. comme [Smapshot](https://smapshot.heig-vd.ch/) accède aux images servies par Cantaloupe via une URL qui contient le nom du fichier d'origine, les utilisateurs doivent veiller ce que toute nouvelle version d'une image téléchargée manuellement dans Arches (par exemple pour corriger une mauvaise orientation) conserve le nom de l'image d'origine.
# 1. Transformation de l'image avant un premier import manuel
Le téléchargement manuel d'une nouvelle image, pour des données qui n'ont pas encore été transférées vers Smapshot, requiert:
- de convertir l'image dans un **format `.png`** (d'une part parce qu'il s'agit d'un format sans perte, contrairement au `jpeg`, et, d'autre part parce que ce format est interprétable par les navigateurs web, contrairement au format `.tif`, ce qui signifie qu'Arches est capable d'afficher l'image) ;
- de limiter la taille du plus grand côté de l'image à **2500 pixels**.
Des outils permettent de transformer des images par lots de manière à ce qu'elles correspondent à ces critères : [ImageMagick](https://imagemagick.org/), des scripts AdobePhotoshop, etc.
Avec ImageMagick, la commande est:
```bash
convert -auto-orient -format png -resize 2500x2500\> original.tif destination.png
```
# 2. Remplacement d'une image par une autre (images déjà intégrées dans Smapshot)
Pour les images déjà intégrées dans Smapshot qui nécessitent un recadrage ou dont l'orientation doit être corrigée, il faut repartir des images stockées dans le `/local/sharedArches` sur l'espace de stockage allouée à la VM d'Arches, puisque:
- toutes ces images ont déjà été converties et redimensionnées
- en partant de ce repertoire on peut conserver le nom des fichiers d'origine.
## 2.1. Avec CyberDuck, sur un Mac
### 2.1.1. Installation de CyberDuck
Installer [CyberDuck](https://cyberduck.io/download/).
### 2.1.2. Paramétrer la connexion
Une fois CyberDuck ouvert, cliquez sur "Ouvrir une connexion" (ou sur "Fichier" > "Ouvrir une connexion").
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd1.png)
Paramétrer la connexion sur ce modèle (identifiant et mot de passe UNIL):
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd3.png)
Et cliquez sur "Connecter" puis sur "Autoriser", sur la boîte de dialogue qui s'ouvre.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd9.png)
Pour garder les paramètres de cette connection en mémoire, dans le menu principal, cliquez sur "Signet" > "Nouveau signet". Dans la fenêtre qui s'ouvre, vous pouvez donner au signet le surnom "vdherens1950".
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd8.png)
À la prochaine ouverture de CyberDuck, la connexion au serveur **vdherens1950** vous sera proposée dès la fenêtre d'accueil.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd7.png).
### 2.1.3. Atteindre le repertoire d'images partagé `/local/sharedArches`
Vous arrivez sur un répertoire à votre nom dans l'espace de stockage :
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd4.png)
Il s'agit maintenant de rejoindre le répertoire `/local/sharedArches` dans lequel se trouvent les images. Dans le menu déroulant, sélectionner `/` :
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd13.png)
Puis parmi les répertoires qui s'affichent, choisissez "local" > "sharedArches" :
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd14.png)
Vous voici dans le repertoire d'images partagé.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd15.png)
### 2.1.4. Parcourir les images avec le visualisateur interne de CyberDuck
Il est possible de consulter les images directement dans le répertoire `/local/sharedArches` avec le **visualisateur interne de CyberDuck**.
Avec un clic droit sur le nom de fichier, choisissez "Coup d'œil" dans le menu contextuel. Il faut à CyberDuck quelques secondes pour charger ces aperçus et les afficher.
Il est aussi possible de sélectionner plusieurs images (maintenir la touche majuscule/shift enfondée puis clic droit) et de visualiser l'ensemble des images sélectionnées.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd10.png)
### 2.1.5. Éditer les images
L'édition peut se faire avec différentes applications, en fonction des options disponibles sous "Editer avec" dans le menu contextuel.
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd16.png)
Nous avons testé l'édition d'images avec 2 applications :
- avec **Aperçu**, il n'est pas possible d'enregistrer les modifications apportées directement sur le serveur. C'est une copie de l'image qu'Aperçu propose d'enregistrer, en local.
- **Adobe Photoshop** permet d'enregistrer directement ces modifications, avec un simple `commande + S`.
## 2.2. Sous Linux
### 2.2.1. Paramétrer la connexion
Pour une distribution [Ubuntu](https://ubuntu.com/), à partir du navigateur de fichier, on peut sélectionner "Autres emplacements":
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675431951375.png)
pour entrer l'adresse du serveur: `sftp://dcsrs-vherens50.dcsr.unil.ch/` puis cliquer sur "se connecter":
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675432177025.png)
Pour les connections suivantes, l'adesse du serveur devrait rester dans la liste des connections recentes.
Il faut se connecter avec l'identifiant Unil sans l'addresse mail, soit pour moi, `ljaouen`.
### 2.2.2. Atteindre le repertoire d'images partagé /local/sharedArches
Par défaut, le répertoire de l'utilistateur est ouvert, clicquer sur le nom du serveur permet de remonter à la source pour naviguer dans le répertoire `/local/sharedArches`:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675436308234.png)
### 2.2.3. Parcourir les images avec le visualisateur par défaut
Arrivé dans le répertoire `/local/sharedArches`, la liste des images est visible, cliquer (double) sur une des images l'affiche:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675436324830.png)
La navigation d'une image à l'autre se fait avec les touches du clavier [<-] et [->].
### 2.2.4. Éditer les images
#### 2.2.4.1 Rotation simple
Pour faire pivoter l'image, il faut passer la souris sur l'image ce qui fait apparaître les deux indicateurs de rotation en bas au milieu:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675671271449.png)
En suite, il suffit d'enregistrer ([control]+[s]) ou de passer par le menu:
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675675582545.png)
#### 2.2.4.2. Edition fine
Pour une édition plus fine (rognage, rotation, découpage) il est possible d'ouvrir l'image avec un autre éditeur (comme [gimp](https://www.gimp.org/), à installer), l'ouverture se fait par un click droit, la sauvegarde de l'image par l'option _Fichier => Ecraser _
[](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675676945394.png)