GrafSPS

Programa con interfaz gráfica PyQt5 basado en scripts en lenguaje C-Shell y Bash con el objetivo de graficar mapas de sismicidad y perfiles sísmicos principalmente para Perú utilizando GMT4 (Generic Mapping Tools).

Nota: Los scripts fueron creados tomando como base el trabajo de César Jiménez y Cristobal Condori.

CONTENIDO

• VISIÓN GENERAL
• IMÁGENES PRINCIPALES
• RECOMENDACIONES
• REQUISITOS MÍNIMOS
• ¿CÓMO DESCARGAR?
• ¿CÓMO EJECUTAR?
• NOTAS IMPORTANTES
• RECURSOS EXTERNOS
• RECONOCIMIENTO
• LISTA DE CAMBIOS

VISIÓN GENERAL

GrafSPS permite realizar principalmente lo siguiente (en la región de Perú):

• Graficar un mapa de sismicidad sin topografía, con topografía simple y con topografía compleja (gradiente).
• Seleccionar el archivo de topografía-batimetría y gradiente (GRD/NC).
• Variar las coordenadas del mapa.
• Crear la línea de proyección del perfil y su región rectangular para 3 localizaciones distintas en función de parámetros iniciales.
• Crear perfiles sísmicos de profundidad en función de la región rectangular generada con una proyección de la topografía-batimetría.

GrafSPS permite obtener los siguientes archivos de salida:

1. sismicidad.eps: Mapa de sismicidad
2. sismicidad_perfil.eps: Mapa de sismicidad con las regiones rectangulares y la línea de perfil.
3. perfil_sismicidad_VARIABLE.eps: Perfil sísmico de profundidad. Donde VARIABLE toma el nombre de "norte", "centro" o "sur".

IMÁGENES PRINCIPALES

RECOMENDACIONES

• Utilizar el catálogo sísmico del NEIC (en formato CSV) y reemplazar las comas (',') por espacios (' ') antes de ingresarlo a GrafSPS.
• De utilizar otro catálogo, el usuario puede asignarle el formato del NEIC o modificar los scripts bash/shell para la correcta interpretación.
• Utilizar una distribución de GNU/Linux con escritorio KDE Plasma 5.12 o superior.

REQUISITOS MÍNIMOS

• GMT4 o GMT6
• sh & csh
• gawk
• ps2eps
• evince
• python3
• python3-pyqt5

¿CÓMO DESCARGAR?

Para obtener la última versión estable, descargue desde la pestaña [Releases]. Para obtener la última versión dev, descargue desde el botón [Code] o ejecute en un terminal:

git clone https://github.com/nestor-ld93/GrafSPS

¿CÓMO EJECUTAR?

1. Descargar un catálogo sísmico del NEIC en formato CSV. Posteriormente, modificarlo para reemplazar las comas (',') por espacios (' ').
2. Ejecutar en un terminal: ./Launcher.py. Una vez abierta la interfaz gráfica, ingresar a la pestaña "Sismicidad".
3. Seleccionar el archivo del catálogo sísmico (CSV) y la carpeta contenedora de los datos de contorno (ASCCI).
4. Desplegar la opción "2) Parámetros de personalización".
5. Modificar los parámetros a su preferencia. Al seleccionar el tipo de topografía, si selecciona la opción "Simple" o "Gradiente", desplegar la opción "1) Archivos externos" para agregar los archivos GRD/NC necesarios.
6. Clic en "Graficar Sismicidad". Inmediatamente debería visualizar el mapa de sismicidad.
7. Ingresar a la pestaña "Perfiles sísmicos".
8. Modificar los parámetros iniciales para generar las coordenadas de la región rectangular y la línea de perfil.
9. Clic en "Generar coordenadas".
10. Clic en "Graficar sismicidad con rectángulos". Si el resultado de las regiones rectangulares no son los deseados, puede volver a modificar los parámetros iniciales (no olvidar dar clic en "Generar coordenadas" y en "Graficar sismicidad con rectángulos" al momento de realizar la modificación).
11. Seleccionar un archivo de topografía-batimetría (GRD/NC) para realizar la proyección sobre la línea de perfil generada.
12. Seleccionar la región a graficar ("Norte", "Centro" o "Sur") y otras opciones adicionales.
13. Clic en "Graficar Perfil Sísmico".

NOTAS IMPORTANTES

1. Se utiliza por defecto GMT6.
2. Para utilizar GMT4, ingrese a la carpeta Scripts_templates, copie y renombre los archivos 1_sismicidad_gmt4.csh, 3_sismicidad_perfil_gmt4.csh y 4_perfil_sismico_gmt4.csh al directorio principal para reemplazar los archivos por defecto.
3. En cada inicio del programa es obligatorio seleccionar los archivos CSV y GRD/NC además de la carpeta contenedora de los datos de contorno. Pero, si el usuario lo desea, puede ingresar al archivo "Launcher.py" (con cualquier editor de texto) y modificar estas opciones para que se guarden por defecto.
4. Por defecto, los archivos EPS se ejecutan en "Evince". El usuario puede cambiar este lector por el de su preferencia modificando las últimas lineas de los archivos bash/shell.
5. Muchos de los botones no se encuentran desactivados, por lo que si se realiza un procedimiento inadecuado el programa no realizará acción alguna. Para conocer el procedimiento adecuado, revisar la sección "¿CÓMO EJECUTAR?".
6. Se proporciona GrafSPS con la carpeta "Datos_contornos" (contiene los rasgos tectónicos para Perú).
7. No se proporciona los datos de topografía-batimetría. El usuario deberá conseguirlos de fuentes oficiales.
8. Mientras más grande sean los archivos GRD/NC, mayor será el tiempo computacional para generar los mapas y los perfiles (Este no es un problema de GrafSPS). Para solventarlo, el usuario puede recortar el archivo de topografía-batimetría para una región de interés usando herramientas externas.
9. Los parámetros del mapa de sismicidad con las regiones rectangulares son dependientes de las pestaña "Sismicidad".
10. En distribuciones basadas en el escritorio KDE Plasma, GrafSPS se adapta al esquema de colores seleccionado por el SO.

RECURSOS EXTERNOS

1. "GMT4 y documentación oficial de instalación"
2. "GMT4 instalación semi-desatendida"
3. "GMT6 y documentación oficial de instalación"
4. "Catálogo sísmico del NEIC"
5. "Topografía - ETOPO1 Global Relief Model"
6. "Batimetría - GEBCO The General Bathymetric Chart of the Oceans"

RECONOCIMIENTO

GMT relies on several other Open Source software libraries, programs and data for its operation. We gratefully acknowledge the importance to GMT of these products. GMT may be linked with these libraries (* means optional):

Network Common Data Form (netCDF), Geospatial Data Abstraction Library (GDAL*), Perl Compatible Regular Expressions (PCRE*), Fastest Fourier Transform in the West (FFTW*), Linear Algebra Package (LAPACK*), Basic Linear Algebra Subprograms (BLAS*), GLIB*, and ZLIB*. GMT may call these executables: GDAL (ogr2ogr, gdal_translate), Ghostscript, FFmpeg, xdg-open, and GraphicsMagick.

GMT uses (or can access) data derived from these sources:

• Scientific Color Maps (CPT)
• Earth 15" DEM
• Earth 1" SRTM DEM
• Earth 1' crustal age
• Earth 30" Blue Marble images
• Earth 30" Black Marble images

LISTA DE CAMBIOS

Todos los cambios notables de este proyecto se encuentran en Changelog.