Guide de l'utilisateur HxConvertSourceFile

Bienvenue dans le guide de l'utilisateur HxConvertSourceFile où vous apprendrez comment naviguer à travers cet outil et comment l'utiliser. Cet article couvrira les fonctions de base qui vous permettront de télécharger plusieurs enregistrements à la fois, de convertir des enregistrements téléchargés préalablement ou les deux simultanément.

Pour commencer, le logiciel HxConvertSourceFile peut être téléchargé via les liens suivants:

• HxConvertSourceFile (Windows)
• HxConvertSourceFile (Mac OS X)
• HxConvertSourceFile (source code)

Étape d'authentification pour HxConvertSourceFile

1. Commencez par sélectionner le serveur auquel vous souhaitez vous connecter. Par défaut, le serveur api.hexoskin.com pour les données Hexoskin sera sélectionné (sélectionnez astro.hexoskin.com pour accéder à vos données Astroskin).
2. Sélectionnez le bouton «Change user»* (Changer d'utilisateur) et connectez-vous avec le nom d'utilisateur et le mot de passe de votre compte.
   *Remarque: Si vous vous connectez avec votre compte administrateur, vous serez alors invité à sélectionner un «user» (utilisateur) parmi vos comptes d'utilisateurs disponibles.
3. À partir de cette étape, vous avez 3 options qui s'offrent à vous: A) Téléchargement (sans conversion) de plusieurs enregistrements, B) Conversion d'enregistrements téléchargés préalablement et C) Téléchargement et conversion de plusieurs enregistrements.

A) Téléchargement (sans conversion) de plusieurs enregistrements

1. Procéder à l'étape d'authentification.
2. Ensuite, filtrez et limitez votre recherche à l'intervalle de temps désirée via une date de début (start) et de fin (end)
3. Sélectionnez «Fetch records»** (Extraire les enregistrements) (ou «Fetch Range for activities» (Extraire la plage pour les activités)).
   **Remarque: Pour connaître la différence entre les enregistrements et les activités, reportez-vous à cet article. Les activités doivent être préalablement balisées avant pouvoir d'utiliser cette fonction pour télécharger les activités (reportez-vous cet article).
4. Une liste d'enregistrements (ou d'activités)*** apparaîtra dans la liste.
   ***Remarque: Les enregistrements seront identifiés par leurs identifiants d'enregistrement, les comptes d'utilisateurs sont également identifiés par les identifiants de compte.
5. Décochez la case «Convert after downloading raw data» (Convertir après téléchargement des données brutes) (voir plus loin pour les étapes de conversion).
6. Dans le «Data Directory» (Répertoire de données), choisissez le dossier dans lequel vous souhaitez enregistrer vos enregistrements. Dans le répertoire de données spécifié, un dossier sera créé avec l'étiquette User_## (ce numéro est votre identifiant généré par Hexoskin, ce n'est pas le nom d'utilisateur de votre compte). Dans ce dossier, le ou les enregistrements seront étiquetés record_#### (ou range_#####).
7. Dans la liste d'enregistrements (ou d'activités) qui sera générée, sélectionnez tous les enregistrements (ou plages (ranges)) que vous souhaitez télécharger. Cliquez sur un enregistrement sélectionné pour le désélectionner.
8. Cliquez sur «Download» (Télécharger) ou «Download EDF» (Télécharger au format EDF) et les enregistrements commenceront à se télécharger. La progression du téléchargement sera affichée dans la section «Execution and Logging» (Exécution et journalisation).

B) Conversion d'enregistrements téléchargés préalablement

Dans la section «Convert» (Convertir) du logiciel, vous pouvez convertir des enregistrements qui ont déjà été téléchargés au préalable par HxConvertSourceFile ou depuis le Tableau de Bord Hexoskin. Avant de commencer, vous devez choisir les options de conversion:

• «Group 1 Hz data in outputData.csv instead of outputting them in different files» (Regrouper toutes les données à 1 Hz dans un seul fichier outputData.csv au lieu de générer des fichiers distincts): Cette option vous permettra de télécharger et de regrouper toutes les données avec une fréquence d'échantillonnage de 1 Hz. Après le téléchargement, vous obtiendrez un fichier affichant les valeurs de «heart_rate», de «heart_rate_quality», d'«energy_mifflin_keytel» (c'est-à-dire la dépense énergétique), de respiration_rate, de respiration_rate_quality, d'activité, de cadence et de pression_systolique (uniquement disponible avec les données Astroskin). Si vous avez également décoché l'option «Skip raw data with frequency > 1 Hz» (Ignorer les données brutes avec fréquence > 1 Hz), vous obtiendrez un deuxième fichier affichant toutes les données brutes, comprenant l'ECG_I (ECG_II et ECG_III ne sont disponibles qu'avec les données Astroskin), la respiration_thoracique, la respiration_abdominale, l'accélération_X, l'accélération_Y et l'accélération_Z.
  
  
• «Add quality status to heartrate, breathingrate and rr_interval instead of putting them in separate files» (Ajouter l'état de qualité des données de heartrate, breathingrate et rr_interval au lieu de générer des fichiers distincts): Cette option vous permettra de télécharger et de regrouper les données heart_rate, breathing_rate ainsi que rr_interval avec leur état de qualité des données respectifs dans le même fichier. Par exemple, après le téléchargement, vous obtiendrez un fichier «heart_rate.csv» qui affichera à la fois vos données heart_rate ainsi que les données heart_rate_quality dans un seul et même fichier.
  
  
• «Save in Posix epoch time. (seconds since 1 January 1970)» (Sauvegarder au format époque Posix (soit en nombre de secondes depuis le 1er janvier 1970)): Cette option vous permettra de convertir l'unité de temps en «secondes» en temps d'époque Posix (ou Unix). Par défaut, la colonne «time [s]» (temps [s]) correspond au temps écoulé en secondes depuis le début de votre enregistrement/activité. Pour connaître la date et l'heure de début de votre enregistrement/activité, ouvrez le fichier «info.json», la date et l'heure de début sont indiquées sous «start_date» (date de début de l'enregistrement/activité). Veuillez noter que cette «start_date» est indiquée dans le fuseau horaire GMT. Cependant, si vous avez coché cette case, votre colonne de temps sera affichée en heure d'époque Unix (ou Posix) (c'est-à-dire le nombre de secondes qui se sont écoulées depuis le 1er janvier 1970 à 00:00:00 GMT). Pour convertir cette heure d'époque Unix (ou Posix) en heure normale, vous pouvez utiliser un convertisseur d'époque et unix.
  
  
• «Skip raw data with frequency > 1 Hz» (Ignorer les données brutes avec fréquence > 1 Hz): Cette option est sélectionnée par défaut. Lorsque cette option est cochée, cela signifie que tous les fichiers .wav seront convertis au format .csv, à l'exception des données brutes, comprenant l'ECG_I (ECG_II et ECG_III ne sont disponibles qu'avec les données Astroskin), la respiration_thoracique, la respiration_abdominale, l'accélération_X, l'accélération_Y et l'accélération_Z. Si la case n'est pas cochée, ces fichiers de données brutes** seront également convertis au format .csv.
  **Remarque importante : l'inclusion de données brutes dans la conversion peut augmenter le temps de traitement des données. Veuillez noter que la conversion des données peut prendre jusqu'à 1 minute par heure de données.
  
  
• «Save header» (Préserver l'en-tête): Cette option est également sélectionnée par défaut. Le nom et l'unité de chaque colonne apparaitront dans les fichiers téléchargés. Par exemple, dans le fichier heart_rate, «time [s]» (temps [s]) apparaîtra comme en-tête de la première colonne et «heart_rate [bpm» (fréquence cardiaque [bpm]) comme en-tête de la deuxième colonne.
  
  
• «Use Tab '\t' delimiter (used by Kubios) [default is comma ',' delimiter]» (Utilisez le délimiteur Tab '\t' (utilisé par Kubios) [le délimiteur par défaut est la virgule ',' ]): Cochez cette case si vous souhaitez rapporter vos données au format .txt. Cette option peut être combinée avec toutes les autres options de conversion.
  
  
• «Save empty values as 'nan'» (Enregistrer les valeurs vides sous la mention 'nan') : Cette option n'est disponible que si l'option «Skip raw data with frequency > 1 Hz» (Ignorer les données brutes avec fréquence > 1 Hz) et l'option «Group 1 Hz data in outputData.csv instead of outputting them in different files» (Regrouper toutes les données à 1 Hz dans un seul fichier outputData.csv au lieu de générer des fichiers distincts) sont toutes les deux sélectionnées. Toute valeur vide sera affichée avec la mention "nan".

Pour convertir des enregistrements déjà téléchargés:

1. Procéder à l'étape d'authentification.
2. Cliquez sur l'onglet «Convert» (Convertir).
3. Choisissez les options de la conversion (cases à cocher).
4. Dans le «Data Directory» (Répertoire de données), sélectionnez «Browse» (Parcourir) et choisissez le dossier contenant vos enregistrements*. Vous pouvez également choisir le User_## pour sélectionner tous les enregistrements dans le répertoire (dossier) de cet utilisateur.
5. Maintenant, sélectionnez tous les «records» (enregistrements), «ranges» (activités) et/ou répertoires d'utilisateurs que vous souhaitez convertir. Cliquez sur un élément sélectionné pour le désélectionner.
6. Sélectionnez «Convert» (Convertir), la progression du processus de conversion sera affichée dans la section «Execution and Logging» (Exécution et journalisation).

C) Téléchargement et conversion de plusieurs enregistrements

Pour télécharger votre/vos enregistrement(s) et les convertir en même temps, suivez les étapes indiquées ci-dessous:

1. Procéder à l'étape d'authentification.
2. Filtrez et limitez votre recherche à l'intervalle de temps désirée via une date de début (start) et de fin (end).
3. Sélectionnez «Fetch records»** (Extraire les enregistrements) (ou «Fetch Range for activities» (Extraire la plage pour les activités)).
4. Assurez-vous que est l'option «Convert after downloading raw data» (Convertir après téléchargement des données brutes) est cochée.
5. Choisissez vos paramètres dans l'onglet «Convert» (Convertir).
6. Retournez dans l'onglet «Download» (Téléchargement)
7. Dans le «Data Directory» (Répertoire de données), sélectionnez le dossier dans lequel vous souhaitez sauvegarder vos enregistrements.
8. Maintenant, dans la liste d'enregistrements (ou d'activités) qui aura été générée, sélectionnez tous les enregistrements (ou plages (ranges)) que vous souhaitez télécharger. Cliquez sur un enregistrement sélectionné pour le désélectionner.
9. Cliquez sur «Download» (Télécharger). La progression du téléchargement sera affichée dans la section «Execution and Logging» (Exécution et journalisation).