# Pyrocko EOST | Snuffler
Snuffler est un plugin pour la visualisation de traces sismologiques qui fait partie du framework Python Pyrocko.
### ATTENTION
Si vous avez déjà une version de Pyrocko d'installer, veuillez la désinstaller en suivant les consignes ci-dessous.
## Désinstallation
**LINUX :**
```bash
> sudo pip3 uninstall pyrockoeost
> sudo rm -rf ~/.pyrockoeost
```
**WINDOWS**
```bash
> pip uninstall pyrockoeost
> rmdir "C:\Users\USERNAME\.pyrockoeost"
```
## Prérequis
Si vous vous trouvez dans un environnement virtuel, veuillez en sortir.
**Exemple avec conda :**
```bash
> conda deactivate
```
### Installation des prérequis :
**LINUX ( Debian / Ubuntu ) :**
```bash
> sudo apt update
> sudo apt upgrade
> sudo apt-get install python3-pip
> sudo pip3 install --upgrade pip
> sudo sh prerequisites/prerequisites_debian_python3.sh
```
**WINDOWS**
REQUIS : Microsoft C++ build tools
Ouvrir "windows-install-build-tools.bat" pour installer rapidement.
```bash
> prerequisites/prerequisites.bat
```
## Installation
### Installation avec PIP.
**LINUX :**
```bash
> sudo pip3 install pyrockoeost # Ajouter "--break-system-packages" pour bypass le warning d'environnement virtuel
```
**WINDOWS**
```bash
> pip install pyrockoeost
```
### Installation depuis la SOURCE.
**LINUX :**
```bash
> cd pyrockoeost
> sudo pip3 install .
```
**WINDOWS**
```bash
> cd pyrockoeost
> pip install .
```
### Quelques erreurs connues :
Pour l'erreur `PyQt5 no such file or directory : "setup.py egg_info"` :
- Revoir la section **Prérequis**.
Pour l'erreur `qt.qpa.plugin: Could not load the Qt platform plugin "xcb"` :
```bash
> sudo pip3 uninstall PyQt5
> sudo apt install python3-pyqt5
```
Pour l'erreur `No module names PyQt4`, installez :
```bash
> sudo apt-get install python-pyqt5
```
Pour l'erreur `No module names QtOpenGL`, installez :
```bash
> sudo apt-get install python-pyqt5.qtopengl
```
Pour l'erreur `No module names QtSvg`, installez :
```bash
> sudo apt-get install python-pyqt5.qtsvg
```
## Mettre à jour PyrockoEost
**LINUX :**
```bash
> sudo pip3 install --upgrade pyrockoeost
```
**WINDOWS**
```bash
> pip install --upgrade pyrockoeost
```
## Configuration
- Pour cela, lancer une 1ère fois pyrockoeost.
- Le fichier **snuffler.pf** va se creer, cliquer sur "Fichier" en haut à droite puis "Ouvrir fichier de config".
- On peut alors editer ce fichier pour en changer les paramètres et notamment les paths.
Éditez les variables d'emplacements `path_hodochrones`, `path_save_depu` et `path_donnees_quant` pour les adapter à votre système.
### Par défaut, ce fichier ressemble à ca:
```yaml
--- !pf.SnufflerConfig
visible_length_setting:
- - Court
- 20000.0
- - Moyen
- 60000.0
- - Long
- 120000.0
- - Extra Long
- 600000.0
phase_key_mapping:
F1: P-Pdif
F2: PKP
F3: PP
F4: SKS
F5: S-SKKS
F6: SP
F7: SS
F8: LOVE
F9: RAYL
demean: true
show_scale_ranges: false
show_scale_axes: false
trace_scale: individual_scale
show_boxes: true
clip_traces: true
first_start: false
station: None
path_hodochrones: /home/vsc/depu/HODOCHRONES/
path_save_depu: /home/vsc/depu/Pointes/
path_donnees_quant: /home/vsc/depu/Donnees_Quant/
```
## Lancement de l'outil
N'importe où sur le système:
```bash
> snuffler
```
## Import de fichier
L'outil est capable de gérer différents types de fichiers: LH, BH, HH, miniseed, ...
Vous pouvez importer de nouveaux fichiers par glisser-déposer depuis un explorateur ou par le bouton "Ouvrir des fichiers" dans l'onglet EOST - Hodochrones.
## Pointer un séisme
### Créer un marqueur de phase
En double cliquant sur une des voies de votre sismogramme, un marqueur flottant apparait.
Vous pouvez le déplacer jusqu'à lui affecter une valeur fixe.
### Supprimer un marqueur
Sélectionnez un marqueur par un simple `Clic-Gauche`, utilisez la touche `Retour arrière` (Backspace) pour supprimer le marqueur.
En maintenant la touche `Shift`, vous pouvez sélectionner plusieurs marqueurs pour faire une grosse suppression d'un coup.
Le touche `A` vous permet de sélectionner tous les marqueurs.
### Affecter un type à un marqueur
Les types sont définis dans le fichier de configuration `$HOME/.pyrockoeost/snuffler.pf` , vous pouvez modifier les raccourcis clavier attribués depuis ce fichier de configuration.
Par défaut, les valeurs attribuées sont les suivantes:
|Touche| Phase |
|-----|--------|
| F1 | P-Pdif |
| F2 | PKP |
| F3 | PP |
| F4 | S-SKKS |
| F5 | SKS |
| F6 | SP |
| F7 | SS |
| F8 | LOVE |
| F9 | RAYL |
### Déplacer un marqueur
Il suffit de sélectionner marqueur (`clic gauche`), et d'utiliser les touches directionnelles (flèche de droite / gauche) puis valider avec `Entrée`.
Pour accélérer le déplacement, vous pouvez maintenir la touche `Shift` enfoncée.
### Changer la couleur d'un marqueur
La couleur des marqueurs est utilisée pour en définir le rôle:
- Un marqueur rouge vient d'être ajouté
- Un marqueur bleu servira de référence pour le prochain calcul d'hodochrone
- Un marqueur jaune a été ajouté par un calcul d'hodochrone et sera supprimé par la fonction "Supprimer Les Hodochrones"
Vous pouvez éditer le type d'un marqueur avec les chiffres:
|Chiffre| Couleur | Utilité |Sauvegarder|
|-------|---------|---------|-----------|
| 0 | Rouge | Par défaut |OUI|
| 1 | Vert | |OUI|
| 2 | Bleu | Phase de référence pour le calcul d'hodochrones |OUI|
| 3 | Jaune | Phase calculée par la méthode hodochrones |NON|
| 4 | Violet | |OUI|
| 5 | Marron | |OUI|
## Sauvegarder un pointé
Toutes les phases autres que Jaune seront sauvegardées. Changez leurs couleurs si nécessaire.
Une fois vos phases prêtes, appuyez sur **Sauvegarder les phases** ( vérifiez que l'emplacement de sortie a bien été défini dans la configuration : Fichier *snuffler.pf* ).
On vous demandera ensuite si vous voulez ajouter les données à la suite ou remplacer le fichier s'il existe déjà.
## Contrôles
Tous les contrôles sont disponibles dans l'onglet d'aide ou en appuyant sur la touche `?`.
## Origine
[Official Link Pyrocko](https://pyrocko.org/)
Raw data
{
"_id": null,
"home_page": "",
"name": "pyrockoeost",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "Pyrocko EOST <pyrocko@gmail.com>",
"keywords": "seismology,waveform analysis,earthquake modelling,geophysics,geophysical inversion",
"author": "",
"author_email": "The pyrockoeost Developers <pyrocko@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d1/91/5ba964e4288e52fb8cfa0386b905fd3bd834fa48bfcdca6f9fc9c09a95b5/pyrockoeost-2023.9.tar.gz",
"platform": null,
"description": "\r\n# Pyrocko EOST | Snuffler\r\n\r\nSnuffler est un plugin pour la visualisation de traces sismologiques qui fait partie du framework Python Pyrocko.\r\n\r\n### ATTENTION \r\nSi vous avez d\u00e9j\u00e0 une version de Pyrocko d'installer, veuillez la d\u00e9sinstaller en suivant les consignes ci-dessous.\r\n\r\n## D\u00e9sinstallation\r\n**LINUX :**\r\n```bash\r\n> sudo pip3 uninstall pyrockoeost\r\n> sudo rm -rf ~/.pyrockoeost\r\n```\r\n**WINDOWS** \r\n```bash\r\n> pip uninstall pyrockoeost\r\n> rmdir \"C:\\Users\\USERNAME\\.pyrockoeost\"\r\n```\r\n## Pr\u00e9requis\r\nSi vous vous trouvez dans un environnement virtuel, veuillez en sortir. \r\n**Exemple avec conda :**\r\n```bash\r\n> conda deactivate\r\n```\r\n### Installation des pr\u00e9requis :\r\n**LINUX ( Debian / Ubuntu ) :**\r\n```bash\r\n> sudo apt update\r\n> sudo apt upgrade\r\n> sudo apt-get install python3-pip\r\n> sudo pip3 install --upgrade pip\r\n> sudo sh prerequisites/prerequisites_debian_python3.sh\r\n```\r\n**WINDOWS** \r\nREQUIS : Microsoft C++ build tools \r\nOuvrir \"windows-install-build-tools.bat\" pour installer rapidement.\r\n```bash\r\n> prerequisites/prerequisites.bat\r\n```\r\n\r\n## Installation\r\n### Installation avec PIP. \r\n**LINUX :**\r\n```bash\r\n> sudo pip3 install pyrockoeost # Ajouter \"--break-system-packages\" pour bypass le warning d'environnement virtuel\r\n```\r\n**WINDOWS** \r\n```bash\r\n> pip install pyrockoeost\r\n```\r\n### Installation depuis la SOURCE. \r\n**LINUX :**\r\n```bash\r\n> cd pyrockoeost\r\n> sudo pip3 install .\r\n```\r\n**WINDOWS** \r\n```bash\r\n> cd pyrockoeost\r\n> pip install .\r\n```\r\n\r\n### Quelques erreurs connues :\r\n\r\nPour l'erreur `PyQt5 no such file or directory : \"setup.py egg_info\"` :\r\n\r\n- Revoir la section **Pr\u00e9requis**.\r\n\r\nPour l'erreur `qt.qpa.plugin: Could not load the Qt platform plugin \"xcb\"` :\r\n```bash\r\n> sudo pip3 uninstall PyQt5\r\n> sudo apt install python3-pyqt5\r\n```\r\n\r\nPour l'erreur `No module names PyQt4`, installez :\r\n```bash\r\n> sudo apt-get install python-pyqt5\r\n```\r\n\r\nPour l'erreur `No module names QtOpenGL`, installez :\r\n```bash\r\n> sudo apt-get install python-pyqt5.qtopengl\r\n```\r\n\r\nPour l'erreur `No module names QtSvg`, installez :\r\n```bash\r\n> sudo apt-get install python-pyqt5.qtsvg\r\n```\r\n\r\n## Mettre \u00e0 jour PyrockoEost\r\n**LINUX :**\r\n```bash\r\n> sudo pip3 install --upgrade pyrockoeost\r\n```\r\n**WINDOWS** \r\n```bash\r\n> pip install --upgrade pyrockoeost\r\n```\r\n\r\n## Configuration\r\n- Pour cela, lancer une 1\u00e8re fois pyrockoeost. \r\n- Le fichier **snuffler.pf** va se creer, cliquer sur \"Fichier\" en haut \u00e0 droite puis \"Ouvrir fichier de config\". \r\n- On peut alors editer ce fichier pour en changer les param\u00e8tres et notamment les paths.\r\n\r\n\u00c9ditez les variables d'emplacements `path_hodochrones`, `path_save_depu` et `path_donnees_quant` pour les adapter \u00e0 votre syst\u00e8me.\r\n\r\n### Par d\u00e9faut, ce fichier ressemble \u00e0 ca: \r\n```yaml\r\n--- !pf.SnufflerConfig\r\nvisible_length_setting:\r\n- - Court\r\n - 20000.0\r\n- - Moyen\r\n - 60000.0\r\n- - Long\r\n - 120000.0\r\n- - Extra Long\r\n - 600000.0\r\nphase_key_mapping:\r\n F1: P-Pdif\r\n F2: PKP\r\n F3: PP\r\n F4: SKS\r\n F5: S-SKKS\r\n F6: SP\r\n F7: SS\r\n F8: LOVE\r\n F9: RAYL\r\ndemean: true\r\nshow_scale_ranges: false\r\nshow_scale_axes: false\r\ntrace_scale: individual_scale\r\nshow_boxes: true\r\nclip_traces: true\r\nfirst_start: false\r\nstation: None\r\npath_hodochrones: /home/vsc/depu/HODOCHRONES/\r\npath_save_depu: /home/vsc/depu/Pointes/\r\npath_donnees_quant: /home/vsc/depu/Donnees_Quant/\r\n```\r\n\r\n## Lancement de l'outil\r\n\r\nN'importe o\u00f9 sur le syst\u00e8me:\r\n```bash\r\n> snuffler\r\n```\r\n\r\n## Import de fichier\r\nL'outil est capable de g\u00e9rer diff\u00e9rents types de fichiers: LH, BH, HH, miniseed, ... \r\nVous pouvez importer de nouveaux fichiers par glisser-d\u00e9poser depuis un explorateur ou par le bouton \"Ouvrir des fichiers\" dans l'onglet EOST - Hodochrones.\r\n\r\n## Pointer un s\u00e9isme\r\n\r\n### Cr\u00e9er un marqueur de phase\r\nEn double cliquant sur une des voies de votre sismogramme, un marqueur flottant apparait. \r\nVous pouvez le d\u00e9placer jusqu'\u00e0 lui affecter une valeur fixe.\r\n\r\n### Supprimer un marqueur\r\nS\u00e9lectionnez un marqueur par un simple `Clic-Gauche`, utilisez la touche `Retour arri\u00e8re` (Backspace) pour supprimer le marqueur. \r\nEn maintenant la touche `Shift`, vous pouvez s\u00e9lectionner plusieurs marqueurs pour faire une grosse suppression d'un coup. \r\nLe touche `A` vous permet de s\u00e9lectionner tous les marqueurs.\r\n\r\n### Affecter un type \u00e0 un marqueur\r\nLes types sont d\u00e9finis dans le fichier de configuration `$HOME/.pyrockoeost/snuffler.pf` , vous pouvez modifier les raccourcis clavier attribu\u00e9s depuis ce fichier de configuration. \r\nPar d\u00e9faut, les valeurs attribu\u00e9es sont les suivantes:\r\n\r\n|Touche| Phase |\r\n|-----|--------|\r\n| F1 | P-Pdif |\r\n| F2 | PKP |\r\n| F3 | PP |\r\n| F4 | S-SKKS |\r\n| F5 | SKS |\r\n| F6 | SP |\r\n| F7 | SS |\r\n| F8 | LOVE |\r\n| F9 | RAYL |\r\n\r\n### D\u00e9placer un marqueur\r\nIl suffit de s\u00e9lectionner marqueur (`clic gauche`), et d'utiliser les touches directionnelles (fl\u00e8che de droite / gauche) puis valider avec `Entr\u00e9e`.\r\nPour acc\u00e9l\u00e9rer le d\u00e9placement, vous pouvez maintenir la touche `Shift` enfonc\u00e9e.\r\n\r\n### Changer la couleur d'un marqueur\r\nLa couleur des marqueurs est utilis\u00e9e pour en d\u00e9finir le r\u00f4le: \r\n- Un marqueur rouge vient d'\u00eatre ajout\u00e9\r\n- Un marqueur bleu servira de r\u00e9f\u00e9rence pour le prochain calcul d'hodochrone\r\n- Un marqueur jaune a \u00e9t\u00e9 ajout\u00e9 par un calcul d'hodochrone et sera supprim\u00e9 par la fonction \"Supprimer Les Hodochrones\"\r\n\r\nVous pouvez \u00e9diter le type d'un marqueur avec les chiffres: \r\n\r\n|Chiffre| Couleur | Utilit\u00e9 |Sauvegarder|\r\n|-------|---------|---------|-----------|\r\n| 0 | Rouge | Par d\u00e9faut |OUI|\r\n| 1 | Vert | |OUI|\r\n| 2 | Bleu | Phase de r\u00e9f\u00e9rence pour le calcul d'hodochrones |OUI|\r\n| 3 | Jaune | Phase calcul\u00e9e par la m\u00e9thode hodochrones |NON|\r\n| 4 | Violet | |OUI|\r\n| 5 | Marron | |OUI|\r\n\r\n## Sauvegarder un point\u00e9\r\nToutes les phases autres que Jaune seront sauvegard\u00e9es. Changez leurs couleurs si n\u00e9cessaire. \r\nUne fois vos phases pr\u00eates, appuyez sur **Sauvegarder les phases** ( v\u00e9rifiez que l'emplacement de sortie a bien \u00e9t\u00e9 d\u00e9fini dans la configuration : Fichier *snuffler.pf* ). \r\nOn vous demandera ensuite si vous voulez ajouter les donn\u00e9es \u00e0 la suite ou remplacer le fichier s'il existe d\u00e9j\u00e0.\r\n\r\n## Contr\u00f4les\r\nTous les contr\u00f4les sont disponibles dans l'onglet d'aide ou en appuyant sur la touche `?`.\r\n\r\n## Origine\r\n[Official Link Pyrocko](https://pyrocko.org/)\r\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "A versatile seismology toolkit for Python.",
"version": "2023.9",
"project_urls": {
"changelog": "https://git.pyrocko.org/pyrocko/pyrocko/src/branch/master/CHANGELOG.md",
"documentation": "https://pyrocko.org/docs",
"homepage": "https://pyrocko.org",
"repository": "https://git.pyrocko.org"
},
"split_keywords": [
"seismology",
"waveform analysis",
"earthquake modelling",
"geophysics",
"geophysical inversion"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "193938f29c5186fd00088f90e232fe04f440f8eb85d552dd6262427b33ddce38",
"md5": "daeb2a2811199f3753f206a31e342aa5",
"sha256": "83abe2fdb197e3eaf87b0b74d9b04cdea343e0a76b6a9da67920e4b5b79778df"
},
"downloads": -1,
"filename": "pyrockoeost-2023.9-cp310-cp310-win_amd64.whl",
"has_sig": false,
"md5_digest": "daeb2a2811199f3753f206a31e342aa5",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": ">=3.7",
"size": 1422732,
"upload_time": "2023-10-15T13:37:36",
"upload_time_iso_8601": "2023-10-15T13:37:36.499163Z",
"url": "https://files.pythonhosted.org/packages/19/39/38f29c5186fd00088f90e232fe04f440f8eb85d552dd6262427b33ddce38/pyrockoeost-2023.9-cp310-cp310-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "acbf57f382f98f504226c56e86d2a5cbfb0e978f94d2a0c4b1794643059b4d69",
"md5": "a2332d7cf04f3ede6165b504de988165",
"sha256": "f52d0211be2db70501169ce47dbf04d12a0a15dc9d9502c51e4b82ff179f181a"
},
"downloads": -1,
"filename": "pyrockoeost-2023.9-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "a2332d7cf04f3ede6165b504de988165",
"packagetype": "bdist_wheel",
"python_version": "cp39",
"requires_python": ">=3.7",
"size": 2049366,
"upload_time": "2023-10-15T13:37:38",
"upload_time_iso_8601": "2023-10-15T13:37:38.633967Z",
"url": "https://files.pythonhosted.org/packages/ac/bf/57f382f98f504226c56e86d2a5cbfb0e978f94d2a0c4b1794643059b4d69/pyrockoeost-2023.9-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d1915ba964e4288e52fb8cfa0386b905fd3bd834fa48bfcdca6f9fc9c09a95b5",
"md5": "0fe9ae731998c232773c72e3cb2ad02e",
"sha256": "79c631d5db38570f6681d4cb1410fe608897d6412d92e58fa512f15ad3b1c6ff"
},
"downloads": -1,
"filename": "pyrockoeost-2023.9.tar.gz",
"has_sig": false,
"md5_digest": "0fe9ae731998c232773c72e3cb2ad02e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 2070649,
"upload_time": "2023-10-15T13:37:40",
"upload_time_iso_8601": "2023-10-15T13:37:40.647632Z",
"url": "https://files.pythonhosted.org/packages/d1/91/5ba964e4288e52fb8cfa0386b905fd3bd834fa48bfcdca6f9fc9c09a95b5/pyrockoeost-2023.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-15 13:37:40",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "pyrockoeost"
}