# 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").

[![cd1.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd1.png)](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):

[![cd3.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd3.png)](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.

[![cd9.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd9.png)](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".

[![cd8.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd8.png)](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.

[![cd7.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd7.png)](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 : 

[![cd4.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd4.png)](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 `/` :

[![cd13.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd13.png)](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd13.png)

Puis parmi les répertoires qui s'affichent, choisissez "local" > "sharedArches" :

[![cd14.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd14.png)](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/cd14.png)

Vous voici dans le repertoire d'images partagé.

[![cd15.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd15.png)](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.

[![ cd10.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd10.png)](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.

[![cd16.png](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/cd16.png)](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/scaled-1680-/image-1675431951375.png)](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/scaled-1680-/image-1675432177025.png)](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/scaled-1680-/image-1675436308234.png)](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/scaled-1680-/image-1675436324830.png)](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/scaled-1680-/image-1675671271449.png)](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/scaled-1680-/image-1675675582545.png)](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 <nom de l'image>_

[![](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/scaled-1680-/image-1675676945394.png)](https://wiki.unil.ch/ci/uploads/images/gallery/2023-02/image-1675676945394.png)