User Tools

Site Tools


wiki:epims3_3:user:epback

This is an old revision of the document!


Guide d'utilisation d'eP-Back

1. Introduction

eP-Back s’inscrit dans le cadre d'ePIMS qui est un système de gestions des données issues de la plateforme protéomique. L’objectif de ce système est de conserver une trace des données produites et de faire de ce système un outil de travail quotidien.

eP-Back est une application standalone qui permet de traiter les données électroniques générées sur les instruments. Les deux opérations principales sont :

  • Le transfert des données vers le SAN avec renseignement de la base de données ePIMS. Les données ainsi transférées seront par la suite accessibles via l'application eP-Web.
  • La suppression sur le PC des instruments des analyses qui ont déjà été transférées sur le SAN.

Les principes relatifs aux données électroniques : nommage / organisation sur le SAN… sont donnés dans le document de spécification FIXME Traitements des données.

1. Lancement

Avant d'executer eP-Back il faut avoir correctement configuré l'environnement. Voir la partie administration.

Pour démarrer l'application, il suffit d'executer le fichier eP-Back-<version>.jar qui se trouve à la racine du répertoire eP-Back. Un fichier .bat peut eventuellement être créé pour executer eP-Back avec plus de mémoire :

java -Xms64m -Xmx256m -jar eP-Back-<version>.jar

2. Description général


figure 1: ScreenShot général eP-Back

Lorsqu' on lance l'application, les différents fichiers de configuration, notamment les descriptions des instruments, sont lus et la fenêtre illustrée ci-dessus est affichée. On retrouve les parties suivantes :

  1. La liste des instruments pour lesquels eP-Back a trouvé un fichier de configuration
  2. Les propriétés relatives à l'instrument sélectionné en 1.: le répertoire contenant les analyses et celui où les données seront transférées (répertoire racine de ePims) sont donnés à titre indicatif mais ne sont pas modifiables. 2.1 l'opération désirée, transfert des données ou nettoyage des instruments.
  3. Panneau de configuration spécique au type d'instrument sélectionné.
  4. Liste des analyses trouvées pour l'instrument sélectionné
  5. Accès à l'onglet contenant le rapport de transfert et/ou de nettoyage
  6. Bouton de lancement de l'opération

3. Configuration

1. Choix de l'instrument

Pour choisir l'instrument sur lequel récupérer ou supprimer les données il suffit de le choisir dans la liste proposé (voir partie1 sur la figure 1). Si l'instrument n'apparait pas dans la liste, c'est que celui n'a pas de fichier de configuration associé. Voir la partie administration. Les propriétés spécique à l'instrument choisi sont affichés (dans la partie 2 sur la figure 1).

2. Configuration spécifique

Selon le type de l'instrument sélectionné un panneau de configuration différent apparait sur la partie droite de la fenêtre (voir partie3 sur la figure 1). Dans le cas des QTOF Waters ou des LTQ Thermo les configurations spéciques sont identiques: Demander à traiter les spectres en même temps que les fichiers bruts. Dans le cas des QTOF Waters, il est également nécessaire de spécifier le chemin d'accès aux .pkl.

3. Choix de l'opération

Les deux opérations possibles, quelque soit le type d'instrument choisi, sont

  • le transfert de données des instruments vers le SAN
  • la suppression des données sur les instruments.


En fonction de l'opération choisie, la liste des analyses trouvées pour l'instrument spécifié est modifiée. En effet, ce ne sont pas les mêmes analyses qui sont sélectionnables dans les deux cas. Plus de détails sur les analyses valides et sélectionnables sont donnés ci-après.

4. Visualisation des analyses

figure 2 : Les analyses

1. Les icônes

  • : Visualisation ou non des analyses non sauvegardées. L'icône affichée correspond à l'état actuel.
  • : Visualisation ou non des analyses déjà sauvegardées. L'icône affichée correspond à l'état actuel.
  • : Sélectionne toutes les analyses “sélectionnables” (la signification d'une analyse sélectionnable est donnée plus bas)
  • : Désélectionne toutes les analyses
  • : Inverse la sélection : désélectionne les analyses sélectionnées et sélectionne les analyses “sélectionnables” qui ne l'étaient pas
  • : Recherche de nouveau les analyses dans le répertoire spécique à l'instrument

2. La liste

Quelque soit le type de l'instrument sélectionné et donc le format des analyses certaines colonnes sont toujours présentes:

  • Le nom de l'analyse
  • L'étude dans laquelle elle a été faite
  • L'échantillon qui a été analysé
  • La date de l'acquisition
  • La durée de l'acquisition
  • La taille du fichier résultat
  • La destination qui indique où les données seront transférées
  • L'état de l'analyse

L'état informe sur la validité des informations fournies. Les différents états possibles pour une analyse sont :

  • Etude invalide : le nom spécifié pour l'étude n'est pas connu de ePims
  • Sauvegardée : l'acquisition correspondante a déjà été transférée sur le SAN
  • Etude close : l'étude d'appartenance de l'analyse existe mais est close.
  • Echantillon invalide : le nom spécifié pour l'échantillon n'est pas connu de ePims
  • Ech <> etude : L'échantillon spécifié existe mais il est rattaché à une autre étude.
  • OK : les informations relatives à l'analyse sont cohérentes et elle n'a pas encore été sauvegardée.

L'état réel d'une analyse peut être une combinaison de ces différents états mais seul le plus “prioritaire” sera indiqué. L'ordre de priorité est celui utilisé ci-dessus. Par conséquent, pour une analyse référencant un échantillon inexistant et appartenant à une étude close, la colonne état indiquera “Etude close”.

Les acquisitions de contrôles ne sont rattachées à aucune étude ou aucun échantillon. Par conséquent leur état est soit OK, soit Sauvegardée. Pour les identifier, les valeurs ControleLC, ControleInst et Blanc doivent être saisies dans la colonne Etude pour, respectivement, les acquisitions de contrôles des LC, des spectromètres et les blancs utilisés entre deux acquisitions recherches.

La table peut être ordonnée selon n’importe laquelle des colonnes affichées. Pour cela, il suffit de double cliquer sur l’en-tête de la colonne.

a. Colonnes supplémentaires

Selon le type de l'instrument sélectionné et donc le format des analyses, des colonnes supplémentaires peuvent être affichées.

Pour les QTOF Waters les colonnes suivantes sont présentes :

  • Le nom du responsable de l'analyse correspondant à la personne ayant réalisée l'acquisition
  • Le nom du responsable de l'échantillon
  • Une description de l'analyse.
  • Le pkl associé à l'analyse si l'option transfert des spectres à été sélectionnée dans la panneau de configuration spécifique aux QTOF Water (voir chapitre plus haut)
  • Le prp associé à l'analyse si l'option transfert des spectres à été sélectionné dans la panneau de configuration spécifique aux QTOF Water (voir chapitre plus haut)


Pour les LTQ Thermo les colonnes suivantes sont présentes :

  • Le nom du responsable de l'analyse correspondant à la personne ayant réalisée l'acquisition
  • Le nom du responsable de l'échantillon
  • Une description de l'analyse.
  • Le mgf associé à l'analyse si l'option transfert des spectres à été sélectionné dans la panneau de configuration spécifique aux LTQ Thermo (voir chapitre plus haut)

b. Modification

Lorsqu'une erreur à été commise lors du renseignement du nom de l'étude et/ou de l'échantillon au moment de l'acquisition, il est possible de corriger ces valeurs au niveau de eP-Back. Pour cela il suffit de double-cliquer sur la cellule du tableau contenant la valeur à corriger.
Il est impossible de modifier les valeurs des acquisitions déjà transférées sur le SAN.

De plus, il est possible de faire du copier/coller sur plusieurs cellules : sélectionner avec un simple clique la colonne à copier, taper <Ctrl>+C, sélectionner toutes les colonnes pour lesquelles on souhaite saisir la nouvelle valeur et taper <Ctrl>+v. La sélection de plusieurs colonnes se fait avec la touche <shift> et/ou <Ctrl>.

3. Sélection et démarrage

1. Sélection des analyses

La sélection des analyses à copier se fait soit globalement en utilisant les icônes soit analyse par analyse en sélectionnant celles désirées en début de ligne. Le nombre d’analyses sélectionnées ainsi que la taille globale estimée sont affichés en bas à droite du tableau.

En mode nettoyage :

Seules les analyses déjà sauvegardées peuvent être supprimées des instruments. Néanmoins, il est possible de sélectionner les acquisitions de tests. Pour ça, il faut saisir “test” dans la colonne Etude.

En mode transfert :

Les analyses déjà transférées ne sont pas sélectionnables, elles sont en grisées dans le tableau. Toutes les autres analyses sont potentiellement sélectionnables même si il faut d'abord corriger les erreurs de nommage des études/échantillons. Dans tous les cas, il est souhaitable qu'une analyse non enregistrée puisse être sauvegardée !!

Pour qu'une analyse soit sélectionnable il faut qu'elle soit valide (OK dans la colonne Etat) et que le chemin destination associé soit déterminé.

2. Démarrage

Une fois la configuration faite et les analyses sélectionnées, il suffit de cliquer sur le bouton démarrer en bas de la fenêtre.

Un rapport sur le déroulement des opérations est généré et est accessible depuis l'onglet Rapport


Figure 3 : Affichage des analyses, en mode transfert





(Retour au menu de la documentation ⇒ .)

wiki/epims3_3/user/epback.1203609320.txt.gz · Last modified: 2008/09/24 15:35 (external edit)