subsurface/Documentation/user-manual_es.txt

// Subsurface 4.5 User Manual
// ==========================
// :author: Manual authors: Jacco van Koll, Dirk Hohndel, Reinout Hoornweg,
// Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Willem
// Ferguson, Salvador Cuñat, Pedro Neves
// :revnumber: 4.6
// :revdate: January 2017
:icons:
:toc2:
:toc-placement: manual
:numbered:
:ascii-ids:
// :website: http://subsurface-divelog.org

image::images/Subsurface4Banner.jpg["Banner",align="center"]

[big]#MANUAL DE USUARIO#

*Autores*: Willem Ferguson, Jacco van Koll, Dirk Hohndel, Reinout Hoornweg,
Linus Torvalds, Miika Turkia, Amit Chaudhuri, Jan Schubert, Salvador Cuñat,
Pedro Neves

[BLUE]#_Versión 4.6, Enero 2017_#

Bienvenido como usuario de _Subsurface_, un avanzado programa de registro de
inmersiones con extensa infraestructura para describir, organizar e
interpretar buceos en apnea o con botella. _Subsurface_ ofrece muchas ventajas
sobre otras soluciones de software similares:

- ¿Necesitas una forma flexible de registrar inmersiones usando equipo
recreativo, incluso aunque no uses ordenador?
- ¿Deseas incluir posiciones GPS en tu divelog sin tener problemas?
- ¿Utilizas dos ordenadores de buceo diferentes, cada uno con su software
propietario para descargar los diarios de buceo? ¿Buceas con reciclador y con
circuito abierto o equipo recreativo? ¿Usas un bottom-timer junto a un ordenador
de buceo? _Subsurface_ ofrece una interfaz estándar para descargar diarios de
buceo desde todas estas piezas de equipo y para almacenarlos y analizarlos en un
sistema unificado.
- ¿Usas más de un sistema operativo? _Subsurface_ es totalmente compatible con
Mac, Linux y Windows permitiéndote acceder a tu registro de buceo de de la
misma forma desde cualquiera de estos sistemas operativos.
- ¿Utilizas Linux o Mac pero tu ordenador de buceo solo tiene software basado en
Windows para descargar la información de buceo (p.e. Mares)? _Subsurface_ te
proporciona una manera de almacenar y analizar las inmersiones en otro sistema
operativo.
- ¿Necesitas un planificador de inmersiones gráfico que sea intuitivo, tenga
en cuenta las inmersiones ya guardadas y se integre con ellas?
- ¿Necesitas una forma de guardar tus divelogs en internet, que te permita
visualizarlo desde cualquier parte, simplemente usando un navegador web?
- ¿Quieres acceder a tu divelog o modificarlo usando usando un teléfono móvil?

Hay binarios disponibles para PCs con Windows (XP o posterior), Macs basados en
Intel (OS/X) y muchas distribuciones de Linux. _Subsurface_ puede compilarse
para muchas otras plataformas de hardware y entornos de software en los que
estén disponibles Qt y libdivecomputer.

Este manual explica como utilizar el programa _Subsurface_. Para instalar
el software, consulta la página Descargas en http://subsurface-divelog.org/[la
web]. Por favor, comenta los problemas que tengas con este programa enviando un
mail a mailto:subsurface@subsurface-divelog.org[nuestra lista de correo] e informa de
fallos en https://github.com/Subsurface-divelog/subsurface/issues[nuestro bugtracker].
Para instrucciones acerca de como compilar el software y (en caso necesario)
sus dependencias, por favor, consulta el archivo INSTALL incluido con el código
fuente.

*Audiencia*: Buceadores recreativos, Buceadores en apnea, Buceadores técnicos,
Buceadores profesionales.

toc::[]

Utilizar este manual
--------------------
Cuando se abre desde dentro de _Subsurface_ este manual no tiene controles
externos para paginar o seleccionar páginas anteriores, sin embargo se
proporcionan dos utilidades:

- La función _BUSCAR_ se activa pulsando control-F o command-F en el teclado.
Aparecerá una ventana de texto al pié de la ventana (ver imagen a continuación).
Por ejemplo, si se tecleó la palabra "_lastre_" en la casilla de búsqueda, se
buscará esta palabra por todo el manual. A la derecha de la casilla de texto
hay dos flechas, una hacia arriba y otra hacia abajo. Pulsándolas se irá a la
anterior o posterior aparición de la palabra buscada.

image::images/UserManualSearch.jpg["User manual functions",align="center"]

- _LINK ANTERIOR/POSTERIOR_. Se puede navegar entre links (palabras resaltadas
que permiten saltar a secciones específicas del manual) haciendo clic-derecho
en el texto. Esto muestra un menú contextual que permite navegar a links
del manual visitados anteriormente (ver imagen a continuación). Por ejemplo, si se
ha seleccionado un link del manual, la opción _Atrás_ muestra el texto del
último link seleccionado. A la inversa, la opción _Adelante_ permite saltar
al texto visitado antes de usar la opción _Atrás_. La opción _Recargar_ hace
que se recargue el manual completo en la ventana.

image::images/UserManualLinksBack.jpg["User manual functions",align="center"]

[[S_UserSurvey]]
La Encuesta de Usuarios
-----------------------
Para poder desarrollar _Subsurface_ de una forma que sirva a sus usuarios de la
mejor manera posible, es importante tener alguna información de los mismos.  Al
abrir _Subsurface_ tras haberlo usado una semana más o menos,
se desplegará una encuesta al usuario. Es completamente opcional y el usuario
controla que datos se enviarán al equipo de desarrollo de _Subsurface_, si es
que se envía alguno. Cualquier dato que el usuario decida enviar será
extremadamente útil, y solo se usará para dirigir el desarrollo futuro y
personalizar el software a medida de los usuarios de _Subsurface_. Si se
completa la encuesta o se hace clic en la opción "No preguntarme de nuevo, será
la última comunicación de esta naturaleza que se reciba. Sin embargo, si cambian
nuestros hábitos o los de  _Subsurface_ y se desea volver a enviar la encuesta,
se puede hacer lanzando _Subsurface_ desde la línea de comandos con la opción
--survey.

[[S_StartUsing]]
Empezar a usar el programa
--------------------------

La ventana _Subsurface_ está, habitualmente, dividida en cuatro paneles con un
*Menú principal* (Archivo Importar Registro Vista Ayuda) en la parte superior
(en Windows y Linux) o en la parte superior de la pantalla (en Mac y Ubuntu
Unity). Los cuatro paneles son:

1. La *Lista de inmersiones* abajo a la izquierda, muestra una lista de todos
los buceos de tu registro. Puedes seleccionar y resaltar una inmersión de la
lista haciendo clic sobre ella. En casi todos los casos también se pueden
utilizar las teclas de cursor arriba/abajo para cambiar de inmersión. La Lista
de Inmersiones es una herramienta importante para manipular un diario de
inmersiones.

2. El *Mapa* abajo a la derecha, muestra los lugares de buceo del usuario en un
mapamundi y aparece centrado en el punto de la última inmersión seleccionada de
la *Lista de Inmersiones*. El mapa puede hacerse más grande o más pequeño.

3. La *Información* arriba a la izquierda, presentando
información más detallada de la inmersión seleccionada en la *Lista de
inmersiones*, incluyendo algunas estadísticas de la inmersión seleccionada o de
todas las inmersiones resaltadas.

4. El *Perfil de la inmersión* arriba a la derecha, muestra un perfil gráfico
del buceo seleccionado en la *Lista de inmersiones*. Se puede hacer zoom en el
perfil para obtener una visión mas detallada.

Los divisores que hay entre los paneles pueden arrastrarse para modificar el
tamaño de cualquiera de ellos. _Subsurface_ recuerda la posición de los
divisores, así, la próxima vez que se inicie _Subsurface_ utiliza las posiciones
utilizadas la vez anterior.

Si se selecciona una única inmersión en la *Lista de inmersiones*, se muestra su
ubicación, información detallada y su perfil en sus paneles respectivos. Por
otra parte, si uno selecciona más de un buceo, el último resaltado actuará como
_inmersión seleccionada_, pero los datos resumidos de las _inmersiones
resaltadas_ se mostrarán en la pestaña *Estadísticas* del panel *Información*
(máximas, mínimas y medias de profundidades, duraciones,
temperaturas del agua, consumos de gases; el tiempo total y el número de
inmersiones seleccionadas).

[[S_ViewPanels]]

image::images/main_window_f22.jpg["La ventana principal",align="center"]


El usuario puede elegir cual de los cuatro paneles se mostrará seleccionando la
opción *Vista* en el menú principa1. Esta selección presentará varias opciones
de visualización:

*Todo*: muestra los cuatro paneles como en la captura de pantalla de arriba.

*Lista de inmersiones*: Solo muestra la lista de buceos.

*Perfil*: Muestra solo el perfil de inmersión del buceo seleccionado.

*Info*: Solo muestra las notas sobre la última inmersión seleccionada y
estadísticas para todas las resaltadas.

*Globo*: Solo muestra el mapamundi centrado en la última inmersión seleccionada.


Como muchas otras funciones que pueden accederse desde el Menú Principal, estas
opciones también pueden lanzarse utilizando atajos de teclado. Los atajos para
un sistema en particular se muestran con un subrallado en las entradas del menú.
Puesto que los diferentes Sistemas Operativos y el lenguaje seleccionado por el
usuario pueden hacer que _Subsurface_ utilice diferentes atajos, no intentaremos
listarlos en este manual.

Al iniciar el programa por primera vez no muestra ninguna información. Esto se
debe a que el programa no tiene ninguna información disponible. En las secciones
siguientes se describirán los procedimientos para crear un nuevo registro.

[[S_NewLogbook]]
Crear un nuevo diario
---------------------
Selecciona _Archivo → Nuevo Registro_ en el menú principal. Todos los datos de
buceo existentes se borran para poder añadir nueva información. Si hubieran
datos no guardados en un diario abierto, al usuario se le preguntará si desea
guardar el diario abierto antes de crear uno nuevo.

[[S_GetInformation]]
== Guardar información en el diario de buceo

Ahora que se ha creado un nuevo diario, es simple añadirle datos de buceo.
_Subsurface_ permite varias maneras distintas de añadir información a un diario,
todas las cuales las veremos en detalle en las secciones
siguientes.

1) Si el usuario tiene un diario en papel, una hoja de cálculo u otra
forma de diario manual, se pueden añadir los datos de una de estas formas:

 - Introducir la información de buceo a mano. Esto es útil si el buceador no
usa un ordenador de buceo y las inmersiones se guardaban en un diario
escrito.  Ver xref:S_EnterData[Introducir información de buceo a mano].

 - Importar datos de buceo que se han guardado bien como hoja de cálculo o
bien como un archivo CSV. Ver el xref:S_Appendix_D[APÉNDICE D: Exportar una
hoja de cálculo a formato CSV] y el texto
xref:S_ImportingCSVDives[Importar buceos de archivos _CSV_ creados a mano].

2) Si el usuario ya tiene inmersiones registradas con un ordenador de buceo,
el perfil de profundidad del buceo y otra gran cantidad de información ya está
disponible.Estas inmersiones pueden importarse de las siguientes formas:

 - El propio ordenador de buceo. Ver xref:S_ImportDiveComputer[Importar nueva información desde un ordenador de buceo])

 - Software propietario distribuido por los fabricantes de los ordenadores de
 buceo.
 Ver xref:S_ImportingAlienDiveLogs[Importar información de inmersiones de otras fuentes u otros formatos de datos].

 - Hojas de cálculo o archivos CSV que contienen perfiles de inmersión.
   Ver xref:S_ImportingCSVDives[Importar inmersiones en formato CSV desde ordenadores u otro software de buceo]

[[S_EnterData]]
=== Introducir información de buceo a mano

Este es habitualmente el caso para inmersiones sin ordenador de buceo. La unidad
básica de información en _Subsurface_ es una inmersión. La información más
importante en un diario de inmersiones incluye, habitualmente, el tipo de
inmersión, fecha, hora, duración, profundidad, los nombres de los compañeros de
buceo o el divemaster o el guía, y algunas anotaciones acerca de la inmersión.
_Subsurface_ puede conservar mucha más información por cada inmersión. Para
añadir una inmersión a un registro de buceo, selecciona _Registro → Añadir
Inmersión_ en el menú principal. El programa muestra entonces tres paneles para
introducir información: Dos pestañas en el panel *Información*
(*Notas* y *Equipo*), así como el panel perfil que muestra un
perfil gráfico de cada buceo. Estos paneles están marcados respectivamente como
[red]#A#, [red]#B# y [red]#C# en la figura de abajo. Ahora veremos cada una de
las pestañas usadas para introducir la información.

image::images/AddDive1_f22.jpg["FIGURA: Añadir inmersión",align="center"]

Al editar un campo de los paneles _Notas_ o _Equipo_, _Subsurface_
entra en el modo de edición. Esto se indica con el mensaje en un recuadro azul
en la parte de arriba del panel *Notas*. Este mensaje se
muestra en todos los paneles dependientes de _Notas_ mientras
se esté en modo de edición.

image::images/BlueEditBar_f22.jpg["Blue edit bar",align="center"]

El botón _Aplicar cambios_ solo debería utilizarse cuando todas las partes de la
inmersión hayan sido rellenadas. Cuando se introduzcan inmersiones a mano,
deberían haberse completado las pestañas _Información_, _Equipo_ y _Perfil_
antes de guardar la información. Al seleccionar el botón _Aplicar cambios_, se guarda
en memoria una copia local de la información, pero no se escribe en el disco.
Al salir de _Subsurface_, el programa preguntará de nuevo, esta vez si se
guarda el diario completo en el disco o no.

[[S_CreateProfile]]
==== Crear un perfil de inmersión

EL *Perfil de la Inmersión* (una representación gráfica de la profundidad de
buceo en función del tiempo) se muestra en el panel de arriba a la derecha de la
ventana de _Subsurface_ . Cuando se añade manualmente una inmersión a un diario,
_Subsurface_ presenta un perfil por defecto que necesita modificarse para
representar mejor el buceo que se está describiendo.

image::images/DiveProfile1_f20.jpg["FIGURA: Perfil de inmersión inicial",align="center"]

_Modificar el perfil de la inmersión_: Cuando se mueve el cursor por el perfil,
su posición se indica por dos líneas de colores (roja y verde), como se muestra
a continuación. La profundidad y el tiempo se indican en el cajetín negro de
información. Las
unidades (métricas/imperiales) de los ejes vienen determinadas por los ajustes
de las Preferencias. El perfil de la inmersión comprende varios segmentos
definidos por puntos de referencia (puntos en blanco en el perfil, como los que
se muestran arriba). La profundidad por defecto es de 15m.
Si la profundidad de la inmersión fue de 20m, el usuario tiene que arrastrar los
puntos de referencia adecuados hacia abajo hasta que representen los 20m. Para
añadir un punto hay que hacer doble clic en cualquier segmento. Para borrar un
punto de referencia, hacer clic-derecho sobre él y seleccionar "Borrar este
punto" del menú contextual. También se necesitará arrastrar los puntos para
representar una duración adecuada del buceo. A continuación hay un perfil de
inmersión que representa un buceo a 20m durante 30 minutos, seguido de una
parada de seguridad de 5 minutos a 5m.

image::images/DiveProfile2_f20.jpg["FIGURA: Perfil de buceo editado",align="center"]


_Especificar la composición del gas_: La composición del gas usado se indica
claramente a lo largo de los segmentos del perfil. Esta resulta, por defecto, en
la primera mezcla de gases especificada en la pestaña *Equipo*, que era aire en
el caso del perfil ilustrado arriba. Las mezclas de gases de los segmentos del
perfil pueden editarse, Esto se hace clicando en la descripción del gas para un
punto de referencia concreto y eligiendo la mezcla apropiada del menú
contextual. Cambiar el gas de un punto de referencia afecta al gas mostrado a la
izquierda _a la izquierda_ del punto. Nótese que únicamente los gases definidos
en la pestaña *Equipo* aparecen en el menú contextual (ver imagen a continuación).

image::images/DiveProfile3_f20.jpg["FIGURA: Menú contextual de la composición del gas",align="center"]

Habiendo sido definido el perfil, se deben añadir más detalles para tener un
registro más completo del buceo. Para hacer esto, deberían utilizarse las
pestañas *Notas* y *Equipo* arriba a la izquierda en la ventana de _Subsurface_.
Haz clic en xref:S_Notes_dc[*este enlace*] para ver instrucciones acerca del
uso de estas pestañas.

[[S_ImportDiveComputer]]
=== Importar nueva información desde un ordenador de buceo

==== Conectar e importar datos desde un ordenador de buceo.

El uso de ordenadores de buceo permite recoger una gran cantidad de información
de cada inmersión, por ejemplo un registro detallado de la profundidad,
duración, ratios de ascenso/descenso y de presiones parciales de los gases.
_Subsurface_ puede capturar esta información y presentarla como parte de la
información de la inmersión. _Subsurface_ puede obtener información de un amplio
abanico de ordenadores de buceo, la última lista de los cuales puede encontrarse
en:
link:http://subsurface-divelog.org/documentation/supported-dive-computers/[Ordenadores de buceo soportados.]

[icon="images/icons/warning2.png"]
[WARNING]
Algunos ordenadores de buceo consumen más energía cuando están en modo
comunicación-PC. **Esto puede descargar la batería del ordenador de buceo**. Así
pues, recomendamos que el usuario verifique si su ordenador está recargando
mientras está conectado al puerto USB de un PC. Por ejemplo, varios ordenadores
Suunto y Mares no recargan a través de de la conexión USB. Los usuarios deberían
consultar el manual de su ordenador de buceo si no están seguros de si recargará
o descargará sus baterías mientras está conectado al puerto USB.

Para importar información desde un ordenador de buceo al PC con _Subsurface_ es
necesario que ambas piezas de equipo estén comunicadas. Esto requiere ajustar el
puerto de comunicaciones (o el punto de montaje) del PC con _Subsurface_ que
conecta con el ordenador de buceo. Para poder ajustar esta comunicación, es
necesario encontrar la información adecuada para indicar a _Subsurface_ donde y
como importar la información. El
xref:_apendice_a_informacion_especifica_del_sistema_operativo_para_importar_inmersiones_desde_un_ordenador_de_buceo[Apéndice A]
proporciona información técnica para ayudarte a conseguir esto en diferentes
sistemas operativos y el
xref:_appendix_b_dive_computer_specific_information_for_importing_dive_information[Apéndice B]
contiene información específica de ordenadores de buceo.

Ahora es el momento de conectar el ordenador de buceo al PC del usuario, para
lo que hay que seguir estos pasos:

1. Conectar el cable de conexión a un puerto USB libre (o activar la conexión
   infrarroja o bluetooth como describiremos más adelante en este manual).

2. Poner el ordenador de buceo en modo de comunicación con PC. Consulta el
   manual de tu ordenador de buceo en concreto.

3. En _Subsurface_, desde el Menú principal, seleccionar Importar → Importar del
   ordenador de buceo. Aparecerá el diálogo *A* en la figura a continuación:

image::images/DC_import_f20.jpg["FIGURA: Diálogo de descarga 1",align="center"]

Los ordenadores de buceo tienden a mantener un cierto número de inmersiones en
su memoria, incluso cuando estas inmersiones ya han sido importadas a
_Subsurface_. Por este motivo _Subsurface_ solo importa buceos que no han sido
descargados previamente, si el ordenador de buceo lo permite. Esto hace que el
proceso de descarga sea más rápido en la mayoría de ordenadores de buceo y
ahorra batería en el ordenador (por lo menos en aquellos que no cargan mientras
están conectados vía USB).

 - El diálogo tiene dos listas desplegables, *Vendedor* y *Ordenador de buceo*.
   En la lista desplegable *Vendedor* se selecciona la marca del ordenador, p.e.
   Suunto, Oceanic, Uwatec, Mares. En el desplegable *Ordenador de buceo*, se
   selecciona el modelo del ordenador, p.e. D4 (Suunto), Veo200 (Oceanic) o Puck
   (Mares).

 - El desplegable *Dispositivo o punto de montaje* contiene el nombre del puerto
   USB o Bluetooth que _Subsurface_ necesita conocer para comunicarse con el
   ordenador de buceo. Debe seleccionarse el nombre de puerto apropiado. Consultar
   el
   xref:_apendice_a_informacion_especifica_del_sistema_operativo_para_importar_inmersiones_desde_un_ordenador_de_buceo[Apéndice A]
   y xref:_appendix_b_dive_computer_specific_information_for_importing_dive_information[Apéndice B]
   para detalles técnicos de como encontrar la información apropiada sobre
   puertos, para un ordenador en concreto y, en algunos casos, como hacer los
   ajustes correctos al Sistema Operativo del ordenador que ejecuta _Subsurface_.

 - Si todas las inmersiones del ordenador de buceo han de descargarse, hay que
   seleccionar la casilla Forzar descarga de todas las inmersiones. Normalmente
   _Subsurface_ solo descarga las inmersiones posteriores a la fecha/hora de la
   última inmersión del panel *Lista de inmersiones*. Si una o más de sus
   inmersiones en _Subsurface_ se han borrado accidentalmente o si hay buceos más
   antiguos que todavía necesitan descargarse del ordenador de buceo, debe
   activarse esta casilla. Algunos ordenadores (p.e. Mares Puck) no facilitan una
   lista de contenido antes de la descarga para poder seleccionar solo las
   inmersiones nuevas. En consecuencia, para estos ordenadores de buceo, se
   descarga la totalidad de los buceos.

 - Si se ha seleccionado la casilla _Preferir siempre inmersiones descargadas_ y,
   durante la descarga, existen inmersiones con idénticas fechas/horas en el
   ordenador de buceo y en el panel *Lista de inmersiones* de _Subsurface_ , se
   sobrescribirá la inmersión de _Subsurface_ con los datos del ordenador de buceo.

 - *NO* seleccionar las casillas etiquetadas _Guardar registro de
   libdivecomputer_ y _Guardar volcado de libdivecomputer_. Estas opciones se
   utilizan como herramientas diagnósticas cuando se experimentan problemas con las
   descargas (ver a continuación).

 - Ahora pulsar el botón _Descargar_.
   Con la comunicación establecida puede verse como se transfiere la información
   del ordenador de buceo. Dependiendo del ordenador de buceo y/o el número de
   inmersiones guardadas, esto podría llevar algún tiempo. El usuario debe ser
   paciente. El diálogo _Descarga_ muestra una barra de progreso en la parte
   inferior de la ventana (en algunos ordenadores de buceo la información del
   progreso puede ser imprecisa al no poder determinarse cuantos datos había hasta
   haberse descargado). Las inmersiones descargadas aparecen en una tabla en el
   lado derecho del diálogo. Cada inmersión se sitúa en una fila en la que se
   muestra la fecha, la duración y la profundidad. Junto a cada buceo hay una
   casilla seleccionable. Marca todas las inmersiones que deban trasladarse a la
   _Lista de Inmersiones_. Luego pulsa el botón _Aceptar_ en la parte de abajo
   del diálogo. En el caso de la imagen anterior, las últimas seis inmersiones
   han sido seleccionadas y se transferirán a la lista. Todas las inmersiones
   importadas aparecen en la *Lista de inmersiones*
   ordenadas por fecha y hora. Es el momento de desconectar y apagar el ordenador
   de buceo para ahorrar batería.

 - Si hubiera algún problema de comunicación con el ordenador de buceo, se
   mostraría un mensaje de error similar a este: "No puedo abrir /dev/ttyUSB0 Mares
   (Puck Pro)". Ver el texto en la figura a continuación.


****
*PROBLEMAS EN LA DESCARGA DE DATOS DESDE UN ORDENADOR DE BUCEO*
[icon="images/icons/important.png"]
[IMPORTANT]
Comprueba lo siguiente:

 - ¿ Está el ordenador de buceo todavía en modo "PC-Communication" o "Upload" ?

 - ¿ Está completamente cargada la batería del ordenador de buceo ? Si nó debe
   cargarse o ser reemplazada.

 - ¿ Falla el cable ? ¿ Funciona bien el cable usando otro software ? ¿ Ha
   funcionado antes o es la primera vez que se usa ? ¿ Están limpios los contactos
   entre el cable y el ordenador de buceo ?

 - Consultar el
   xref:_apendice_a_informacion_especifica_del_sistema_operativo_para_importar_inmersiones_desde_un_ordenador_de_buceo[Apéndice A]
   y asegurarse de que se especificó el punto de montaje correcto.

 - En sistemas operativos tipo unix, comprobar que el usuario tiene permisos de
   escritura en el puerto USB. Si no, consultar el
   xref:_apendice_a_informacion_especifica_del_sistema_operativo_para_importar_inmersiones_desde_un_ordenador_de_buceo[Apéndice A].

Si el PC con _Subsurface_ no reconoce el adaptador USB mostrando un nombre de
dispositivo correcto, existe la posibilidad de que fallen el cable o el
adaptador estén fallando. Un cable que falla es la causa más común de problemas
de comunicación entre el PC y el ordenador de buceo. También existe la
posibilidad de que el PC con _Subsurface_ no pueda interpretar los datos. Habría
que efectuar una descarga con propósito diagnóstico con las siguientes casillas
seleccionadas en el dialogo de descarga:

	Guardar registro de libdivecomputer
	Guardar volcado de libdivecomputer

*Importante*: Estas casillas solo se utilizan si aparecen problemas durante el
proceso de descarga; en condiciones normales no deberían estar seleccionadas. Al
seleccionar cada una de estas opciones, se le solicita al usuario una carpeta en
la que guardar los ficheros de información. Por defecto esta carpeta es la misma
en la que se guarda el archivo del diario de _Subsurface_.

*Importante*: Al terminar de descargar con estas casillas seleccionadas no se
muestran buceos en la Lista de inmersiones pero se crearán dos ficheros en la
carpeta seleccionada arriba:

	_Subsurface_.log
	_Subsurface_.bin

Estos ficheros deberían ser remitidos a la lista de correo de _Subsurface_:
_subsurface_@hohndel.org_ solicitando que los ficheros sean analizados,
facilitando el fabricante y el modelo de tu ordenador de buceo y alguna
información sobre las inmersiones grabadas en el ordenador de buceo.
****

[[S_Bluetooth]]
==== Conectar _Subsurface_ con ordenadores de buceo con Bluetooth
[icon="images/icons/bluetooth.jpg"]

Bluetooth se está convirtiendo en una forma cada vez más común de comunicación
entre los ordenadores de buceo y _Subsurface_. Por ejemplo, este mecanismo se
usa en el Shearwater Petrel Mk2 o el OSTC3. _Subsurface_ proporciona un
interfaz Bluetooth muy independiente del sistema operativo utilizado. Ajustar
_Subsurface_ para comunicación con Bluetooth requiere cuatro pasos:

- Asegurarse de que Bluetooth está activado en el ordenador que ejecuta
  _Subsurface_.
- Asegurarse de que _Subsurface_ localiza el adaptador Bluetooth del
  ordenador.
- Asegurarse de que el Bluetooth del ordenador de buceo está está en modo
  descarga y es visible.
- Asegurarse de que _Subsurface_ está emparejado con el ordenador de buceo.

Abre el diálogo de descarga seleccionando _Import -> Importar del ordenador
de buceo_ desde el *Menú Principal*. Si se selecciona la casilla etiquetada
_"Elegir modo de descarga Bluetooth"_ , aparecerá el diálogo que se muestra
a continuación.

==== En Linux o MacOS

image::images/DC_import_Bluetooth.jpg["FIGURA: Descarga Bluetooth",align="center"]

En plataformas _Linux_ o _MacOS_ el nombre del ordenador con _Subsurface_
se muestran en el lado derecho. En el lado izquierdo, si el ordenador tiene
conectado más de un dispositivo  Bluetooth, se puede seleccionar cual se desea
conectar a _Subsurface_.
Bajo la dirección se muestra el estado del adaptador (activado/desactivado) y
puede cambiarse pulsando el botón _Activar/desactivar_.

Si no se muestra la dirección Bluetooth, es que _Subsurface_ no localiza el
dispositivo Bluetooth del ordenador en que se ejecuta. Asegúrate de que el
driver Bluetooth está instalado correctamente y comprueba que se puede usar
con otras utilidades Bluetooth como _bluetoothctl_, bluemoon u otras. Con esto
se completaría los primeros dos pasos indicados anteriormente.

Asegúrate de que el ordenador de buceo es visible y se encuentra en modo
descarga (Nota del traductor: es posible que este modo aparezca en inglés como
"Upload" o su traducción literal "Subida"). Consulta el manual del ordenador
de buceo para completar este paso, que sería el tercero de la lista anterior.

Selecciona el botón _Buscar_ en la parte de abajo a la izquierda del diálogo
anterior, Tras buscar unos momentos, el ordenador de buceo debería aparecer en
la relación (tal vez entre otros dispositivos Bluetooth) de la lista de la
izquierda del diálogo (ver imagen anterior). Si no es así, pulsa el botón,
_Limpiar_ y efectúa una nueva búsqueda utilizando el botón _Buscar_. Si
_Subsurface_ "ve" el ordenador de buceo, la línea de la lista contendrá el
nombre del dispositivo, su dirección y su estado de emparejamiento. Si el
dispositivo no está emparejado y tiene un fondo rojo, se puede abrir un menú
contextual seleccionando su línea y pulsando clic-derecho.
Pulsa el botón _Emparejar_ y espera a que se complete la tarea. Si este
ordenador de buceo se está emparejando con _Subsurface_ por primera vez, es
posible que se requiera una clave o número PIN. La clave más utilizada suele
ser 0000, y funciona para el Shearwater Petrel. En caso necesario, consulta el
manual de usuario del ordenador de buceo.

****
[icon="images/icons/important.png"]
[IMPORTANT]
Actualmente _Subsurface_ no soporta emparejamiento con ordenadores de buceo que
requieran un PIN definido. Para poder emparejar los dispositivos en este caso,
habría que utiliza alguna otra utilidad del SO.

Una forma de hacerlo es usar +bluetoothctl+:

       $ bluetoothctl
       [bluetooth]# agent KeyboardOnly
       Agent registered
       [bluetooth]# default-agent
       Default agent request successful
       [bluetooth]# pair 00:80:25:49:6C:E3
       Attempting to pair with 00:80:25:49:6C:E3
       [CHG] Device 00:80:25:49:6C:E3 Connected: yes
       Request PIN code
       [agent] Enter PIN code: 0000
****

Después de que los dispositivos se hayan emparejado, se puede pulsar el botón
_Guardar_.  Esto cerrará el diálogo. Ahora pulsa _Descargar_ en el diálogo
_Descargar del ordenador de buceo_ que debería permanecer abierto. Los buceos
descargado se mostrarán en el lado derecho de la ventana de descarga.

==== En Windows
image::images/DC_import_Bluetooth_Windows.png["FIGURE: Descarga Bluetooth en Windows",align="center"]
En plataformas Windows no está disponible la _sección de detalles de los
dispositivos Bluetooth_. Para iniciar correctamente un escaneo pulsando el
botón _Buscar_ , comprueba que el dispositivo _Bluetooth_ del ordenador con
_Subsurface_ está activado seleccionando el ordenador de la lista de
dispositivos Bluetooth disponibles (ver imagen anterior). Si se accede por
primera vez al ordenador de buceo con _Subsurface_, es posible que se
requiera una clave/PIN. Introduce el recomendado en el manual de ordenador
de buceo.  A menudo es correcto un pin 0000.

El paso del emparejado se efectúa de forma
automática durante el proceso de descarga. Si los dispositivos no se han
emparejado nunca, el sistema te pedirá permiso y mostrará un mensaje en el
lado derecho de la pantalla: _Añadir un dispositivo. Pulsa para configurar tu
dispositivo DC_. Siempre debes autorizar el emparejado. Tras haber seleccionado
uno de los dispositivos encontrados, pulsa _Guardar_. Finalmente, selecciona
el botón _Descargar_ del diálogo de descargas y espera a que se complete el
proceso.

[icon="images/icons/important.png"]
[IMPORTANT]
Hay que tener en cuenta que, actualmente, _Subsurface_ solo funciona con
adaptadores Bluetooth locales que usen Microsoft Bluetooth Stack. Si el
dispositivo local usa drivers _Widcomm_, _Stonestreet One Bluetopia Bluetooth_ o
_BlueSolei_ no funcionará, sin embargo, los receptores de estos fabricantes
que usen el Microsoft Bluetooth Stack sí funcionarán.

Un mensaje de aviso en la parte inferior izquierda de la _Selección de
dispositivos Bluetooth remotos_ muestra detalles del estado actual del agente
Bluetooth.
Si se desea seleccionar otro ordenador de buceo utilizando la _Selección de
dispositivo Bluetooth remoto_ pulsa el botón con tres puntos de _Elegir modo
de descarga _Bluetooth_.

[icon="images/icons/important.png"]
[IMPORTANT]
*EN CASO DE PROBLEMAS*: Si el adaptador Bluetooth del ordenador con _Subsurface_
se cuelga y el proceso de descarga falla repetidamente, _desempareja_ los
dispositivos y repite los pasos indicados anteriormente. Si a pesar de ello
se sigue sin tener éxito, el xref:S_HowFindBluetoothDeviceName[_Apéndice A_]
contiene información para ajustar manualmente e inspeccionar la conexión
Bluetooth con _Subsurface_.

[[S_DeviceNames]]
==== Cambiar el nombre de un ordenador de buceo

Es posible que sea necesario distinguir entre diferentes ordenadores de buceo
usados para cargar inmersiones en _Subsurface_. Por ejemplo, si el ordenador del
compañero es de la misma marca y modelo que el del usuario y los diarios de
ambos se cargan en el mismo PC con _Subsurface_, puede que se quiera llamar a
uno "Suunto D4 de Alice" y al otro "Suunto D4 de Bob". Por otro lado, puede que
un buceador técnico utilice dos o más ordenadores de buceo del mismo modelo,
este caso podría ser prudente llamar a uno "Suunto D4 (1)" y al otro "Suunto D4
(2)".

Esto se hace fácilmente en _Subsurface_. Desde el *Menú Principal*, se
selecciona _Registro -> Editar nombres de dispositivos_. Se abrirá un diálogo en
el que se indica el modelo actual, su ID y un nombre para el ordenador de buceo
utilizado para cargar inmersiones. Se edita el campo del nombre al que se quiera
asignar al ordenador. Tras guardar el nombre, en el perfil de la inmersión
aparecerá el nombre que se haya asignado a ese dispositivo en particular en
lugar del modelo, permitiendo una identificación de dispositivos más fácil.

[[S_MultipleDiveComputers]]
==== Cargar datos de una inmersión desde más de un ordenador de buceo

Algunos buceadores utilizan más de un ordenador al mismo tiempo (por ejemplo
en buceo técnico).
Si se importan los perfiles de estos diferentes ordenadores a _Subsurface_,
los perfiles pueden visualizarse independientemente. Durante la descarga, los
datos de los ordenadores se mezclan en una sola inmersión. Los diferentes
perfiles se presentan en el panel _Perfil_ con el nombre de cada ordenador
indicado en la parte inferior izquierda.
*Con la inmersión resaltada en la _Lista de inmersiones_*, cambia entre los
diferentes perfiles de los distintos ordenadores de buceo con las flechas
derecha/izquierda o seleccionando _Ver -> Ordenador anterior_ o _Ver -> Ordenador
siguiente_. Los datos del panel _Notas_ no se ven afectados por el ordenador
seleccionado.

[[S_EditDiveInfo]]
==== Actualizar la información de buceo importada del ordenador.

Con los buceos descargados en la *Lista de inmersiones*, la información del
ordenador no está completa y es necesario añadir más detalles para tener un
registro más detallado de las inmersiones. Para ello se usan las pestañas
*Notas* y *Equipo* arriba a la izquierda de la ventana de
_Subsurface_.

[[S_Notes_dc]]
===== Notas

El usuario debe añadir información a mano para poder tener un registro más
completo. La información a continuación es casi idéntica para inmersiones
creadas manualmente y para inmersiones descargadas del ordenador.

En algunos casos, se debe proporcionar la fecha y la hora de la inmersión, por
ejemplo al crear un buceo a mano o cuando un ordenador no facilita la fecha y
la hora de la inmersión (habitualmente la fecha y hora del buceo, la mezcla de gases
y, la temperatura del agua se obtienen del ordenador de buceo). Si se cambia o
edita de alguna manera el contenido de esta
pestaña, el mensaje de la barra azul arriba del panel indicará que se está
editando el buceo. Si se pulsa en la pestaña *Notas*, se
visualizan los siguientes campos (imagen a la izquierda, a continuación:

image::images/AddDive3_f22.jpg["FIGURA: La pestaña Notas",align="center"]

La imagen derecha anterior muestra una pestaña *Notas* llena de información.
El campo *Hora* refleja la fecha y la hora de la inmersión. Clicando la fecha se
muestra un calendario desde el que seleccionar la fecha correcta. Pulsa ESC para
salir del calendario. La hora y los minutos también pueden editarse clicando en
cada uno de ellos y sobreescribiendo la información mostrada.

*Temperaturas Aire/Agua*: Las temperaturas de aire y agua durante la inmersión
se muestran en estos campos a la derecha de la Hora de Inicio. Muchos
ordenadores de buceo suministran información sobre la temperatura del agua y
este campo puede que ya contenga información obtenida del mismo. Si no se
proporciona la temperatura del aire, puede utilizarse la primera lectura del
ordenador. En general, suele estar bastante cerca de la temperatura real del
aire ya que el cambio en la lectura del sensor de temperatura es bastante lento
para seguir los cambios en el entorno. Si fuera necesario, no hay que teclear
las unidades de temperatura: _Subsurface_ las suministra automáticamente de
acuerdo con las _Preferencias_ (métricas o imperiales).

*Ubicación*:
[icon="images/icons/warning2.png"]
[WARNING]
Las localizaciones de buceo se gestionan como una parte *separada* del divelog.
La información de buceo de las pestañas *Notas* y *Equipo* no se puede editar
al mismo tiempo que la información de los puntos de buceo. Guarda toda la otra
información (p.e. divemaster, compañero, equipo, etc) seleccionando _Aplicar
cambios_ en la pestaña *Notas* antes de editar la información del punto de
buceo. Introduce, solo entonces, el nombre del lugar de la inmersión en el
campo de texto etiquetado _Ubicación_ de la pestaña *Notas*.


Teclea el nombre del punto de buceo, p.e. "Tihany, Lake Balaton, Hungary".
Si se han efectuado varias inmersiones en el mismo lugar, la información del
primer buceo se reutiliza.
La información existente puede editarse en cualquier momento seleccionando
(en el panel *Lista de Inmersiones*) un buceo efectuado en el lugar deseado y
abriendo la información de la ubicación haciendo clic en el botón con el globo
a la derecha del nombre del lugar (ver la imagen de arriba a la derecha).
Cuando se introduce el nombre de una ubicación, el auto completado de nombres
hace que sea fácil seleccionar un punto de buceo que ya exista en el divelog
(p.e. al teclear el nombre de un punto de buceo, aparece una lista desplegable
 mostrando todos los lugares con nombres similares). Si el lugar se ha utilizado
antes, pulsa en el nombre preexistente.

Los nombres de la lista desplegable contienen, bien un símbolo de un globo (que
indica que existe en la base de datos de _Subsurface_), bien un símbolo *+* (que
indicaría un nombre que puede ser añadido a la base de datos).
Así pues, si este punto de buceo no ha sido usado con anterioridad, aparece un
mensaje como el siguiente (imagen *A* a continuación):

image::images/Locations1_f22.jpg["FIGURA: Panel de descripción de ubicación",align="center"]

Haz doble clic en el icono + en el lado derecho. Aparecerá un panel para
introducir las coordenadas y otra información sobre el lugar que pueda ser
importante (imagen *B*, anterior). Lo más importante son las coordenadas del
punto. Hay tres formas de especificarlas:

a. El usuario puede encontrar las coordenadas en el mapamundi situado abajo a la
   derecha en la ventana de _Subsurface_. El mapa muestra una barra marrón indicando
   "Sin datos de ubicación - Mueve el mapa y haz doble clic para fijar la posición
   del buceo". Al hacer doble clic en el lugar apropiado, la barra marrón desaparece
   y las coordenadas quedan grabadas

b. Se pueden obtener las coordenadas desde la apps _Subsurface Companion_ o
   _Subsurface mobile_ si se dispone de un dispositivo android o iPhone con
   GPS y se guardaron las coordenadas del punto de buceo usando ese
   dispositivo. xref:S_Companion[Pulsa aquí para más información]

c. Se pueden introducir las coordenadas a mano, si son conocidas, usando uno de
   estos cuatro formatos, con la latitud seguida de la longitud:

      Formato ISO 6709 Annex D, p.e. 30°13'28.9"N 30°49'1.5"E
      Grados y minutos decimales, p.e. N30º 13.49760', E30º 49.30788'
      Grados minutos y segundos, p.e. N30° 13' 29.8" , E30° 49' 1.5"
      Grados decimales, p.e. 30.22496 , 30.821798

Las latitudes del hemisferio sur se dan con una *S*, p.e. S30º o con un valor
negativo, p.e. -30.22496. De igual forma, las longitudes al oeste se facilita
con una *W*, p.e. W07°, o con un valor negativo, p.e. -7.34323. Algunos teclados
no tienen el símbolo °. Puede reemplazarse con una *d* como en N30d W20d.
Si se ha proporcionado un nombre y unas coordenadas, guarda la información
seleccionando el botón _Aplicar cambios_ arriba en el panel.

*Importante*: Las coordenadas GPS de un punto están unidas a un nombre, por
tanto, guardar inmersiones  con coordenadas sin una descripción del lugar
causará comportamientos inesperados (_Subsurface_ creerá que todos estos puntos
son el mismo e intentará hacer que toas las coordenadas sean iguales).

*Búsqueda de nombres de puntos de buceo*: Si se han introducido coordenadas,
se puede efectuar una busca automatizada  del nombre basada en ellas. Se hace
cuando _Subsurface_utiliza internet para encontrar el nombre del punto de
buceo basado en las coordenadas introducidas. Si se encuentra un nombre, se
introduce automáticamente en la casilla de texto. El campo llamado _Puntos de
buceo en las mismas coordenadas_, en la parte baja del panel, contiene nombres
de otros puntos de buceo en posiciones muy cercanas al actual.

Introduce cualquier otra información textual sobre el punto de buceo
(Descripción y Notas), entonces selecciona _Aplicar cambios_ para guardar la
información de este punto de buceo. En una etapa posterior esta información
puede editarse pulsando el icono del globo a la derecha del nombre del punto en
la pestaña *Notas*.

*Modo de buceo*: Esta es una casilla desplegable que permite elegir el tipo de
inmersión que se ha realizado. Las opciones son OC (circuito abierto, del
inglés "open circuit", el ajuste por defecto, valido para la mayoría de buceos
recreativos), Apnea, CCR (rebreather de circuito cerrado, del inglés "closed
circuit rebreather") o pSCR (rebreather pasivo de circuito semi-cerrado).

*Divemaster*: Introducir el nombre del divemaster o el del guía de inmersión. De
nuevo, este campo ofrece autocompletado basándose en la lista de divemasters del
diario actual.

*Compañero*: Introducir el nombre(s) del compañero(s) que te acompañaron en la
inmersión, separados por comas. También se ofrece autocompletado basada en la
lista de compañeros del registro.

*Traje*: Introducir el tipo de traje de buceo que utilizaste para la inmersión.
Como en los casos anteriores está disponible el autocompletado. Los usuarios de
traje seco pueden utilizar este campo para registrar que combinación de traje y
protección térmica utilizaron.

*Valoración*: Aquí se puede proporcionar una calificación subjetiva de la
inmersión en una escala de 5 puntos, clicando en la estrella correspondiente.

*Visibilidad*: Igualmente se puede proporcionar una calificación de a la
visibilidad que había durante la inmersión en una escala de 5 puntos, clicando
la estrella adecuada.

*Etiquetas*: Se pueden introducir etiquetas (separándolas con comas) que
describan el tipo de inmersión que se efectuó. Algunos ejemplos de etiquetas
habituales son: barco, a la deriva, entrenamiento, cueva, etc. _Subsurface_
tiene muchas etiquetas predefinidas. De nuevo se ofrece autocompletado, por
ejemplo, si el usuario teclea +p+, se muestran las etiquetas *pecio*, *piscina*
y *profunda* para que elija entre ellas.

*Notas*: Teclea aquí cualquier información adicional que desees conservar.

Los botones _Aplicar cambios_ y _Descartar cambios_ se utilizan para guardar
toda la información de los campos del panel de *Información* y del panel de
*Perfil*, por lo que no hay necesidad de usarlos hasta que se ha añadido
*TODA* la información. La imagen xref:S_Notes_dc[al inicio de esta sección]
muestra un ejemplo de la pestaña *Notas* rellenadas.

==== Equipo

La pestaña Equipo permite al usuario introducir información acerca del tipo de
botella y gas utilizado, así como el lastre utilizado en una inmersión. El
mensaje en azul arriba del panel

image::images/BlueEditBar_f22.jpg["FIGURA: Barra azul de edición",align="center"]

indica que la inmersión se está editando. Esta parte de _Subsurface_ es
altamente interactiva y la información de botellas y gases que se introduzca
determinará el comportamiento del perfil de la inmersión (panel de arriba a la
derecha).

[[cylinder_definitions]]
*Botellas*: La información de las botellas se introduce con un dialogo como
este:

image::images/DC_gas-dialogue1_f20.jpg["FIGURA: Diálogo de Botellas inicial",align="center"]

En las inmersiones manuales, esta información ha de ser introducida a mano. En
el caso de los ordenadores, a menudo, _Subsurface_ obtiene el gas usado del
propio ordenador de buceo insertando automáticamente la composición (% oxigeno)
en la tabla. El botón + arriba a la derecha permite al usuario añadir más
botellas para esta inmersión. El icono oscuro de papelera le permitirá borrar
la información de una botella. Nótese que no se puede borrar una botella si
se usa durante el buceo. Una botella puede estar usándose implícitamente,
incluso sin un evento de cambio de gas.

Se empieza por seleccionar un tipo de botella. Para ello hay que hacer clic en
la casilla *Tipo de botella*. Esto hará aparecer un botón que puede usarse para
mostrar una lista desplegable de botellas.

image::images/DC_gas-dialogue2_f20.jpg["FIGURA: Botón del desplegable de la lista de botellas",align="center"]

La lista desplegable puede usarse para seleccionar el tipo de botella que
utilizó en esta inmersión, o el usuario puede empezar a teclear en la casilla,
lo que mostrará las opciones disponibles para las letras introducidas. El
*Tamaño* así como su _Presión de trabajo_ se mostrarán automáticamente en el
dialogo.

A continuación es necesario indicar la presión inicial y final del gas usado
durante el buceo. Las unidades de presión (métricas/imperiales) corresponden a
las fijadas en la elección de _preferencias_.

Finalmente, hay que introducir la mezcla de gas que se usó. Si se utilizó aire,
se puede poner 21% o dejarlo en blanco. Si se usó nitrox o trimix, hay que
especificar sus porcentaje de oxigeno y de helio. Se deja en blanco el campo que
no corresponda utilizar. Tras teclear la información para la botella, hay que
pulsar _ENTER_ en el teclado o hacer clic fuera de la casilla que contiene el
cursor. Puede añadirse información para cualquier botella adicional usando el
botón + de arriba a la derecha. Aquí hay un ejemplo de descripción completa para
una inmersión en la que se han utilizado dos botellas (aire y EAN50):

image::images/CylinderDataEntry3_f20.jpg["FIGURA: Tabla con la informaación de botellas completada",align="center"]

*Lastre*: Se puede introducir información sobre el sistema de lastre utilizado
en una inmersión, usando un dialogo muy similar al de la información de las
botellas. Si se pulsa el botón + de arriba a la derecha en el dialogo de lastre,
la tabla aparecerá como sigue

image::images/WeightsDataEntry1_f20.jpg["FIGURA: El diálogo Lastre",align="center"]

Si se hace clic en el campo _Tipo_, se accede a una lista desplegable con la
flecha:

image::images/WeightsDataEntry2_f20.jpg["FIGURA: Desplegable con la lista de tipos de lastre",align="center"]

La lista desplegable puede usarse para seleccionar el tipo de sistema de lastre
utilizado durante la inmersión, o simplemente teclear en la casilla, con lo que
se mostrarán las opciones disponibles para los caracteres introducidos. En el
campo *Peso* se teclea el peso usado durante el buceo. Tras teclear la
información se pulsa _ENTER_ en el teclado o se hace clic fuera de la casilla
que contiene el cursor.
Se puede poner información para más de un sistema de lastre añadiendo otro con
el botón + de arriba a la derecha. Se pueden borrar lastres usando el icono de
papelera de la izquierda. A continuación, un ejemplo de información para una
inmersión con dos tipos de lastre: integrado y cinturón:

image::images/WeightsDataEntry3_f20.jpg["FIGURA: Tabla con información de lastre completada",align="center"]

==== Editar simultáneamente varias inmersiones seleccionadas

_MÉTODO 1_: Tras descargar inmersiones de un ordenador de buceo, los perfiles
de los buceos descargados se mostrarán en el panel "Perfil de la inmersión",
así como algunas otras informaciones en las pestañas "Notas" y
"Equipo". Sin embargo, otros campos permanecerán vacíos.

Puede resultar útil editar simultáneamente algunos de los campos de las "Notas
de la Inmersión" o del "Equipo". Por ejemplo, es posible que un buceador
efectuara varias inmersiones en un solo día utilizando el mismo equipo, o en el
mismo punto de buceo o con el mismo guía o compañero. En lugar de completar la
información de las inmersiones una por una, se pueden seleccionar todos los
buceos deseados en la "Lista de Inmersiones" e insertar la información común en
las "Notas" y "Equipo".

La edición simultánea solo funciona con campos que no contienen aún ninguna
información. Esto significa que si, para una inmersión en concreto, uno de los
campos ya ha sido rellenado, no será modificado por la edición simultánea en
ese buceo en concreto. Técnicamente, la regla para editar varias inmersiones a
la vez es: "si el campo que estamos editando contiene _exactamente la misma
información_ en todas las inmersiones que hemos seleccionado, la nueva
información introducida se sustituye en todas las inmersiones seleccionadas, de
lo contrario solo se cambia la inmersión que estemos editando aunque haya
varias seleccionadas.

Esto acelera notablemente el rellenado del divelog después de haber efectuado
varios buceos similares.

[[S_CopyComponents]]
_MÉTODO 2_: Hay una forma diferente de hacer lo mismo. Seleccionamos un buceo
que contenga toda la información apropiada  en las pestañas *Notas* y *Equipo*.
Entonces, desde el menú principal, seleccionamos
_Registro -> Copiar componentes_. Aparecerá una ventana con casillas
seleccionables para la mayoría de campos de las pestañas *Notas*
y *Equipo*.  Selecciona los campos a copiar desde la inmersión seleccionada,
luego pulsa _Aceptar_. Ahora selecciona en la *Lista de Inmersiones* los buceos
a los que pegar esta información. Desde el menú principal, selecciona _Registro
 -> Pegar componentes_. Tras esto, todas las inmersiones seleccionadas
 contendrán los datos seleccionados previamente de la anterior inmersión.

[[S_Bookmarks]]
==== Añadir Marcas a una inmersión

Muchos buceadores desean anotar en sus inmersiones textos que indiquen sucesos
concretos durante el buceo, p.e. "Avistamos delfines" o "Lanzada boya deco".
Esto se hace fácilmente:

 - Clic derecho sobre el punto adecuado del perfil de inmersión, se desplegará
   el menú contextual del perfil. Se selecciona _Añadir marca_. Una bandera roja
   aparecerá sobre el perfil en el punto inicialmente seleccionado (ver *A* a
   continuación).
 - Clic derecho sobre la bandera roja. Se desplegará el menú contextual (ver
   *B* a continuación). Se selecciona _Editar nombre_.

 - Se mostrará una casilla de texto. Se teclea en ella el texto oportuno para la
   marca (ver *C* a continuación). Se selecciona _Aceptar_, con lo que se guarda el
   texto asociado a la marca.

 - Cuando el ratón pase sobre el marcador rojo, el texto guardado se mostrará en
   la parte de debajo del cajetín de información (ver *D* a continuación).

image::images/Bookmarks.jpg["FIGURA: Diálogo de marcadores",align="center"]

==== Guardar la información de buceo actualizada

La información introducida en las pestañas Notas y Equipo puede
guardarse utilizando los dos botones de arriba a la derecha de la pestaña
*Notas*. Si se pulsa _Aplicar cambios_ los datos del buceo se guardan en la
imagen en memoria de la inmersión. Si se pulsa _Descartar cambios_ los datos
de buceo recién introducidos se borran de la memoria, aunque el perfil y los
datos descargados del ordenador quedarán retenidos. Cuando el usuario salga de
_Subsurface_ hay una pregunta final para confirmar si los nuevos datos de deben
guardar en caso de no haberlo hecho antes.

=== Importar información de inmersiones de otras fuentes u otros formatos de datos

[[S_ImportingAlienDiveLogs]]

Muchos buceadores guardan sus registros utilizando el software propietario
proporcionado por el fabricante de su ordenador de buceo. _Subsurface_ puede importar un amplio abanico de diarios de otros softwares de registro.
Mientras que algún software se soporta nativamente, en otros casos el usuario
debe exportar el(los) diario(s) a un formato intermedio para que pueda ser
importado a _Subsurface_.
Actualmente, _Subsurface_ soporta importar archivos _CSV_ de diferentes orígenes.
Los archivos de APD LogViewer, XP5, Sensus y Seabear están preconfigurados,
pero dado que es flexible, los usuarios pueden configurar sus propias
importaciones. Diarios creados manualmente (p.e. en hojas de cálculo) también
pueden importarse configurando manualmente el CSV. _Subsurface_ también puede
importar archivos UDDF y UDCF, usados por algún software y algunos ordenadores
de buceo como el H&W DR5 o el XDeep Black BT. Finalmente, para algunos programas
de registro como el Mares Dive Organiser, se sugiere exportar los diarios primero
a un servicio web como _divelogs.de_ e importarlos desde allí a _Subsurface_, ya
que _divelogs.de_ soporta algunos pocos formatos que _Subsurface_ no puede leer
en la actualidad.

Si el formato del otro software está soportado nativamente en _Subsurface,
debería ser suficiente con seleccionar bien _Importar->Importar archivos de
registro_, bien _Archivo->Abrir registro_ . _Subsurface_ soporta directamente
los formatos de datos de muchos ordenadores de buceo, incluyendo Suunto,
Shearwater y algunos equipos de rebreathers.

Al importar inmersiones, _Subsurface_ intenta detectar múltiples registros del
mismo buceo y mezcla la información lo mejor que puede. Si no existen problemas
con las zonas horarias (u otras razones que hagan que la hora de comienzo de las
inmersiones sean significativamente diferentes) _Subsurface_ no creará entradas
duplicadas. A continuación sigue más información relativa a importar datos a
_Subsurface_

[[Unified_import]]
==== Utilizar el diálogo de importación universal

El importar buceos desde otros programas se hace a través de una interfaz
universal que se activa seleccionando Importar desde el menú principal y
haciendo clic en _Importar archivos de registro_. Con ello se mostrará el
dialogo *A* a continuación.

image::images/Import1_f20.jpg["FIGURA: Importar: paso 1",align="center"]

Abajo a la derecha hay un desplegable con una etiqueta por defecto Archivos de
registro que da acceso a los diferentes tipos de archivo disponibles para
importar directamente, como en el dialogo *B* anterior. Actualmente son:

 - Diarios en formato XML (DivingLog 5.0, MacDive y varios otros)
 - Archivos de Cochran
 - Diarios en formato UDDF (p.e. Kenozooid)
 - Diarios en formato UDCF
 - Diarios de CCR Poseidon MKVI
 - Diarios de CCR APD Inspiration/Evolution
 - Diarios de LiquidVision
 - Diarios de divelogs.de
 - Diarios de DataTrak
 - Diarios de OSTCTools
 - JDiveLog
 - Suunto Dive Manager (DM3, DM4 y DM5)
 - Archivos DL7 utilizados por DAN
 - Divelog de Underwater technologies AV1
 - Diarios en formato _CSV_ (basados en texto o en hojas de cálculo), incluidos
diarios de CCR APD.

Seleccionar el archivo correspondiente en la lista del diálogo abre el archivo
importado directamente en la *Lista de Inmersiones* de _Subsurface_. También
están soportados algunos otros formatos, no accesibles desde el diálogo
Importar, como se explica a continuación.

==== Importar desde OSTCTools

_OSTCTools_ es un conjunto de herramientas basadas en Windows de descarga y
gestión para la familia de ordenadores OSTC. _OSTCTools_ puede descargar datos
de las inmersiones y guardarlos en archivos binarios con extensión _.dive_ .
Subsurface puede importar directamente estos archivos utilizando el diálogo de
importación universal. Desde la lista desplegable abajo a la derecha, se
selecciona la opción correspondiente, lo cual hará visibles los diarios en la
lista del panel. Se seleccionan una o varias inmersiones, y se hace click en el
botón _Abrir_. Las inmersiones importadas desde OSTCTools se mostrarán en el
panel *Lista de inmersiones*.

Actualmente, todos los ordenadores de H&W que soporte OSTCTools pueden importarse
a _Subsurface_, esto incluye OSTC, OSTC Mk2, OSTC 2N/2C, OSTC3, OSTC Sport, y,
probablemente aunque sin probar, Frog, OSTC2 y OSTC CR.

Por favor, recuerda que OSTCTools *no* es un auténtico software de registro de
diarios de buceo, sino un útil conjunto de herramientas de gestión y análisis
para dispositivos OSTC.  Así pues, importar inmersiones a _Subsurface_ sólo
nos proporcionará datos relativos al ordenador de buceo; el usuario tendrá
que completar manualmente el resto de datos que le puedan resultar importantes
(compañeros, equipo, notas, etc).

==== Importar desde Mares Dive Organiser V2.1

Dado que Mares utiliza software propiedad de Microsoft no compatible con
aplicaciones multiplataforma, estos diarios no pueden importarse directamente a
_Subsurface_. Los diarios de Mares necesitan ser importados usando un proceso en
tres pasos, utilizando _www.divelogs.de_ como mecanismo para extraer la
información.

1. Los datos del Mares Dive Organiser necesitan exportarse al escritorio del
   usuario utilizando una extensión de archivo _.sdf_. Dirigirse a
   xref:Mares_Export[Apendice C] para más información.
2. Los datos deben ser importados entonces desde _www.divelogs.de_. Se necesita
   crear una cuenta de usuario en _www.divelogs.de_, entrar a la página, entonces
   seleccionar _Import Logbook → Dive Organiser_ en el menú de la izquierda. Hay
   que seguir cuidadosamente las instrucciones para transferir la información (en
   formato _.sdf_) desde la base de datos de Dive Organiser a _www.divelogs.de_.
3. Finalmente importar las inmersiones desde _divelogs.de_ a _Subsurface_,
   utilizando las instrucciones a continuación.

[[S_SmartTrakImport]]
==== Importar divelogs de SmartTrak de Scubapro

SmartTrak es un software propietario de Uwatec (hoy Scubapro) basado en
Windows. Funciona con bases de datos Access, lo que hace difícil su
integración en el núcleo del programa _Subsurface_, y guarda los datos del
ordenador de buceo "en crudo" junto con una enorme cantidad de otros datos
añadidos por el usuario, que van desde los puntos de inmersión hasta la
información del formato DAN, pasando por datos de los compañeros de buceo y
otros.

Se ha desarrollado una pequeña herramienta independiente para importar los
archivos .slg generados por SmartTrak al formato .xml de _Subsurface_. Puede
compilarse junto con _Subsurface_ en sistemas Linux.  Se necesita instalar dos
dependencias antes compilar: libglib2.0 y libmdb2.

Si necesitas ayuda puedes contactar con el equipo de _Subsurface_ en
mailto:subsurface@subsurface-divelog.org[nuestra lista de correo]

Suponiendo que se hayan instalado las dependencias y que el directorio raíz
del código de _Subsurface_ sea ~/src/subsurface, entonces:

===== Compilar _smtk2ssrf_

- Sitúate en el directorio raíz del código de _Subsurface_
- Ejecuta " $ ccmake build " y ajusta la opción SMARTTRAK_IMPORT a *ON* (por
  defecto en OFF).
- Selecciona [c] y [g] para generar la configuración de cmake y guardarla.
- Compila el código como prefieras, usando el script build.sh (recomendado) o
  yendo al directorio "build" y ejecutando "make".
- Si se ha compilado el código con éxito, habrá un ejecutable en el directorio
  "build" llamado smtk2ssrf, cópialo o muévelo a un directorio que se
  encuentre incluido en tu $PATH, p.e. ~/bin

===== Ejecutar

smtk2ssrf admite 0, 2 o más parámetros. Si se ejecuta sin parámetros y nos
encontramos en un entorno gráfico, se mostrará una ventana simple que nos
permitirá seleccionar el(los) archivo(s) a importar y otro archivo para
guardar los datos en formato de Subsurface (ver imagen a continuación).

image::images/smtk2ssrf.jpg["FIGURE:Importar desde SmartTrak",align="center"]

[icon="images/icons/warning2.png"]
[WARNING]
Los datos anteriores del archivo se borrarán, o sea que *NO UTILICES* el
divelog habitual de _Subsurface_ como salida. Se recomienda utilizar un
archivo nuevo para guardar los datos importados.

Si la herramienta se ejecuta desde línea de comandos con dos o más parámetros
como:

	$ smrtk2ssrfc /input/file_1.slg /input/file_2.slg /output/file.xml

Los archivos file_1.slg y file_2.slg situados en la carpeta input se
importarán y se guardarán en el archivo file.xml situado en la carpeta output.

Comprueba los mensajes de aviso o error que puedan aparecer en la ventana
gráfica o en la consola, algunos pueden ser interesantes, ya que el soporte de
los ordenadores Galileo y familia está, aún, en progreso.

===== Mezclar las inmersiones importadas en el divelog existente

Abre el archivo nuevo con _Subsurface_ y comprueba las inmersiones y los datos
importados. Si todo está correcto, cierra este archivo y abre tu divelog
habitual. Luego, desde el _Menú_ selecciona _Importar -> Importar archivos de
registro_ y selecciona el archivo .xml recién creado. Las inmersiones
importadas aparecerán en la _Lista de Inmersiones_ mezcladas con las
anteriores y ordenadas por fecha y hora.
Las nuevas inmersiones, aunque ordenadas, mantendrán la numeración que tenían
de SmartTrak, por tanto, se necesitará renumerarlas. Visita la sección
xref:S_Renumber[Renumerar las inmersiones] de este manual si necesitas
información sobre como hacerlo.

[[S_ImportingDivelogsDe]]
==== Importar inmersiones desde *divelogs.de*

Importar información de inmersiones desde _divelogs.de_ es simple, se usa un
único diálogo. Se selecciona _Importar → Importar desde Divelogs.de_ en el menú
principal. Esto despliega un diálogo (ver figura *A* abajo a la izquierda). Es
necesario introducir un usuario y password para _divelogs.de_ en los campos que
se indiquen y luego pulsar el botón _Descargar_. La descarga desde divelogs.de
comienza inmediatamente y se refleja en una barra de progreso de la ventana del
diálogo. Al finalizar la descarga se indica el estado de "exito" (ver figura
*B* abajo a la derecha). Se selecciona el botón _Aplicar_, tras lo cual las
inmersiones importadas aparecerán en el panel *Lista de Inmersiones*.

image::images/Divelogs1.jpg["FIGURE:Descargar desde Divelogs.de",align="center"]

[[S_ImportingCSVData]]
==== Importar datos en formato CSV

Se puede utilizar un archivo .csv (valores separados por comas) para importar
información de buceo así como perfiles de inmersión (como en el caso de los
CCRs APD Inspiration o el Evolution) o como metadatos de buceo (en caso de que
el usuario guarde los datos en una hoja de cálculo). El formato _CSV_ es un
formato universal simplificado que permite un intercambio facil de información
entre difeerentes ordenadores o paquetes de software. Para una introducción a
archivos en formato _CSV_ ver xref:S_CSV_Intro[Introducción de un buceador a los archivos CSV].
Los diarios de _Subsurface_ también pueden exportarse a formato _CSV_ para
otro software que lea este formato. Ver el xref:S_Appendix_D[APPENDIX D: Exportar una hoja de cálculo a formato CSV]
para información que puede resultar útil para importar datos basados en hojas
de cálculo a _Subsurface_.

[[S_ImportingCSVDives]]
==== Importar inmersiones en formato _CSV_ desde ordenadores u otro software

Un archivvo _CSV_ se puede visualizar utilizando un editor de textos ordinario.
Se organiza, normalmente, en una sola línea que proporciona las cabeceras (o
_nombres de campo_ o _encabezamientos_) de las columnas de datos, seguidos por
los datos a un registro (inmersión en nuestro caso) por línea.

Hay dos tipos de archivo _CSV_ que pueden importarse en _Subsurface_:

1. _Detalles de inmersión CSV_: Este formato contiene información similar a la
   de un típico diario escrito, p.e. fecha, hora, profundidad, duración, nombre
   de los compañeros y divemaster, y tal vez alguna información sobre botellas,
   así como algunos comentarios sobre la inmersión.  Toda la información sobre
   un buceo va en una sola línea siguiendo el orden del encabezamiento de las
   columnas.

2. _Perfil de inmersión CSV_: Este formato incluye mucha más información
   sobre una sola inmersión. Por ejemplo, puede haber información a intervalos
   de 30 segundos indicando la profundidad, la temperatura del agua a esa
   profundidad y presión de las botellas en ese instante. Cada línea contiene
   la información de un solo instante durante la inmersión, 30 segundos tras el
   anterior.   Se requieren muchas líneas para completar la información del
   perfil de profundidad de un buceo. Es un formato utilizado comúnmente para
   exportar por los equipos de buceo en circuito cerrado (CCR) y muchos
   paquetes de software que manejan ordenadores de buceo y/o diarios.

Antes de poder importar los datos a _Subsurface_ se necesitan saber algunas
cosas sobre los mismos:

a. ¿ Que carácter separa las distintas columnas en una línea de datos ? Este
   separador de campos debería ser una coma (,) un punto y coma (;) o un
   tabulador. Puede averiguarse abriendo el archivo con un editor de textos.
   Si se trata de una coma, el carácter será claramente visible entre valores.
   Si no hay comas a la vista, seguramente esté delimitado por tabuladores.

b. ¿ Que columnas de datos necesitamos importar a _Subsurface_ ? ¿ Es un archivo
   de _Detalles de inmersión CSV_ o de _Perfil de inmersión CSV_ ? Ábrelo con un
   editor de textos y fíjate en los títulos de las columnas a importar y sus
   posiciones.

c. ¿ Está la información numérica (la profundidad por ejemplo) en unidades
   métricas o imperiales ?

Armado con esta información, importar en _Subsurface_ es muy fácil. Selecciona
_Importar→Importar CSV_ en el menú principal. Aparecerá el siguiente dialogo:

image::images/csv_import1_f20.jpg["FIGURE: Diálogo 1, Descarga CSV",align="center"]

Fíjate que, arriba a la izquierda, hay una lista desplegable que contiene ajustes
preconfigurados para algunos de los ordenadores de buceo y paquetes de software
más comunes que podemos encontrar los buceadores. Si el archivo _CSV_ que vamos
a importar se originó en alguno de estos paquetes o dispositivos, selecciónalo.
En otro caso, utiliza la opción _Importación manual_. El panel de configuración
también tiene listas desplegables para especificar el separador de campos
adecuado (tabulado, coma o punto y coma), el formato de fecha usado en el CSV,
las unidades de tiempo (segundos, minutos o minutos:segundos), así como el
sistema de unidades (métrico o imperial) utilizado. Seleccionar las opciones
correctas es crítico para importar correctamente los datos.

La última tarea es asegurarse que todas las columnas de datos tienen las
cabeceras correctas. La línea superior de la parte blanca de la tabla contiene
las cabeceras de columnas encontradas en el archivo _CSV. La fila de celdas
azules inmediatamente sobre la anterior contiene los nombres que _Subsurface_
ha entendido. La zona blanca inmediatamente debajo de las listas desplegables
contiene los nombres de campos que _Subsurface_ reconoce. Estos nombres están
en globos azules que se pueden arrastrar y soltar en las celdas azules a las
que correspondan en la parte superior de la tabla. Esto se muestra en la
imagen a continuación.

image::images/csv_import2_f20.jpg["FIGURA: Diálogo 2, Descarga CSV",align="center"]

Continua haciendo hasta que todas los encabezamientos de columnas en la fila
azul de celdas correspondan a las cabeceras listadas en la parte alta del
diálogo. Habiendo completado esta tarea, selecciona el botón _OK_ abajo a la
derecha del diálogo. Los datos del archivo _CSV_ se importarán y se mostrarán
en el panel *Lista de inmersiones*.

[[S_CSV_Intro]]
****
*Introducción de un buceador a los archivos _CSV_*
[icon="images/icons/important.png"]
[IMPORTANT]

_CSV_ es una abreviatura para un formato de archivo de datos: _Comma-Separated
Variables_ en inglés. Es un formato de archivo que permite visualizar o editar
la información usando un editor de textos como el Bloc de Notas (Windows),
Gedit (linux) o TextWrangler (OS/X). Las dos principales ventajas del formato
CSV son que los datos son fácilmente editables como texto sin usar ningún
software propietario y asegurando que toda la información es legible, no siendo
ofuscada por ningún atributo de los que el software propietario inserta en los
archivos.
A causa de su simplicidad, el formato _CSV_ se utiliza como formato de intercambio
entre muchos paquetes de software, por ejemplo entre hojas de cálculo,
estadísticas, gráficos, bases de datos y software de buceo. En _Subsurface_, los
archivos _CSV_ también se pueden usar para importar información de otras fuentes
tales como diarios basados en hojas de cálculo o, incluso, de algunos ordenadores.

El atributo más importante de un archivo _CSV_ es el _separador de campos_, esto
es, el carácter utilizado para separar campos dentro de una línea. El separador
de campos es, habitualmente, una coma, un punto y coma, un espacio o un
tabulador. Al exportar datos desde una hoja de cálculo, se necesita especificar
el carácter separador para poder crear el archivo CSV. Los archivos _CSV_ están,
normalmente, organizados en una sola línea que proporciona las cabeceras (o
_nombres de campos_) de las columnas de datos, seguido por los datos, a un
registro por línea. Nótese que cada nombre de campo puede estar formado por más
de una palabra separadas por espacios; por ejemplo _Punto de buceo_. A
continuación, un ejemplo de información de cuatro inmersiones utilizando la coma
como separador de campos:

	Dive site,Dive date,Time,Dive_duration, Dive_depth,Dive buddy
	Illovo Beach,2012-11-23,10:45,46:15,18.4,John Smith
	Key Largo,2012-11-24,09:12,34:15,20.4,Jason McDonald
	Wismar Baltic,2012-12-01,10:13,35:27,15.4,Dieter Albrecht
	Pulau Weh,2012-12-20,09:46,55:56,38.6,Karaeng Bontonompo

En este formato los datos no son legibles con facilidad para los humanos. A
continuación los mismos datos usando el tabulador como separador:

	Dive site	Dive date	Time	Dive_duration	Dive_depth	Dive buddy
	Illovo Beach	2012-11-23	10:45	46:15	18.4	John Smith
	Key Largo	2012-11-24	09:12	34:15	20.4	Jason McDonald
	Wismar Baltic	2012-12-01	10:13	35:27	15.4	Dieter Albrecht
	Pulau Weh	2012-12-20	09:46	55:56	38.6	Karaeng Bontonompo

Es obvio por qué mucha gente prefiere el formato con tabulador al separado por
comas. La desventaja es que los tabuladores no se pueden ver. Por ejemplo el
espacio entre _Dive_ y _date_ en la primera línea puede ser un espacio o un
tabulador (en este caso un espacio). Si los nombres de campo de la primera línea
son largos, no se puede mantener la alineación con los otros campos de datos.
A continuación un ejemplo muy simplificado y recortado de un diario _CSV_ del
ordenador de buceo de un rebreather CCR APD:

	Dive Time (s)	Depth (m)	pO₂ - Setpoint (Bar)	pO₂ - C1 Cell 1 (Bar)	Ambient temp. (Celsius)
	0       0.0     0.70    0.81    13.1
	0       1.2     0.70    0.71    13.1
	0       0.0     0.70    0.71    13.1
	0       1.2     0.70    0.71    13.2
	0       1.2     0.70    0.71    13.1
	10      1.6     0.70    0.72    12.7
	20      1.6     0.70    0.71    12.6
	30      1.7     0.70    0.71    12.6
	40      1.8     0.70    0.68    12.5

Cuando un archivo _CSV_ se selecciona para importar, _Subsurface_ muestra las
cabeceras de las columnas y unas pocas lineas de datos del archivo, facilitando
mucho, de esta forma, trabajar con archivos _CSV_.
Conocer algunas cosas básicas sobre el contenido del archivo _CSV_ permite una
importación mejor de las inmersiones a _Subsurface_.

****

[icon="images/icons/important.png"]
+[IMPORTANT]
La importación _CSV_ tiene un par de advertencias. Se deberían evitar algunos
caracteres especiales como el signo &, menor que (<), mayor que (>) y comillas
(") como parte de los número o del texto de una casilla. El archivo debería
usar el conjunto de caracteres UTF-8, si se usan caracteres no ASCII. También
podría causar problemas el tamaño del archivo _CSV_. Importar 100 buceos de una
sola vez (_Detalles de inmersión CSV_) funciona, pero archivos mayores podrían
exceder los límites del analizador utilizado. Si se encontraran problemas al
importar _CSV_ sería conveniente probar con un archivo más pequeño solo para
asegurarse de que el resto funciona.


=== Importar coordenadas de buceo desde un dispositivo movil con GPS

Un smartphone con GPS incorporado puede utilizarse para guardar las
ubicaciones de las inmersiones. Esto se hace como sigue:

1) Llevar el dispositivo móvil en el barco de buceo o vida abordo, para
recoger automáticamente coordenadas.

2) Subir las coordenadas desde el dispositivo móvil al servidor de internet de
Subsurface.

3) Sincronizar los buceos de la lista de _Subsurface_ con las coordenadas del
servidor de internet.

_Subsurface_ dispone de dos herramientas para hacer esta tarea:

- La _app Subsurface companion_ (Android e iOS)

- La _app Subsurface-mobile_ (Android e iOS)

Ambas aplicaciones efectuan la recogida de coordenadas y la sincronización con
inmersiones de la lista. Sin embargo, la app companion no está siendo
desarrollada y ha sido reeemplazada por la app _Subsurface-mobile_.  Mientras
que la app companion servía exclusivamente para recoger coordenadas y hacerlas
disponibles para la versión de sobremesa de _Subsurface_, _Subsurface-mobile_
efectua muchas de las funciones de la versión de sobremesa, incluyendo la
visualización y gestión de de la información de buceo. A continuación se
describen los tres pasos mencionados anteriormente para cada una de las apps
moviles.

Para información sobre el uso de _Subsurface companion_, pulsa click xref:S_Companion[_aquí_].

==== Guardar y utilizar coordenadas GPS utilizando _Subsurface-mobile_

===== Instalar _Subsurface-mobile_

Busca _Subsurface-mobile_ en Google Play e instálala en el dispositivo
Android. La app is gratuita. La versión para iOS es experimental, actualmente.
_Subsurface-mobile_ tiene un extenso manual de usuario accesible desde la app.

===== Crear una cuenta de _Subsurface-mobile_

Este tópico se explica en profundidaad en el manual de _Subsurface-mobile_. En
la pantalla de credenciales de _Subsurface-mobile_ introduce una dirección de
correo electrónico y la clave de usuario que habilita el acceso.  Se remitirá
un PIN desde el servidor de Subsurface al correo electrónico facilitado.
Introduce el PIN en el campo de texto correspondiente de la pantalla
Credenciales (ver imagen a continuación).  El servidor de internet de
_Subsurface_ notificará al usuario que ha quedado registrado.

*N.B.:*  Para poder crear una cuenta de usuario, el dispositivo movil debe
tener acceso a internet a través de internet o de una red telefónica.

image::images/MobileCredentials.jpg["FIGURA: Subsurface-mobile, pantalla de credenciales",align="center"]

===== Configurar la recogida automástica de coordenadas

Activar el menú principal de _Subsurface-mobile_ seleccionando el botón
"hamburguesa" en la parte inferior izquierda de la pantalla (ver imagen
anterior), luego seleccionar _GPS_->_Preferencias_ (ver imagen a
continuación). La recogida de posiciones se efectua en segundo plano
utilzando dos ajustes:

- _Tiempo límite_ (minutos). La app intentará obtener una posición cada X
minutos.

- _Distancia límite_ (metros). Distancia mínima entre dos posiciones.

*¿Como se recogen las coordenadas GPS?*  Suponiendo que el buceadror ajusta 5
minutos y 50 metros en la pantalla de preferencias, la app tomará una posición
en el punto actual, seguida por otra cada 5 minutos *o* cada vez que nos
desplacemos más de 50 metros de la posición anterior, lo que ocurra primero.
Si las siguentes posiciones se encuentran en el radio de 50 metros indicado,
las posiciones no se guardan. Si el buceador no se mueve, solo se guardará la
primera posición. Si el buceador se mueve, se obtendrá una traza de la ruta
seguida, al guardarse las posiciones cada 50 metros.

===== Activar la recogida automática de posiciones GPS

El menú principal de _Subsurface-mobile_ tiene una casilla seleccionable en la
parte inferior izquierda etiquetada "Activar servicio de posicionamiento" (ver
imagen a continuación) Al seleccionar la casilla, el servicio se inicia y
comienza la recogida automática de posiciones.

image::images/MobileMenu.jpg["FIGURA: Subsurface-mobile menú principal",align="center"]

===== Despues de la inmersión, detener la grabación automática de GPS

Desactiva la casilla seleccionada anteriormente.

===== Subir las posiciones GPS al servidor de internet de _Subsurface_

*N.B.* La subida de posiciones GPS al servidor de internet, solo puede hacerse
si se dispone de una conexión decente, vía red telefónica o wifi. Si la red no
está disponible desde el punto de buceo, la subida de posiciones solo podrá
tener lugar cuando se haya restablecido la conexión.

Desde el menú principal de _Subsurface-mobile_, selecciona _GPS_->_Subir datos
GPS_. Comprueba el indicador en la parte de arriba de la pantalla que indica
la transferencia de información.

===== Aplicar las posiciones guardadas a las inmersiones de la lista

_Subsurface_ aplica la primera posición GPS recogida tras el comienzo de la
inmersión (hora que se obtiene del ordenador de buceo o de la información
introducida a mano) y antes del fin de la inmersión. Estas coordenadas se
muestran en el campo correspondiente del panel de Lugar de Inmersión, para
cada buceo.

El https://subsurface-divelog.org/documentation/subsurface-mobile-user-manual[manual de usuario de  _Subsurface-mobile_]
(accesible desde la app) contiene instrucciones detalladas para efectuar la
recogida, subida, gestión y sincronizado de estas información.


[[S_Companion]]
==== Importar coordenadas GPS con la app _Subsurface_ Companion para teléfonos móviles

Utilizando la app _Subsurface_ Companion en un dispositivo Android o xref:S_iphone[_iPhone_]
con GPS, se pueden pasar automáticamente las coordenadas de los
puntos de buceo al registro de _Subsurface_. La app Companion guarda las
ubicaciones de buceo en un servidor dedicado basado en internet. _Subsurface_
puede recoger las coordenadas desde este servidor.

Para hacer esto:

===== Crear una cuenta para la app Companion

 - Registrarse en la http://api.hohndel.org/login/[página web de _Subsurface_
   companion]. Se recibirá un correo de confirmación con instrucciones y un
   *DIVERID* personal, un largo número que te dará acceso a las capacidades de la
   app Companion.

 - Descargar la app desde
   https://play.google.com/store/apps/details?id=org.subsurface[Google Play Store]
   o desde
   http://f-droid.org/repository/browse/?fdfilter=subsurface&fdid=org.subsurface[F-Droid].


===== Utilizar _Subsurface_ companion en un smartphone Android

La primera vez que se utiliza, la app tiene tres opciones:

* _Create a new account_. Equivalente a registrase en la página de _Subsurface_
  companion utilizando un navegador de internet. Se puede solicitar un *DIVERID*
  con esta opción que se recibirá vía correo electrónico y se confirmará a través
  de la http://api.hohndel.org/login/[_página web de Subsurface companion] para
  activar la cuenta.

* _Retrieve an account_. Si el usuario olvidó su *DIVERID* recibirá un correo
  para recuperar el número.

* _Use an existing account_. Se pide el *DIVERID*. La app conserva el *DIVERID*
  y no lo vuelve a pedir, a menos que se utilice la opción _Disconnect_ en el menú
  (ver a continuación).

[icon="images/icons/important.png"]
[IMPORTANT]
En _Subsurface_ el DIVERID también debe marcarse en el panel Preferencias, al
que se llega seleccionando Archivo→Preferencias→Predeterminadas desde el menú
principal en el propio _Subsurface_.
Esto facilitará la sincronización entre _Subsurface_ y la app Companion.

*Crear nuevas ubicaciones de buceo*

Ahora se está preparado para tomar una posición de buceo y enviarla al servidor.
La pantalla de Android se verá como lo imagen de abajo a la izquierda (*A*),
pero sin ninguna inmersión.

Tocando el icono "+" de arriba a la derecha se abrirá un menú con tres opciones:


* Current: Se pedirá un nombre para el lugar (o que se active el GPS si estaba
  apagado). Tras lo cual se guardará la posición actual.

* Use map: Esta opción permite al usuario fijar una posición buscándola en un
  mapamundi. Se muestra un mapamundi(ver *B* a continuación) sobre el cual indicar
  la posición con una pulsación larga en la pantalla táctil (si la posición
  marcada es errónea, simplemente se indica una nueva). A continuación hay que
  seleccionar el símbolo de chequeo arriba a la derecha. Se mostrará un dialogo
  que permitirá introducir un nombre para el punto seleccionado y la fecha y hora
  del buceo (ver *C* abajo). De cara a importar esta posición de buceo a
  _Subsurface_ es recomendable fijar la misma hora de inmersión que la marcada por
  el ordenador de buceo.

image::images/Companion_5.jpg["FIGURA: Companion App, añadir posición usando e mapa",align="center"]

* Importar desde archivos GPX: El dispositivo android buscará archivos .gpx y
  mostrará los que se localicen. El archivo que se seleccione se abrirá y se
  mostrarán las posiciones que contiene. Ahora hay que elegir las ubicaciones
  correctas y luego seleccionar el símbolo de chequeo arriba ala derecha, tras lo
  cual las posiciones se enviarán al servicio web y se añadirán a la lista del
  dispositivo android.

*Listas de ubicaciones de buceo*

La pantalla principal muestra una lista de ubicaciones de buceo, cada una con un
nombre, fecha y hora (ver *A* debajo). Algunas posiciones pueden tener una
flechita sobre la casilla de selección, lo que indica que necesitan remitirse al
servidor. Se pueden seleccionar posiciones individuales de la lista. Una
posición seleccionada tiene una marca de chequeo en la casilla de selección. Se
pueden efectuar operaciones en grupo (como _Delete_ o _Send_) sobre todas las
operaciones seleccionadas a la vez.

Las posiciones de buceo de la lista pueden visualizarse de dos maneras: una
lista de ubicaciones o un mapa sobre el que se indican las posiciones. La forma
de visualizarla (lista o mapa) se modifica seleccionando _Dives_ arriba a la
izquierda de la pantalla (ver *A* abajo) y luego eligiendo el modo. Si se
selecciona una ubicación (en la lista o en el mapa), se abre un panel de edición
(ver *C abajo) donde pueden cambiarse algunos detalles.

image::images/Companion_4.jpg["FIGURE: Companion App, añadir posición usando el mapa",align="center"]

Cuando se pulsa sobre una posición (*sin* seleccionar la casilla), se mostrarán
el nombre del punto, la fecha y hora y las coordenadas GPS, con dos opciones
arriba de la pantalla:

- Edit (lapiz): Permite cambiar el nombre u otras características del punto de
  buceo.

- Maps: Muestra el punto de buceo sobre un mapa.

Tras editar y guardar la posición de buceo (ver *C* abajo), se necesita subirla
al servidor, como se explicará a continuación.

*Subir puntos de buceo*

Hay varias formas de enviar los buceos al servidor; la más fácil es simplemente
seleccionar la inmersión (ver la imagen *A* abajo) y luego pulsar la flecha
arriba a la derecha de la pantalla.

[icon="images/icons/important.png"]
[IMPORTANT]
El usuario debe tener cuidado ya que el icono de papelera de la derecha
significa exactamente lo que se supone: borra los puntos de buceo seleccionados.


image::images/Companion_1.jpg["FIGURA: Capturas (A-B) de la app companion",align="center"]

Después de un viaje de buceo usando Companion, todos los puntos de inmersión
estarán listos para ser descargados a un diario de _Subsurface_ (ver a
continuación).

*Ajustes de la Companion app*

Seleccionar la opción Settings del menú, resulta en la imagen B de arriba a la
derecha.

_Server and account_

 - _Web-service URL_. Esta está predefinida (http://api.hohndel.org/)

 - _User ID._ El DIVERID obtenido al registrarse como indicábamos antes. La forma
   más fácil de introducirlo es simplemente copiar y pegar desde el correo de
   confirmación pero, desde luego, el usuario teclearlo carácter a carácter.

_Synchronization_

 - _Synchronize on startup_. Si se selecciona, los puntos de buceo del
   dispositivo android y los del servicio web se sincronizarán cada vez que se
   inicie la app.

 - _Upload new dives_. Si se selecciona, cada vez que el usuario añada una
   ubicación de buceo, se enviará automáticamente al servidor.

_Background service_

En vez de tomar una sola ubicación de buceo, los usuarios pueden dejar el
servicio ejecutándose en segundo plano en tu dispositivo android, tomando
continuamente posiciones GPS

Los ajustes, a continuación, definirán el comportamiento del servicio:

 - _Min duration_. En minutos. La app intentará tomar una posición cada X minutos
   hasta que el usuario la detenga.

 - _Min distance_. En metros. Distancia mínima entre dos posiciones.

 - _Name template_. La plantilla de nombre que usará la app cuando guarde las
   posiciones.

[icon="images/icons/info.jpg"]
[TIP]
_¿ Como trabaja el servicio en segundo plano ?_ Suponiendo que el usuario ha
fijado 5 minutos y 50 metros en los ajustes anteriores, la app tomará una
posición en la ubicación actual, seguida por otra cada 5 minutos *o* cada vez
que se desplace 50 metros de la posición anterior. Si las siguientes ubicaciones
están en el radio de 50 metros de la anterior, no se guardarán. De esta forma,
si el usuario no se está moviendo, solo se guarda una posición, pero si se
mueve, puede llegar a tener una traza de su viaje al guardar una ubicación cada
50 metros.

_Other_

 - _Mailing List_. El buzón de correo de _Subsurface_. El usuario enviar mails a
   la lista de correo de _Subsurface_.

 - _Subsurface  website_. Un link a la URL de la página de _Subsurface_.

 - _Version_. Muestra la versión actual de la app Companion.

_Search_

Se utiliza para buscar en las ubicaciones de buceo guardadas, por nombre o por
fecha y hora.

_Start service_

Inicia el servicio en segundo plano siguiendo los ajustes previamente definidos.


_Disconnect_

Esta opción está mal nombrada. "Desconecta" la app del servidor reseteando el
DIVERID en la app, y retorna a la primera pantalla desde la que se puede crear
una cuenta, reactivar el DIVERID o volver a poner el del usuario. Desconectar
puede ser útil si se desea descargar a un dispositivo android posiciones de otro
buceador registrado o enviar la posición actual al servidor con el ID de otro
buceador registrado.

_Send all locations_

Esta opción envía todas las posiciones guardadas en el dispositivo android al
servidor.

[[S_iphone]]
===== Usar la app Subsurface companion en un _iPhone_ para registra puntos de buceo

El interfaz de iPhone es bastante simple. Se necesita introducir la ID de
usuario (obtenida durante el registro) en el espacio reservado para ello, luego
seleccionar "Dive in" (ver parte izquierda de la imágen de abajo) y se empieza
a recoger información de las ubicaciones.

image::images/iphone.jpg["FIGURE: Usiar la aplicación iPhone companion",align="center",width=640]

Las inmersiones se pueden añadir de forma automática o manual. En modo manual,
se añade una sola ubicación de buceo o "waypoint" al flujo de entrada de datos
del GPS. En modo automático se crea una traza continua de posiciones GPS de las
cuales, posteriormente, después de haberse importado, _Subsurface_ puede
seleccionar las posiciones correctas en base a las horas de los buceos. El modo
por defecto para el _iPhone_ es el automático.  Cuando se añade una inmersión,
el servicio de posicionamiento se inicia automáticamente y aparece una barra
roja en la parte de abajo de la pantalla. Tras el buceo, se puede hacer clic en
la barra roja para detener el servicio de posicionamiento. Mientras el servicio
se está ejecutando, solo se pueden añadir inmersiones usando el mecanismo
manual.

Se puede editar el nombre del punto de buceo posteriormente, seleccionando la
inmersión de la lista y clicando en el nombre. No hay otros campos editables.
La lista se sube automáticamente desde el _iPhone_ al servicio web y no hay
opción a hacerlo manualmente.

*Descargar ubicaciones de buceo al diario en _Subsurface_*

Hay que descargar a _Subsurface_ las inmersiones del ordenador de buceo, o
crearlas manualmente, antes de obtener las coordenadas del servifor. El diálogo
de descarga se puede obtener vía _Ctrl+G_ o desde el menú principal de
_Subsurface_, _Importar → Importar datos GPS del servicio Subsurface_,
resultando la imagen de abajo a la izquierda (A). La primera vez que se use, el
campo DIVERID estará en blanco. Introducir el DIVERID. Después se pulsa el botón
Descargar y comenzará la descarga, tras lo cual aparece la pantalla de abajo a
la derecha (*B*):

image::images/DownloadGPS.jpg["FIGURE: Descargar datos GPS de la app Companion]",align="center"]

Nótese que ahora está activo el botón _Aplicar_. Pulsarlo para actualizar las
inmersiones recién creadas o descargadas a _Subsurface_, lo cual aplicará las
coordenadas y los nombres que se hayan dado en la app en todas las inmersiones
en las que coincidan las fechas y las horas de las posiciones GPS descargadas.
Si se ha introducido en _Subsurface_ el nombre del punto de buceo antes de
descargar las coordenadas GPS, este nombre tendrá preferencia sobre los
descargados.

Ya que _Subsurface_ busca coincidencias entre las localizaciones GPS del
dispositivo android y la información del ordenador de buceo basándose en la
fecha y la hora, la asignación automática depende de la coincidencia entre los
datos de ambos dispositivos. Aunque _Subsurface_ tiene un margen de tolerancia
muy amplio, puede ser incapaz de identificar la inmersión correcta, si hay mucha
diferencia entre la hora del ordenador de buceo y la del dispositivo android,
resultando en que no haya actualización.

Fechas y horas similares en los dispositivos no siempre son posibles y puede
haber muchas razones para ello (p.e. zonas horarias), o _Subsurface_ puede ser
incapaz de decidir cual es la posición correcta de una inmersión (p.e. en
inmersiones repetitivas mientras se ejecuta el servicio en 2º plano puede haber
varios puntos incluidos en el rango de tiempo que casen no solo para la primera
inmersión, sino también para las siguientes). Una solución alternativa para esta
situación sería editar manualmente la hora en la lista de inmersiones de
_Subsurface_ *antes* de descargar los datos GPS, para hacerla coincidir con la
de estos, y luego volver a cambiarla a la correcta *después* de la descarga.

[icon="images/icons/info.jpg"]
[NOTE]
SUGERENCIAS:

 - El servicio en segundo plano es una herramienta poderosa, pero puede llenar la
   lista de localizaciones con muchas posiciones innecesarias que no correspondan a
   los puntos exactos de buceo, sino a la ruta seguida por el barco. Actualmente,
   borrar estas posiciones del servidor resulta difícil. En algunas situaciones
   resulta, pues, prudente limpiar la lista del dispositivo android antes de enviar
   los puntos al servidor simplemente borrando los que no sean correctos. Esto
   puede ser necesario, por ejemplo, si se desea mantener limpia la lista de
   ubicaciones para poder visualizarlas en el mapa del servidor o del dispositivo
   android.

 - También tendría sentido proporcionar nombres significativos a las
   localizaciones enviadas al servidor o, al menos, usar tal nombre en el ajuste
   _Name Template_ si se va a ejecutar el background service, especialmente durante
   los viajes de buceo con muchas inmersiones y puntos de buceo.

[[S_LoadImage]]

=== El cargador de fotografías de _Subsurface_

Muchos buceadores (si no la mayoría) toman fotografías durante sus inmersiones.
_Subsurface_ nos permite almacenar y mostrar fotogrfías de cada inmersión. Las
fotos se superponen en el perfil de la inmersión, en los momentos donde se
tomaron y pueden visualizarse desde allí.

==== Cargar fotos y sincronizar la cámara con el ordenador de buceo

Se selecciona una inmersión o un grupo de ellas en la lista. Luego se hace
clic-derecho en la selección lo que nos mostrará el xref:S_DiveListContextMenu[Menú contextual de la lista de inmersiones].
Hacemos click-izquierdo en la opción apropiada para cargar las imágenes desde
un archivo o desde internet y aparecerá el navegador del sistema. Selecciona
la carpeta y las fotografías que necesiten cargarse en _Subsurface_ y clica el
botón _Abrir_.

image::images/LoadImage2_f20.jpg["FIGURA: Opción de carga de imágenes",align="center"]

Si las fotos se importan desde Internet, indica una URL que apunte a una sola
fotografía. Si se indica una carpeta no se importan: las fotos de internet se
importan una a una. Si las fotos se cargan desde internet, _Susbsurface_
supone que existe una conexión activa cada vez que se visualiza una foto.

Tras haber seleccionado la carpeta local o la imagen de internet, se desplegará
el diálogo de sincronización que se muestra a continuación. El
problema crítico es que la sincronización horaria entre la cámara y el ordenador
de buceo no sea perfecta, en ocasiones difieren varios minutos. Si _Subsurface_
puede sincronizarlos, entonces puede utilizar las horas de las fotografías para
posicionarlas en el perfil de la inmersión.

_Subsurface_ puede conseguir esta sincronización de tres maneras:

 - *Proactivamente*: Antes de la inmersión, asegúrate de que los ajustes de la
   cámara coinciden con los del ordenador de buceo, cambiándolo en uno de los
   dispositivos o en ambos.

 - *Manualmente*: Si el usuario anotó la hora exacta de la cámara al inicio de la
   inmersión, se puede obtener la diferencia de tiempo entre los dos dispositivos.
   En realidad, si no se han variado los ajustes horarios, se pueden conseguir tras
   la inmersión o, incluso, al final del día. Entonces se puede indicar manualmente
   la diferencia en el diálogo de _Desplazamiento horario_. En la parte de arriba
   del diálogo hay una herramienta para indicar tiempos, evidente en la figura *A*
   a continuación. Si la cámara lleva un adelanto de 7 minutos sobre el ordenador
   de buceo, fijamos en la herramienta un valor de 00:07. Se ignora cualquier
   sufijo "AM" o "PM". Seleccionamos el botón _OK_ y se habrá obtenido la
   sincronización. Hay que marcar _Más pronto_ o _Más tarde_ según corresponda. En
   el ejemplo a continuación, la opción _Más pronto_ es la correcta ya que la
   cámara de fotos va 7 minutos por delante del ordenador de buceo.

image::images//LoadImage3b_f23.jpg["FIGURA: Diálogo de sincronización",align="center"]

 - *Por fotografía*: Hay una forma muy cómoda de conseguir sincronización. Si se
   toma una foto de la pantalla del ordenador mostrando la hora, _Subsurface_ puede
   obtener la hora exacta a la que se tomó la foto usando los metadatos que la
   cámara guarda en cada foto. Para ello se utiliza la mitad inferior del diálogo
   _Desplazamiento horario_. Si se selecciona la barra horizontal titulada
   "_Selecciona la imagen del ordenador de buceo mostrando la hora_", aparece un
   navegador de archivos. Se selecciona la fotografía y se pulsa _Abrir_. La foto
   del ordenador de buceo aparecerá en el recuadro inferior del diálogo.
   _Subsurface_ sabe exactamente cuando se tomó la foto. Ajusta la fecha y hora en
   el diálogo a la izquierda de la foto para que refleje los de la pantalla del
   ordenador. Tras el ajuste _Subsurface_ conoce exactamente cual es la diferencia
   entre cámara y ordenador y se podrán sincronizar. La figura a continuación
   muestra una
   fotografía del ordenador de buceo y la herramienta de tiempo ajustada a la
   fecha y hora.

image::images/LoadImage3c_f23.jpg["FIGURE: Diálogo de sincronización",align="center"]

Si la hora de la foto es muy anterior o posterior al buceo, no se sitúa sobre el
perfil de la inmersión (ver el aviso en rojo de la imágen anterior). Sin
embargo, si se selecciona la casilla apropiada (ver imágen anterior) estas
fotos aún pueden situarse en la pestaña _Fotos_ del panel de *Notas* de forma
que todas las fotos asociadas con un buceo puedan visualizarse, incluidas las
que se hayan tomado antes o despues de la inmersión.

==== Visualizar las imágenes

Después que las imágenes han sido cargadas aparecen en dos lugares:

 - La pestaña _Fotos_ del panel _Notas_ (lado izquierdo de la imágen a
continuación).
 - Como pequeños iconos (chinchetas) sobre el perfil de inmersión, en posiciones
   que relejan la hora en que se tomó cada fotografía. Para ver las fotos sobre el
   perfil, activa el botón _Mostrar fotos_ a la izquierda del perfil:

image::images/icons/ShowPhotos_f20.png["FIGURE:Show photos toolbar button",align="left"]

Esto producirá un perfil como el que se muestra a continuación

image::images/LoadImage4_f20.jpg["FIGURA: Fotos sobre un perfil de inmersión",align="center"]

Si se sitúa el ratón sobre uno de los iconos, se mostrará una versión reducida
de la foto. Ver imagen a continuación:

image::images/LoadImage5_f20.jpg["FIGURA: Foto reducida sobre perfil de inmersión",align="center"]

Si hacemos clic sobre la imagen reducida aparecerá la fotografía a tamaño
completo sobre la ventana de _Subsurface_. Esto permite una buena visión de las
fotos que han sido importadas. Ver imagen a continuación.
Cada imagen reducida tiene una pequeña papelera en su esquina superior
izquierda (ver imagen anterior). Si se selecciona la papelera, la foto se
borra de la inmersión, así pues, hay que tener un poco de cuidado al clicar
sobre las imágenes. Las imágenes  también puede borrase desde la pestaña _Fotos_
(ver en el siguiente punto).

image::images/LoadImage6_f20.jpg["FIGURA: Foto a pantalla completa sobre el perfil de inmersión",align="center"]

==== La pestaña _Fotos_

Las fotografías asociadas a una inmersión se muestran como miniaturas en la
pestaña _Fotos_ del _Panel de inmersión_. Se puede acceder con facilidad a las
fotos hechas en rápida sucesión durante la inmersión, desde la pestaña _Fotos_.
Esta pestaña es una herramienta para acceder individualmente a las fotos de un
buceo, mientras que las "chinchetas" en el perfil de inmersión proporcionan una
indicación de cuando se tomó la foto. Clicando una sola vez sobre una de la
miniaturas de la pestaña _Fotos_, seleccionamos una foto. Haciendo doble-clic
sobre una miniatura, se muestra la imagen a tamaño completo superpuesta a la
ventana de _Subsurface_. Podemos borrar una foto desde la pestaña _Fotos_
seleccionándola (un solo clic) y pulsando a continuación la tecla _Supr_ en el
teclado. Esto eliminará la foto tanto de la pestaña _Fotos_ como del _Perfil de
la inmersión_.

==== Fotos en disco duro externo

La mayoría de fotosubs guardan sus fotografías en un disco duro externo. Si este
disco puede mapearse (como es casi siempre el caso) _Subsurface_ puede acceder
directamente a las fotos. Esto facilita la interacción entre _Subsurface_ y un
repositorio externo de fotos. Cuando se asocia un perfil de inmersión con fotos
de un disco externo se utiliza el procedimiento normal de selección
y sincronización (ver en el texto anterior). Sin embargo, después de que el
disco externo haya sido desconectado, _Subsurface ya no podrá acceder a las
fotos. Si se ha activado la visualización de fotos sobre el perfil (utilizando
la barra de herramientas a la izquierda del perfil), el programa solo mostrará
unos pequeños puntos blancos donde deberían mostrarse las fotos. Además, la
pestaña _Fotos_ solo mostrará los nombres de los archivos de las imágenes. Este
es el funcionamiento normal. Si, posteriormente, el disco externo con las fotos
se vuelve a conectar, las fotos se visualizarán normalmente.

==== Averiguar que inmersiones tienen fotos asociadas
Inspeccionar cada inmersión individual para saber si tiene asociadas fotos
puede llevarnos mucho tiempo. Hay una forma rápida de saber que inmersiones
tiene asociadas fotos y cuales no: activa la casilla _Fotos_ en la lista
desplegable que se obtiene al hacer clic-derecho en la barra de encabezamiento
de la *Lista de Inmersiones*, todos los buceos con fotos asociadas mostrarán
un icono indicando si las fotografías se tomaron durante la inmersión, antes,
después o todo ello. Hay más información en la sección del manual que cubre
los <<S_Divelist_columns, iconos de fotos en la *Lista de Inmersiones*>>.

[[S_FindMovedImages]]
==== Mover fotografías entre directorios, discos duros u ordenadores

Tras haber cargado una fotografía en _subsurface_ y haberla asociado a un buceo
determinado, se archiva el directorio donde la foto permanece guardada, para poder
encontrarla cuando se vuelva a abrir la inmersión. Si la foto o la colección
completa de fotos se trasladan a otro disco o a una máquina distinta, la ruta
a la imágen cambia.
Cuando esto sucede, _Subsurface_ busca las fotos en el directorio original
desde el que fueron cargadas, no las encuentra y, por tanto,
no las puede mostrar. Ya que, después de mover fotos, un gran número puede
necesitar borrarse y reimportarse desde la nueva localización, _Subsurface_
tiene un mecanismo que facilita el proceso de actualizar la información del
directorio para cada foto: actualizaciones automáticas utilizando huellas.

Cuando se carga una foto en _Subsurface_, se calcula una huella para la imagen
y se guarda con la otra información de referencia para la foto. Tras mover una
colección de fotos (que ya ha sido cargada en _Subsurface_) a un directorio,
disco u ordenador diferente, _Subsurface_ puede llevar a cabo los siguientes
pasos:

- Buscar en un directorio concreto (y todos sus subdireectorios recursivamente)
al que se han llevado las fotos.

- Calcular huellas para todas las fotos de este directorio, y

- si hay coincidencia entre una de las huellas calculadas y la que se calculó
al cargar la foto en _Subsurface_ (incluso si el nombre del archivo hubiera
cambiado), actualizar automáticamente la información de directorio, de foma que
_Subsurface_ pueda encontrar la foto en el nuevo directorio.

Esto se consigue seleccionando desde el Menú Principal: _Archivo -> Encontrar
imágenes desplazadas_. Esto presenta una ventana en la cual es necesario
especificar el NUEVO directorio de las fotos. Se selecciona el directorio
apropiado y se clica el botón _Escanear_ en la parte inferior derecha del
panel. El proceso puede requerir varios minutos para completarse, tras lo
cual _Subsurface_ mostrará las fotos correctas cuando se abra un buceo.

[[Image_fingerprint_upgrade]]
****
*Actualizar colecciones de fotos existentes sin huella*
[icon="images/icons/important.png"]
[IMPORTANT]

_Subsurface_ calcula automáticamente huellas para todas las imágenes a las
que tiene acceso. Cuando manipules estas imágenes, asegúrate de que todas las
imágenes asociadas al divelog queden accesibles.  _Subsurface_, automáticamente
comprueba y actualiza (en caso necesario) las huellas asociadas a cada buceo
si:
- Las imágenes asociadas a ese buceo son visibles como miniaturas en el perfil.
- Se edita cualquier cosa en el panel *Notas* y se guardan las modificaciones
con _Guardar cambios_.

****

=== Registrar tipos de inmersión especiales

Esta sección da ejemplos de la verstilidad de _Subsurface_ como herramienta de
registro de inmersiones.

[[S_MulticylinderDives]]
==== Inmersiones multi botella

_Subsurface_ maneja fácilmente inmersiones que requieren más de una botella. El
buceo multi botella se produce habitualmente cuando (a) un buceador no tiene
bastante gas para completar una inmersión con una sola botella o (b) cuando el
buceador necesita más de una mezcla de gas a causa de la profundidad o de las
necesidades descompresivas de la inmersión. Por este motivo, las inmersiones
multi tanque son empleadas a menudo por los buceadores técnicos ya que bucean
profundo y durante mucho tiempo. En lo que corresponde a _Subsurface_, solo hay
dos clases de información que necesitan proporcionarse:

- *Describir las botellas usadas durante el buceo*. Esto se hace en la pestaña
  *Equipo* del panel *Información* tal como xref:cylinder_definitions[se describe anteriormente].
  se introducen las botellas una a una, especificando las características de la
  botella y la composición del gas de cada una de ellas.

- *Registrar los momentos en que se cambia de una botella a otra*. Esta es una
  información que facilitan algunos ordenadores (siempre y cuando el buceador
  se la diga al ordenador durante el buceo). Si el ordenador no la proporciona,
  el buceador necesita registrarla usando un método diferente, p.e. en una
  pizarra.

- *Indica los cambios de botella en el perfil*. Si se utilizó la última opción,
  el buceador ha de indicar el evento de cambio de gas haciendo clic derecho en
  el momento adecuado del panel *Perfil de inmersión* y señalar la botella a la
  que se cambió. Tras hacer clic derecho, seguir el menú contextual a "Añadir
  cambio de gas" y seleccionar la botella apropiada entre las definidas en el
  primer paso (ver imagen a continuación). Si el botón *Barra de botellas* de
  la barra de herramientas se ha activado, los cambios también se indicarán en
  la barra (ver imágen a continuación).

Habiendo llevado a cabo estas tareas, _Subsurface_ indica en el perfil de buceo
el uso de diferentes botellas.  A continuación, una inmersión con dos botellas
que empieza con EAN28, se cambia a EAN50 despues de 26 minutos para efectuar la
deco.

image::images/multicylinder_dive.jpg["FIGURa: Perfil multi tanque",align="center"]

==== Inmersiones en montaje lateral (sidemount)

El buceo en montaje lateral es solo otra forma de buceo multi botella, a menudo
con ambas o todas las botellas conteniendo la misma mezcla. Aunque es una
configuración popular entre los espeleo buceadores, el buceo en lateral se
puede efectuar por buceadores recreativos que hayan completado el entrenamiento
adecuado.  Registrar inmersiones en sidemount se hace en tres pasos:

- *Durante el buceo, se registran los eventos de cambio de botella". Ya que bucear
  en lateral supone, normalmente, usar 2 botellas con aire o con la misma mezcla,
  _Subsurface_ distingue entre estas botellas. En comparación, la mayoría de
  ordenadores de buceo que contemplan cambios de gas solo distinguen entre
  diferentes _gases_ usados, no entre diferentes _botellas_ usadas. Esto supone
  que, cuando se descargan inmersiones en sidemount desde estos ordenadores, los
  eventos de cambio entre las diferentes botellas no se descargan. Esto puede
  suponer  que se tenga que guardar un registro manual de cambios de botella o
  (si el ordenador tiene esta posibilidad) marcando cada cambio de botella con
  una marca que se pueda descargar posteriormente. Regresar de una inmersión
  en lateral con la información de cambios de botella es la única parte con
  truco en cuanto a registrar buceos en sidemount.
- *En _Subsurface_ detalla las botellas usadas en la inmersión*. El usuario
  registra las especificaciones para las diferentes botellas usando la pestaña
  *Equipo* del *Panel de información* (véase imagen a continuación en la que se
  usó una botella de 12 litros).
- *Indicar eventos de cambio de botella sobre el perfil de _Subsurface_*. Una
  vez que se ha importado la inmersión desde el ordenador de buceo, es necesario
  indicar los eventos de cambio de botella sobre el perfil. Los cambios se
  anotan haciendo clic-derecho en el punto correspondiente del perfil y entonces
  seleccionando _Añadir cambio de gas_. Se muestra una lista de las botellas con
  la que se está utilizando en gris. En la imagen a continuación, Tank 1 está en
  gris, permitiendo solo la selección de Tank 2. Tras seleccionar la botella
  correspondiente el cambio se indicará sobre el perfil con un icono de una
  botella. Si está activada la *Barra de botellas* también se indicará el cambio
  sobre ella (ver imagen a continuación). Una vez que todos los cambios de
  botella han sido registrados sobre el perfil, las presiones correctas de ambas
  botellas se mostrarán en el perfil, como en la imagen de ejemplo.

image::images/sidemount1.jpg["FIGURE: Sidemount profile",align="center"]

[[S_sSCR_dives]]
==== Inmersiones con rebreather de circuito semi cerrado (SCR)

[icon="images/halcyon_RB80.jpg"]
[NOTE]
Los rebreathers semi cerrados pasivos (pSCR) suponen un avance técnico en el
equipo de buceo que recircula el gas que el buzo respira, y elimina el dióxido
de carbono del gas exhalado. Al tiempo que una pequeña cantidad del gas exhalado
(habitualmente una décima parte) se libera en el agua, una  pequeña cantidad de
gas de la botella se introduce en el circuito (habitualmente nitrox). Un buzo
usando una sola botella de gas puede, pues, bucear durante periodos de tiempo
mucho mayores que utilizando una configuración recreativa de circuito abierto.
Con los pSCR una cantidad muy pequeña de gas se libera cada vez que el buzo
inhala. Con los equipos SCR activos (aSCR), en cambio, una pequeña cantidad del
gas respirado se libera continuamente.

Para registrar inmersiones con pSCR, no se requieren procedimientos especiales,
solo los pasos normales descritos con anterioridad:

- Seleccionar el modo pSCR en el desplegable _Modo de inmersión_ en el panel
  *Información*.

- El buceo con pSCR, a menudo, requiere cambios de gas, necesitando una botella
  adicional. Hay, pues, que describir todas las botellas como se indicó con
  anterioridad e indicar los cambios de botella/gas como se explicó en la
  sección xref:S_MulticylinderDives[Inmersiones multi botella].

Si se ha seleccionado pSCR en el _Modo de inmersión_, el techo de buceo para
inmersiones pSCR se ajusta para la caída de oxígeno a través de la boquilla
que, a menudo, requiere mayores períodos de descompresión. A continuación un
perfil de inmersión de un buceo con pSCR usando EAN36 como gas de fondo y
oxígeno para la descompresión. Fíjate que la inmersión duró unas dos horas.

image::images/pSCR_profile.jpg["FIGURA: Perfil pSCR",align="center"]


[[S_CCR_dives]]
==== Inmersiones con rebreather de circuito cerrado (CCR)

[icon="images/APD.jpg"]
[NOTE]
Los rebreathers de circuito cerrado utilizan tecnología avanzada para
reciclar el gas que se ha respirado, mientras mantienen una concentración de
oxígeno respirable llevando a cabo dos acciones:
a) Eliminan dióxido de carbono del gas que se ha exhalado.
b) Regulan la concentración de oxígeno para que permanezca en los límites.
La interfaz CCR de _Subsurface_ es experimental actualmente y se halla bajo
desarrollo activo. _Subsurface_ soporta en estos momentos el Poseidon MKVI y
los PD Discovery/Evolution  En contraste con un ordenador
de buceo recreativo convencional, el ordenador de un sistema CCR no permite
descargar un diario que contenga múltiples inmersiones. En su lugar, cada buceo
se guarda independientemente. Esto significa que _SUbsurface_ no puede descargar
el diario directamente desde un CCR, sino que lo importa de la misma manera que
se importan datos de otras bases de datos digitales, una inmersión cada vez.

===== Importar una inmersión con CCR

Véase la sección que trata de  xref:S_ImportingAlienDiveLogs[Importar información de buceo de otras fuentes digitales].
Los datos de las inmersiones con CCR se obtienen desde el software propietario
obtenido al adquirir el equipo CCR.  Vease <<_appendix_b_dive_computer_specific_information_for_importing_dive_information,Apéndice B>>
para mayor información. Utiliza dicho software para descargar los datos del
buceo a una carpeta conocida. Desde el menú principal de _Subsurface_,
seleccionar _Import -> Importar archivos de registro_ para desplegar el
xref:Unified_import[Diálogo de importación universal].
Como se explicaba en esa sección, en la parte de abajo a la derecha hay una lista
desplegable (etiquetada como _Filtro:_) de dispositivos que incluye los archivos del
(Poseidon) MKVI o APD (la funcionalidad para otros dispositivos CCR está en desarrollo
actualmente). Tras haber seleccionado el dispositivo y el directorio donde se
hallan los archivos originales del ordenador CCR, se puede seleccionar un
archivo concreto (en el caso del MKVI es un archivo con extensión .txt). Tras
seleccionar el archivo, activar el botón _Abrir_ de abajo a la derecha. Lee la
sección a continuación para:

===== Información mostrada para un buceo con CCR

_Presiones parciales de los gases_: El gráfico de presión parcial de oxígeno
muestra la información de los sensores de oxígeno del equipo CCR. A diferencia
del equipo de circuito abierto (donde los valores de pO~2~ se calculan en base
a la composición del gas y la profundidad), los equipos CCR proporcionan
mediciones instantáneas de pO~2~, a partir de sensores de oxígeno. En este
caso el gráfico de presión parcial de oxígeno debería se bastante plano,
reflejando el ajuste del setpoint  durante la inmersión. La pO~2~ media no es
la media de presiones parciales de oxígeno que facilita el equipo CCR, sino
un valor calculado por _Subsurface_ de la siguiente forma:

- Para DOS sensores de O~2~ se da en valor medio de ambos sensores.

- Para sistemas de TRES sensores (p.e. APD), también se usa la media. Sin
  embargo las lecturas simultaneas de diferentes sensores con diferencias de
  más de 0,1 bar, se consideran falsas y se ignoran.

La pO~2~ media de los sensores se indica con una línea verde.

El valor del setpoint así como las lecturas de de los sensores de oxígeno
individuales puede mostrarse. La presentación en pantalla de información CCR
adicional se activa seleccionando las opciones adecuadas en el panel _Preferencias_
(accesible seleccionando xref:S_CCR_options[_Archivo ->  Preferencias ->  Gráfico_]).
Esta parte del panel _Preferencias_, mostrada en la siguiente imagen,  se
presenta como dos casillas seleccionables que modifican la presentación de la
pO~2~ cuando se halla activada la opción correspondiente de la barra de herramientas
del Perfil de Inmersión.

image::images/CCR_preferences_f20.jpg["FIGURA: Panel de preferencias de CCR",align="center"]

Clicar cualquiera de las casillas seleccionables permite mostrar información
adicional relativa al oxígeno, siempre que el botón pO~2~ de la barra de
herramientas del panel _Perfil_ esté activado.

La primera casilla permite mostrar información del setpoint. Esta es una línea
roja superpuesta al gráfico verde de presión parcial de oxígeno y permite
comparar la media de presiones parciales de oxígeno medidas, frente al valor
del setpoint, como se muestra a continuación.

image::images/CCR_setpoint_f20.jpg["FIGURA: Gráfico de pO2 y setpoint del CCR",align="center"]

La segunda casilla permite mostrar datos de cada sensor de oxígeno individual
del equipo CCR. Los datos de cada sensor se colorean de la siguiente forma:

- Sensor 1: gris
- Sensor 2: azul
- Sensor 3: marrón

La media de pO~2~ se indica por la línea verde. Así se pueden comparar los
datos de cada uno de los sensores de oxígeno, lo cual es útil para detectar
lecturas erráticas o anormalmente bajas de un sensor en particular.

image::images/CCR_sensor_data_f20.jpg["FIGURA: Gráfico de datos de los sensores del CCR",align="center"]

El dato del setpoint puede ser superpuesto sobre los datos de los sensores de
oxígeno activando ambas casillas. Las presiones parciales del nitrógeno y del
helio (en su caso) se muestran de la forma habitual para las inmersiones OC.

_Eventos_: Se registran diversos eventos, p.e. los cambios a circuito abierto
de la boquilla.  Estos eventos se muestran como triángulos amarillos y, si se
pasa el ratón sobre el icono, se da una descripción del evento en la línea
inferior del xref:S_InfoBox[Recuadro de información].

_Presiones de las botellas_: Algunos ordenadores de buceo CCR, como el MKVI de
Poseidon, registran las presiones de las botellas de oxígeno y diluyente. Las
presiones de estas dos botellas se muestran como líneas verdes sobre el perfil
de la inmersión. Además, las presiones iniciales y finales de ambas botellas se
muestran en la pestaña _Equipo_. A continuación, un perfil de inmersión con CCR
incluyendo capas con el setpoint, las lecturas de los sensores de oxígeno y la
información de presión de las botellas. En este caso hay una buena coincidencia
entre las lecturas de los dos sensores de oxígeno.

image::images/CCR_dive_profile_f22.jpg["FIGURA: Perfil de inmersión con CCR",align="center"]

_Información especifica del equipo_: _Subsurface_ recoge información que puede
ser especifica de un tipo de equipo concreto. Se muestra en la xref:S_ExtraDataTab[pestaña Otros Datos].
Puede incluir información de ajustes o metadatos sobre la inmersión.

El techo calculado por _Subsurface_ no es muy preciso dado que no se puede
determinar fiablemente la presión de nitrógeno en el circuito desde el divelog
importado del equipo del CCR. Muchos ordenadores de buceo CCR, sin embargo,
informan del techo calculado internamente por ellos mismos y este se mostrará
en el perfil activando el botón correspondiente a la izquierda del perfil:

image::images/icons/cceiling.jpg["Icono de techo"]

El color por defecto del techo de deco generado por el ordenador es blanco. Sin
embargo, puede ajustarse a rojo seleccionando la correspondiente casilla en
_Archivo -> Preferencias -> Gráfico_. A continuación se muestra un perfil
mostrando el techo deco generado por el ordenador de buceo:

image::images/CCR_dive_ceilingF22.jpg["FIGURA: Perfil de inmersión con CCR"]

Se puede encontrar más información, específica para cada ordenador, sobre
como descargar divelogs de CCR en el xref:_appendix_b_dive_computer_specific_information_for_importing_dive_information[Apéndice B]

== Obtener más información sobre inmersiones guardadas en el diario

=== La pestaña Información (para inmersiones individuales)

La pestaña Información proporciona alguna información resumida
sobre un buceo en particular que ha sido seleccionado en la *Lista de
inmersiones*. La información útil incluye el intervalo en superficie antes de la
inmersión, las profundidades máxima y media, el volumen de gas consumido, el
C.A.S. (consumo de aire en superficie) y el número de unidades de toxicidad de
oxígeno (OTU) en las que se ha incurrido.

[icon="images/icons/info.jpg"]
[NOTE]
Consumo de gas y cálculos de CAS: _Subsurface_ calcula el CAS y el consumo de gas
teniendo en cuenta la incompresibilidad de los gases, particularmente a
presiones en las botellas superiores a 200 bar, haciéndolos más precisos. Los
usuarios deberían consultar el xref:SAC_CALCULATION[Apéndice F] para más información.

[[S_ExtraDataTab]]
=== La pestaña *Otros datos* (para inmersiones individuales)

Cuando se utiliza un ordenador de buceo, a menudo facilita determinadas
informaciones que no pueden presentarse de forma estandarizada ya que la
naturaleza de la información varía de un ordenador a otro.  Estos datos suelen
comprender informaciones de ajustes, metadatos sobre una inmersión, niveles de
batería, tiempos de "no vuelo" o factores de gradiente usados durante el buceo.
Si es posible, toda esta información se presenta en la pestaña *Otros datos*. A
continuación hay una imagen que muestra otros datos para un buceo con un
rebreather Poseidon.

image::images/ExtraDataTab_f20.jpg["FIGURA: Pestaña Otros datos",align="center"]

=== La pestaña Estadísticas (para grupos de inmersiones)

La pestaña Estadísticas facilita información resumida para más de una inmersión,
suponiendo que se haya seleccionado más de un buceo en la *Lista de inmersiones*
tcon los estándares "Ctrl+clic" o "Shift+clic" del ratón. Si solo se ha
seleccionado una los cálculos se efectuarán solo para esa inmersión. Esta
pestaña muestra el número de inmersiones seleccionadas, el tiempo total de buceo
para estas inmersiones, así como los máximos, mínimos y medios para la duración,
profundidad, temperatura en agua y superficie y CAS. También muestra la
profundidad máxima de las inmersiones más profunda y más superficial de las
seleccionadas.

[[S_DiveProfile]]
=== El Perfil de inmersión

image::images/Profile2.jpg["Típico perfil de buceo",align="center"]

De todos los paneles de _Subsurface_, el Perfil contiene la información más
detallada de cada inmersión. El perfil de inmersión tiene una *barra de botones*
en el lado izquierdo que permite controlar varias opciones. Las funciones de
estos botones se describen más adelante. El objeto principal del perfil de
inmersión es el gráfico de profundidad en función del tiempo. Además de la
información obvia acerca de la profundidad, también muestra los ratios de
ascenso y descenso en relación a las velocidades de ascenso y descenso
recomendadas. Esta información se proporciona utilizando diferentes colores:
|====================
|*Color*|*Velocidad de descenso (m/min)*|*Velocidad de ascenso (m/min)*
|Rojo |> 30|> 18
|Naranja|18 - 30|9 - 18
|Amarillo|9 - 18|4 - 9
|Verde claro|1.5 - 9|1.5 - 4
|Verde oscuro|< 1.5|< 1.5
|====================

El perfil también incluye lecturas de profundidad para los picos y valles del
gráfico. De esta forma, se debe poder visualizar la profundidad del punto más
hondo y otros picos. La profundidad media se muestra como una línea gris que
indica la profundidad media en cada momento de la inmersión.

[icon="images/icons/scale.jpg"]
[NOTE]
En algunos casos el perfil de inmersión no llena el área completa del panel.
Hacer clic en el botón Escala de la barra de herramientas de la izquierda,
habitualmente, incrementa el tamaño del perfil hasta llenar el área de forma
eficiente

*La temperatura del agua* se muestra con su propia línea azul con valores
situados junto a cambios significativos.

[[S_InfoBox]]
==== La *Caja de información*
La caja de información proporciona una gran cantidad de datos sobre el perfil
de la inmersión. Normalmante, la caja de información se localiza en la esquina
superior izquierda del panel del perfil. Si el ratón apunta fuera del panel
del perfil, solo se mostrará la linea superior de la caja (ver la parte
izquierda de la figura *A* a continuación). La caja de información puede
desplazarse por el panel del Perfil de la inmersión, seleccionandolo y
arrastrandolo con el ratón, de forma que no cubra alguna información
importante del perfil. La posición del panel se guarda y se reutiliza en
posteriores ocasiones.

image::images/InfoBox2.jpg["Figure: Information Box",align="center"]

Cuando el ratón apunta en el interior del panel del Perfil, la caja de
información se expande y muestra diversas lineas de información. En esta
situación, los datos reflejan el punto temporal a lo largo de la línea del
perfil señalado por el cursor (ver la parte derecha de la figura *B* anterior).
Al desplazar el cursor horizontalmente se muestra la información para
cualquier momento de la inmersión.
En este modo, la Caja de Información facilita abundantes estadísticas sobre
profundidad, gases y característica del techo de una inmersión en particular.
Entre ellas se incluyen: Momento de tiempo en la inmersión (indicado por un
@), la profundidad, la presión de la botella (P), la Temperatura, el ritmo de
ascenso y descenso, el Consumo de aire en superficie (CAS), la presión
parcial de oxigeno, la profundidad máxima operativa de la mezcla (POM o MOD),
la profundidad equivalente a aire (PEA o EAD), la profundidad narcótica equivalente
(PNE o END), la profundidad equivalenta a la densidad del aire (EADD), los
requisitos descompresivos en ese instante de tiempo (Deco), el Tiempo hasta la
superficie (TTS), el techo calculado así como el techo calculado para varios
compartimentos de tejidos de Bühlmann.

El usuario tiene control sobre varios de los datos que se muestran en la Caja
de Información, mostrados como cuatro de los botones en lka columna a la
izquierda del panel del perfil. Estos son:

[icon="images/icons/MOD.jpg"]
[NOTE]
Pulsar este botón hace que se muestre la *Profundidad Máxima Operativa (POM)*
de la inmersión, en función del gas utilizado. La POM depende de la
concentración de oxígeno en la mezcla respirada.
Para el aire (21% de oxigeno) está alrededor de 57 metros si especificamos una
pO~2~ máxima de 1.4 en la sección *Preferencias* (seleccionar _Archivo_ ->
_Preferencias_ -> _Grafico_ y editar la casilla de texto _pO~2~ al calcular la
POM_). Por debajo de la POM se incrementa mucho el riesgo por
exposición a los peligros de la toxicidad del oxígeno.

[icon="images/icons/NDL.jpg"]
[NOTE]
Pulsar este botón hace que se muestre en la Caja de Información el *Límite de
no Descompresión (NDL o LND)* o el *Tiempo total de Ascenso (TTS)*. El LND es
el tiempo que un buceador puede continuar  con una inmersión a la profundidad
actual, sin requerir descompresión (es decir, antes de que aparezca un
techo). Una vez que el buceador ha excedido el NDL y se precisa descompresión
(es decir, hay un techo de ascenso sobre el buceador) el TTS nos da el número
de minutos necesarios antes de que el buceador pueda emerger. El TTS incluye
el  tiempo de ascenso y el tiempo de descompresión. El TTS se calcula
utilizando en gas que se está usando en el momento, aunque existan cambios de
gas previstos.
Los TTS mayores a 2 horas resultan muy imprecisos y Subsurface solo indicará
_TTS > 2h_.

[icon="images/icons/SAC.jpg"]
[NOTE]
Pulsar en este botón hace que se muestre en la Caja de Información el
*Consumo de Aire en Superfice (CAS o SAC). El CAS es una indicación del ritmo
respiratorio del buceador normalizado a la presión de la superficie. El valor
del CAS es menor que el ritmo respiratorio real porque un buceador a 10m
consume gas a un ritmo casi el doble que el equivalente en superficie. El CAS
nos calcula una indicación del ritmo respiratorio independiente de la
profundidad de la inmersión, de forma que los ritmos respiratorios de
diferentes inmersiones puedan compararse. Las unidades para el SAC son los
litros/minuto o pies cúbicos/minuto.

[icon="images/icons/EAD.jpg"]
[NOTE]
Pulsar este botón hace que se muestre la *Profundidad equivalente de Aire
(PEA o EAD)* para las inmersiones con nitrox y la *Profundidad narcótica
equivalente (PNE o END)* para las inmersiones con trimix. Ambas son imprtantes
para buceadores que respiren gases diferentes del aire. Sus valores dependen
de la composición de la mezcla respirada. La PEA es la profundidad de una
hipotética inmersión con aire que tenga la misma presión parcial de nitrógeno
que la inmersión actual con nitrox. Una inmersión con nitrox lleva a la misma
obligación descompresiva que una inmersión con aire a una profundidad igual a
la PEA. La PNE es la profundidad de una inmersión hipotética con aire que
tenga la misma suma de presiones parciales de gases narcóticos (oxígeno y
nitrógeno) que la inmersión con trimix. Un buceador con trimix puede esperar
el mismo efecto narcótico que en una inmersión con aire a una profundidad
igual a la PNE.

La figura *B* anterior muestra una Caja de Información con un conjunto de
datos casi completo.

[[S_gas_pressure_graph]]
===== El gráfico de barras de presión de gases

A la izquierda de la Caja de Información hay una barra gráfica vertical que
muestra las presiones  del nitrógeno (y otros gases inertes, p.e. el helio, en
su caso) que el buceador estaba respirando en _un momento dado de la
inmersión_. Se muestra por la posición del cursor en el *Perfil de la
inmersión*. El dibujo en la parte inferior izquierda indica el significado de
las diferentes partes del gráfico.

image::images/GasPressureBarGraph.jpg["FIGURE:Barra gráfica de la presión de
gases",align="center"]

- El área verde clara indica  la presión del gasl, con el margen superior del
área verde clara mostrando la presión total de TODOS los gases inhalados por el
buceador y medida desde el fondo del gráfico hasta la parte alta del área verde
clara.
Esta presión es un valor relativo y no indica una presión absoluta.

- La línea negra horizontal por debajo del margen verde indica la presión de
equilibrio de los gases inertes inhalados por el buceador, habitualmente
nitrógeno. En el caso del trimix, es el valor combinado del nitrógeno y el
helio. En este ejemplo, el buceador está buceando con EAN32, por tanto la
presión de iequilibrio de los gases inertes está a un 68% de la distancia del
fondo a la presión total de gases.

- El área verde oscura de la parte inferior del gráfico representa las
presiones de gases inertes en cada uno de los 16 compartimentos de tejidos
usados en el algoritmo de Bühlmann, con los tejidos rápidos en el lado
izquierdo.

- La línea negra horizontal superior indica el límite de presión de gas inerte
determinado por el factor de gradiente que se aplica a la profundidad del
buceador en el punto concreto del *Perfil de Inmersión*. El factor de gradiente
mostrado es una interpolación entre los valores de GFbajo y GFalto especificados
en la pestaña _Gráfico_ del panel *Preferencias* de _Subsurface_.

- El margen inferior del área roja del gráfico indica el Valor-M derivado de
Bühlmann. Ese es el valor de la presión de gases inertes para el cual la
formación de burbujas se espera que sea severa y resulte en un riesgo
significativo de enfermedad descompresiva.

Estos cinco valores se muestran a la izquierda del gráfico anterior. La forma
en que cambia la Barra Gráfica de Presión de Gases durante una inmersión puede
verse a la derechade la figura anterior para un buceador usando EAN32.

- El gráfico *A* indica el inicio de una inmersión, con el buceador en
superficie. Las presiones en todos los compartimentos están aun a la presiñon
de equilibrio en superficie porque no se ha buceado.

- El gráfico *B* indica la situación tras un descenso a 30 metros. Pocos de
los compartimentos han tenido tiempo para responder al descenso, por lo que
las presiones de los gases están muy por debajo de de la presión de
equilibrio.

- El gráfico *C* representa las presiones tras 30 minutos a 30 metros. Los
compartimentos rápidos han llegado al equilibrio (p.e. han alcanzado la altura
de la línea negra que indica la presión de equilibrio. Los compartimentos
lentos (hacia la derecha) no han alcanzado el equilibrio y están en el proceso
de incrementar léntamente la presión.

- El gráfico *D* muestra las presiones tras ascender a una profundidad de 4.5
metros. Ya que durante el ascenso la presión total del gas inhalado ha
descendido desde 4 bar a 1.45 bar, la presiones en los diferentes tejidos
superan a la presión total y se acercan al valor del factor de gradiente (la
linea negra horizontal superior). Continuar ascendiendo supondría exceder el
valor del GFalto, poniendo en peligro al buceador.

- El gráfico *E* indica la situación despues de haber permanecido a 4.5m
durante 10 minutos. Los compartimentos rápidos han reducido la presión. Como
era de esperar, las presiones en los compartimentos lentos no han cambiado
mucho. Las presiones en los compartimentos rápidos no se aproximan al GFalto y
el buceador está más seguro que en la situación indicada por el gráfico *D*.

==== Eventos reportados por el ordenador durante el buceo
Muchos ordenadores de buceo registran eventos durante la inmersión. Por
ejemplo, la mayoría de los ordenadores informan de alarmas relacionadas con
altas presiones parciales de oxígeno, ascensos rápidos o al exceder los
limites de no descompresión (LND).
Por otra parte, otros eventos se clasifican como "avisos" y suceden, por
ejemplo, cuando el gas de una botella está por debajo de cierto límite, es
necesario efectuar una parada profunda, o hay que cambiar de gas en
inmersiones con varios gases. Algunos ordenadores también reportan avisos
cuando se inicia o termina una parada de seguridad o cuando se ha llegado a
una cierta cantidad de OTUs. Las alarmas, avisos y notificaciones difieren de
un ordenador a otro: algunos no informan de nada de lo expuesto, mientras que
otros proporcionan un registro muy extenso de eventos. Así pues, el registro
de eventos es una función del ordenador de buceo utilizado. Además,
_Subsurface_ no siempre tiene la capacidad de detectar todos los eventos de
los que informa un ordenador de buceo.

Los eventos se indican con símbolos sobre el perfil de inmersión. Las
notificaciones se muestran como un símbolo blanco redondo con una letra _i_;
los avisos se indican con un triángulo amarillo y las alarmas con un triángulo
rojo. Situando el cursor sobre un símbolo aparecerá la explicación en la de
abajo de la _Ventana de información_ (ver imagen a continuación, en la que el
cursor se sitúa sobre la alarma informada).

image::images/profile_symbols.jpg["FIGURA: Símbolos de notificación del perfil",align="center"]

Algunos ordenadores de buceo también informan de "marcas" que el buceador ha
registrado durante la inmersión. Estas se indican como una pequeña bandera
roja sobre el perfil y se comentan en más profundidad en la sección del manual
<<S_Bookmarks,_Insertar marcadores_>>.

==== La Barra de herramientas del Perfil

El perfil de inmersión puede incluir *gráficos de presiones parciales* de O2, N2
y He durante el buceo (ver la figura anterior) así como techos de deco
calculados por _Subsurface_ o regisrtrados por el ordenador de buceo (solo
visibles para buceos profundos, largos o repetitivos). La presión parcial del
oxígeno se indica en verde, la del nitrógeno en negro y la del helio en rojo
oscuro. Estos gráficos de presiones parciales se muestran bajo los datos de
perfil.

[icon="images/icons/O2.jpg"]
[NOTE]
Clicar este botón permite visualizar la presión parcial de oxígeno durante la
inmersión. Se dibuja bajo los gráficos de profundidad y temperatura.

[icon="images/icons/N2.jpg"]
[NOTE]
Clicar este botón permite visualizar la presión parcial de nitrógeno durante la
inmersión.

[icon="images/icons/He.jpg"]
[NOTE]
Clicar este botón permite visualizar la presión parcial de helio durante la
inmersión. Esto solo es interesante para buceadores que usen trimix, helitrox o
mezclas respiratorias similares.

El gráfico de *consumo de gas* muestra la presión de la botella y su variación
durante la inmersión. El consumo de gas tiene en cuenta la profundidad, de
manera que, incluso cuando introduces manualmente las presiones inicial y final,
el gráfico no es una línea recta. Al igual que el gráfico de profundidad, la
pendiente de la presión de la botella facilita información acerca del CAS
momentáneo, si se está usando ordenador con gas integrado. Aquí el color no se
refiere a valores absolutos, sino que se calcula en relación a la media
normalizada de aire consumido durante este buceo. Así pues, las áreas en rojo o
naranja indican momentos de consumo por encima de la media mientras que el verde
oscuro indicará momentos de consumo de gas por debajo de la media.

[icon="images/icons/Heartbutton.png"]
[NOTE]
Hacer clic en el botón de ritmo cardiaco permitirá mostrar información de este
parámetro durante la inmersión si el ordenador de buceo tiene conectado un
sensor de ritmo cardiaco.

Es posible *hacer zoom* en el gráfico del perfil. Se puede hacer con la rueda
del ratón o el gesto equivalente en el trackpad. Por defecto, _Subsurface_
siempre muestra un área suficientemente grande para mostrar al menos 30 minutos
y 30 metros – de esta forma, las inmersiones cortas o superficiales se reconocen
a simple vista; algo que a los apneístas les trae claramente sin cuidado.

image::images/MeasuringBar.png["FIGURE: Barra de medidas",align="center"]

[icon="images/icons/ruler.jpg"]
[NOTE]
Pueden hacerse *medidas de profundidad o tiempo* utilizando el botón *regla* de
la izquierda del perfil La medición se hace arrastrando los puntos rojos a los
dos puntos del perfil entre los que deseas medir. La información se facilita en
el área blanca horizontal bajo los dos puntos.

[icon="images/icons/ShowPhotos_f20.png"]
[NOTE]
Las fotografías que se han añadido a una inmersión pueden mostrarse en el perfil
seleccionando el botón *Mostrar foto* en la barra de herramientas a la izquierda
del perfil. La posición de la foto en el perfil indica la hora exacta a la que
se tomó. Si el botón no está activado, las fotos permanecen ocultas.

El perfil de buceo también puede incluir el *techo* registrado por el ordenador
de buceo (o, más precisamente, la parada deco más profunda que el ordenador de
buceo calcule para cada momento en el tiempo) como una capa roja en el perfil de
la inmersión. Los techos de ascenso surgen cuando un ascenso directo a
superficie incrementa el riesgo de que el buzo sufra enfermedad descompresiva
(ED) y se necesita ascender más despacio, o efectuar paradas de descompresión
antes de subir a la superficie. No todos los ordenadores de buceo guardan esta
información y posibilitan su descarga; por ejemplo todos los ordenadores Suunto
carecen de la posibilidad de facilitar estos datos tan útiles a los softwares de
registro de inmersiones. _Subsurface_ también calcula los techos
independientemente, mostrándolos como una capa verde sobre el perfil. A causa de
las diferencias en los algoritmos utilizados y la cantidad de datos disponibles
(y otros factores tomados en consideración en el momento de los cálculos) es
improbable que los techos de los ordenadores de buceo y de _Subsurface_ sean los
mismos, incluso si se utilizan el mismo algoritmo y los mismos factores de
gradiente (ver más adelante). También es bastante común que _Subsurface_ calcule
un techo cuando el ordenador permaneció en modo no deco durante la inmersión
completa (representada por la sección [green]#verde oscuro# del perfil). Esto se
debe al hecho de que los cálculos de _Subsurface_ describen la obligación de
descompresión en ese punto del tiempo durante la inmersión, mientras los
ordenadores de buceo habitualmente, tienen en cuenta el ascenso que va a venir.
Durante el ascenso parte del exceso de nitrógeno (y posiblemente de helio) ya se
ha eliminado a través de la respiración por lo que, aunque el buceador
técnicamente encontrara un techo, la inmersión aún no requiere explícitamente
una parada de descompresión. Esta característica permite a los ordenadores de
buceo ofrecer tiempos de fondo más largos.

[icon="images/icons/cceiling.jpg"]
[NOTE]
Si el propio ordenador de buceo calcula un techo y lo pone a disposición de
_Subsurface_ durante la descarga de inmersiones, puede ser mostrado como un
árearoja seleccionando el botón *Mostrar techo informado por el ordenador* del
panel de perfil.

[icon="images/icons/ceiling1.jpg"]
[NOTE]
Si hacemos clic en el botón *Mostrar techo calculado* por _Subsurface_ del panel
del perfil, se muestra en verde este techo, si existe, para una inmersión en
particular (*A* en la figura a continuación). Este ajuste puede modificarse de
dos maneras:

[icon="images/icons/ceiling2.jpg"]
[NOTE]
Si, además, se selecciona el botón *Calcular todos los tejidos* del panel de
perfil, se muestra el techo para los distintos tejidos del modelo Bühlman (*B*
en la figura de debajo).

[icon="images/icons/ceiling3.jpg"]
[NOTE]
==========================================================================================================
Si, además, se selecciona el botón *Mostrar el techo calculado con incrementos
de 3m* entonces el techo se muestra con saltos de 3 en 3 metros.

image::images/Ceilings2.jpg["Figura: Techo con resolución de 3 metros",align="center"]

Los ajustes de los Factores de Gradiente afectan mucho a los techos calculados
y sus profundidades. Para más información sobre Factores de Gradiente, vease
la sección en xref:GradientFactors_Ref[Ajuste de Preferencias de los Factores de Gradiente].
Los Factores de Gradiente que se están utilizando (p.e. GF 30/75) se muestran
sobre el perfil de profundidad si se activan los botones adecuados.
N.B. Los facatores indicados *NO* son los utilizados por el ordenador de buceo
para calcular las obligaciones descompresivas durante el buceo. Para más
información externa a este manual ver:

*** http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values
de Erik Baker, _Immersed_ Vol. 3, No. 3.]

***
link:http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/503 7-gradient-factors-for-dummies.html[Gradient factors for dummies, de Kevin Watts]
==========================================================================================================


[icon="images/icons/ShowCylindersButton.jpg"]
[NOTE]
Al seleccionar este icono, los diferentes gases utilizados durante una inmersión
se presentarán en forma de barras de colores en la parte de abajo del perfil. En
general, el oxígeno se presenta con una barra verde, el nitrógeno con una barra
amarilla y el helio con una barra roja. La imagen a continuación muestra un buceo
que primero utiliza una botella de trimix (rojo y verde), seguida por un cambio a
una botella de nitrox (amarillo y verde) tras 23 minutos. Las botellas con aire
se muestran con una barra azul claro.

image::images/ShowCylinders_f20.jpg["Figura: Gráfico de uso de botellas",align="center"]

[icon="images/icons/heatmap.png"]
[NOTE]
================================================================================
Muestra un mapa de calor de los tejidos. El mapa de calor resume, para la
duración de la inmersión, las presiones de gases inertes para los 16
compartimentos de tejidos del modelo de Bühlmann. Los colores azules indican
presiones de gas bajas en un compartimento, del verde al rojo indican exceso
de gas en el tejido y, por tanto, desgasificación. Las zonas superiores del
gráfico corresponderían a los tejidos más rápidos y las inferiores a los más
lentos. La figura a continuación explica en mayor detalle como puede
interpretarse el mapa de calor.

image::images/Heatmap.jpg["Figure: Mapa de calor de gases inertes en los tejidos ",align="center"]

La imagen *A* a la izquierda muestra el xref:S_gas_pressure_graph[Gráfico de presión de gas]
de la *Caja de Información* con una instantanea de las presiones de gases
inertes en un momento dado de la inmersión. Las presiones de los gases inertes
en los 16 compartimentos de tejidos se muestran como barras verticales verdes
oscuras con los tejidos rápidos a la izquierda y los lentos a la derecha. Para
más detalles, visita la sección xref:S_gas_pressure_graph[Gráfico de presión de gases].

La imagen *B* muestra un gradiente de colores únicos que ocupa todo el rango
de de presiones de gases inertes.
Es posible relacionar la altura de cada una de las barras verticales verdes de
*A* con un color de *B*. Por ejemplo, la barra verical verde en *A* situada
más a la izquierda (tejido más rápido) tiene una altura que se correspondería
con el color verde intermedio de *B*. La altura de esta barra puede, pues,
resumirse en un color verde intermedio. De forma similar, la barra más alta de
*A* es tan alta como la parte amarilla de *B*. Las otras 14 barras de presión
de los tejidos tambien pueden trasladarse a colores. Los colores representan
tres rangos de presión de gases inertes en los tejidos:

- El rango inferior de *B* (marcado _on-gassing_) incluye colores desde el
azul claro al negro, representando presiones por debajo de la presión de
equilibrio de gas inerte (linea horizontal inferior en *A*). La unidad de
medida es el porcentaje de presión de gas inerte en relación a la presión de
equilibrio. En este nivel tiene lugar la carga de gases inertes porque la
presión de los mismos en los tejidos es inferior a la presión ambiental. Las
zonas negras del mapa de calor indican que un tejido ha alcanzado la presión
de equilibrio, por ejemplo, la presión de gases inertes en el tejido ha
alcanzado la del agua en la que se encuentra el buceador. La presión de
equilibrio cambia deacuerdo con la profundidad.

- El rango central de *B* incluye colores que van desde el negro al verde
claro, cuando la presión de los gases inertes de un compartimento es mayor que
la presión de equilibrio, pero menor que la presión ambiental. En esta zona,
la descompresión no es muy eficiente porque el gradiente de presiones de gases
inertes entre el compartimento de tejidos y el entorno es relativamente
pequeño y viene indicado por las zonas verde oscuro del mapa de calor.

- El rango superior de *B* (marcado _off-gassing_) incluye colores que van
desde el verde claro hasta rojo y blanco, representando presiones en los
tejidos superiores a la presión ambiental total (arriba de la zona verde claro
de *A*). Estas presiones de tejidos se alcanzan normalmente al ascender a una
profundidad menor.
Por debajo de un valor de 100%, este rango indica una descarga eficiente de
gases inertes desde los compartimentos de tejidos al ambiente. Habitualmente,
una descarga eficiente viene representada por colores verde claro, amarillo y
naranja.
Por encima del 100% (rojo a blanco en *B*) se excede el gradiente del Valor-M
y la probabilidad de enfermedad descompresiva se incrementa notablemente.

La imagen *C* muestra la equivalencia de los colores con con cada una de las
barras verticales de *A*, los tejidos rápidos de la izquierda dibujados arriba
y los compartimentos de tejidos lentos abajo en *C*. La barra vertical más
alta de *A* (la tercera por la izquierda) se presenta como el tercer
rectangulo amarillo desde arriba en *C*. Las 16 barras verticales de *A* se
presentan ahora como una columna vertical de 16 rectangulos de colores,
representando una instantane,a en un momento concreto de la inmersión, de las
presiones parciales de los compartimentos de tajidos.

La imagen *D* es una recopilación de equivalencias de color similares de los
16 compartimentos de tejidos durante un periodo de 10 minutos de un buceo, los
colores representan la carga de gases inertes de un compartimento de tejido en
un momento del tiempo durante la inmersión. Los tejidos más rápidos se
muestran arriba, y los más lentos abajo, con el tiempo formando el eje
horizontal del gráfico. La columna de rectangulos de *C* se puede encontrar
entre los 9 y los 10 minutos.

Los colores del mapa de calor no se ven afectados por los ajustes de los
Factores de Gradiente. Esto se debe a que el mapa indica presiones de tejidos
relativas al gradiente del Valor-M de Bühlmann, y no relativas a ningún Factor
de Gradiente especifico. Para más información externa a este manual ver:

http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values by Erik Baker, _Immersed_ Vol. 3, No. 3.]

Al no verse afectados los colores del mapa de calor por los factores de
gradiente, el mapa también es aplicable cuando se utilice el modelo de
descompresión VPM-B.

La imagen a continuación muestra los perfiles y mapas de calor de dos
inmersiones planificadas con descompresión a 60m:
La primera utilizando el modelo descompresivo de Bühlmann, la segunda usando
el modelo descompresivo VPM-B.
Ambos perfiles tienen el mismo tiempo total de descompresión, pero el modelo
VPM-B requiere paradas más profundas y más tempranas en la fase de ascenso.

En ambos perfiles, las presiones de gases inertes en los tejidos rápidos crecen
mucho más deprisa que en los lentos, atravesando una secuencia desde el azul
claro al púrpura y negro.
De forma similar, la presión de los gases inertes en los tejidos rápidos se
reduce más deprisa que en los tejidos lentos en cada parada deco, con los
colores variando desde el rojo al negro, pasando por naranja, amarillo y
verde.

La comparación de los dos perfiles y mapas de calor muestra que al incluir
paradas profundas, el gradiente se sobresaturación de los tejidos rapidos se
reduce antes en la fase de ascenso.
Sin embargo, la carga de gases continua en los tejidos lentos durante las
paradas profundas, lo que lleva a un mayor gradiente de sobresturación de los
tejidos lentos al final de la inmersión.

image::images/tissueHeatmap.jpg["Figure: Inert gas tissue pressure heat-map",align="center"]
================================================================================

==== El menú contextual del Perfil de Inmersión

Se accede al menú contextual del Perfil de Inmersión haciendo clic-derecho
mientras el cursor del ratón está sobre el panel del Perfil de Inmersión. El
menú permite la creación de marcadores, eventos de cambio de gas o cambios
manuales en setpoint de un CCR, aparte de los que se hayan podido importar del
ordenador de buceo. Las marcas se sitúan contra la línea de profundidad del
perfil y con el tiempo fijado donde estaba el cursor cuando el botón derecho
se clicó para desplegar el menú. Los eventos de cambio de gas suponen una
selección sobre el gas al que estamos cambiando, habiendo sido definida la lista
de posibilidades en la pestaña *Equipo*. Los eventos de cambio de setpoint
abren un diálogo en el que se permite elegir el valor del próximo setpoint. Como
en el planificador, un setpoint cero indica que el buceador está respirando en
circuito abierto, mientras cualquier valor diferente de  cero indica el uso de
circuito cerrado. Si hacemos clic-derecho mientras estamos sobre
un marcador preexistente, el menú se extiende añadiendo opciones para permitir
el borrado del marcador o permitir ocultar todos los marcadores de ese tipo.


== Organizar el registro (Manipular grupos de inmersiones)

[[S_DiveListContextMenu]]
=== El menú contextual de la Lista de Inmersiones

Varias acciones sobre, bien una inmersión, bien un grupo de ellas, se pueden
efectuar utilizando el Menú Contextual de la Lista de inmersiones, al que se
accede seleccionando una inmersión o un grupo de ellas y haciendo clic-derecho.

image::images/ContextMenu.jpg["Figura: Menú contextual",align="center"]

El menú contextual se usa en muchas de las acciones que se describen a
continuación.

[[S_Divelist_columns]]
==== Personalizar las columnas mostradas en el panel *Lista de inmersiones*

image::images/DiveListOptions.jpg["Ejemplo: Opciones de la Lista de inmersiones",align="center"]

La información por defecto de la *Lista de inmersiones* incluye, para cada buceo,
Numero de inmersión, Fecha, Calificación, Profundidad, Duración y Ubicación. Esta
información puede controlarse y cambiarse haciendo clic derecho sobre la barra de
encabezamiento de la *Lista de inmersiones*, lo que mostrará una lista de
columnas que puede mostrarse en la lista (ver imagen anterior). Si seleccionamos
un valor para que se muestre o desaparezca de la lista, esta se actualiza
inmediatamente. Las preferencias para la información que muestre la lista se
guardan y reutilizan cada vez que se abre _Subsurface_.

[[S_Photos_divelist]]

Al seleccionar la casilla _Fotos_ de la lista desplegable, se mostrará un
icono indicando si existe alguna foto asociada a cada inmersión concreta. Hay
tres iconos:

[icon="images/icons/duringPhoto.png"]
[NOTE]
Esta inmersión tiene fotografías tomadas durante el buceo, habitualmente con
una cámara sumergible.

[icon="images/icons/outsidePhoto.png"]
[NOTE]
Esta inmersión tiene fotos tomadas inmediatamente antes o después del buceo.
Es útil para encontrar fotos de los compañeros o de barcos, ballenas u otros
animales vistos en superficie antes o después del buceo, o paisajes.

[icon="images/icons/inAndOutPhoto.png"]
[NOTE]
Esta inmersión tiene fotos tomadas durante el buceo y antes o después del
mismo.

==== Seleccionar inmersiones en una ubicación concreta

Muchos buceadores tienen largas listas de inmersiones, y puede resultar difícil
localizar todos los buceos en un punto en concreto. Presionando _Ctrl+F_ en el
teclado se abre una casilla de texto en la parte de arriba a la izquierda de la
*Lista de inmersiones*. Si se teclea el nombre de una ubicación en esta casilla
la *Lista de inmersiones* se filtra inmediatamente para mostrar solo los buceos
en esta ubicación.

[[S_Renumber]]
=== Renumerar las inmersiones

Las inmersiones normalmente se numeran incrementando desde las no-recientes
(menores números de secuencia) a las más recientes (números de secuencia más
altos). Numerar los buceos no siempre es consistente. Por ejemplo, cuando se
añaden inmersiones antiguas a la lista, la numeración no sigue automáticamente
por ser estas anteriores en fecha/hora a las ya existentes. Por lo tanto, en
ocasiones, se puede necesitar renumerar los buceos. Esto se hace seleccionando
(desde el menú principal) _Registro → Renumerar_. Se permite elegir el número de
secuencia inferior que se va a usar. Completar esta operación supone obtener
nuevos números de secuencia (basados en fecha/hora) para los buceos del panel
*Lista de Inmersiones*.

También se pueden renumerar algunas inmersiones seleccionadas de la lista. Se
seleccionan las inmersiones que necesiten renumerarse. Se hace clic-derecho
sobre la lista seleccionada y se utiliza la lista contextual para efectuar el
renumerado. Aparecerá una ventana solicitando al usuario que especifique el
número de inicio para el proceso de numeración.

[[S_Group]]
=== Agrupar las inmersiones en viajes y manipularlos

Si buceas regularmente, la lista de inmersiones puede hacerse rápidamente muy
larga. _Subsurface_ puede agrupar los buceos en _viajes_. Lo hace agrupando
inmersiones que tengan fechas/horas que no estén separadas más de dos días y
crea una sola cabecera para cada viaje . Abajo hay una lista de inmersiones no
agrupada (*A*, a la izquierda) y la lista agrupada correspondiente incluyendo
cinco viajes (*B*, a la derecha):

image::images/Group2.jpg["Figura: Agrupar inmersiones",align="center"]

Agrupar en viajes permite una forma rápida de acceder a buceos individuales sin
tener que pasar por largas listas de inmersiones. Para agrupar los buceos de una
lista de inmersiones (desde el menú principal) se selecciona _Registro →
Autoagrupar_. El panel Lista de Inmersiones ahora muestra solo los títulos de
los viajes.

==== Editar el título y la información asociada a un viaje en particular

Normalmente, en la lista de inmersiones se incluye una mínima información en el
título del viaje. Puede añadirse mucha más sobre un viaje seleccionando su
título en la lista. Esto muestra una pestaña *Notas del Viaje* en el panel Notas
de la inmersión. Aquí se puede añadir o editar información sobre dia/hora,
ubicación del viaje, y otros comentarios generales. Al terminar, se selecciona
*Guardar* en los botones de arriba a la derecha en la pestaña Notas del viaje.
El título en la *Lista de inmersiones* debería reflejar ya algo de la
información editada.

==== Ver los buceos de un viaje en concreto

Una vez que las inmersiones agrupadas en viajes, los usuarios pueden expandir
uno o más viajes clicando el botón de expansión [+/-] a la izquierda del
título. Con ello se expande el viaje mostrando los buceos individuales
efectuados.

==== Colapsar o expandir información de diferentes viajes

Tras seleccionar un viaje concreto de la lista, el menú contextual resultante
ofrece varias posibilidades de expandir o contraer buceos incluidos en viajes.
Entre ellas expandir todos los viajes y contraer todos los viajes.

==== Mezclar inmersiones de más de un viaje en uno solo

Tras seleccionar el título de un viaje del panel *Lista de Inmersiones*, el
menú permite mezclar viajes con el viaje de abajo o con el de arriba.

==== Separar un viaje en más de uno

Si un viaje incluye diez inmersiones, el usuario puede separar el viaje en dos
(viaje 1: cuatro inmersiones de arriba; viaje 2: seis inmersiones de abajo)
seleccionando y haciendo clic-derecho en las cuatro inmersiones de arriba. El menú
que aparecerá te permite crear un nuevo viaje seleccionando la opción *Crear
nuevo viaje arriba*. Las cuatro inmersiones superiores quedan entonces agrupadas
en un viaje separado. La siguiente figura muestra la selección y el menú a la
izquierda (A), la acción completada a la derecha (B):

image::images/SplitDive3a.jpg["FIGURA: Separar un viaje en dos",align="center"]

=== Manipular inmersiones individuales

==== Borrar una inmersión del diario

Las inmersiones pueden borrarse permanentemente del diario seleccionándolas y
haciendo clic-derecho para mostrar el menú y, entonces, seleccionando *Borrar
inmersión*. Habitualmente esto se hará en casos donde se desee borrar
inmersiones de prueba o buceos de duración extremadamente corta.

==== Separar una inmersión de un viaje

Se pueden separar inmersiones del viaje al que pertenecen. Para ello se
selecciona y hace clic-derecho en los buceos para mostrar el menú. Luego se
selecciona *Quitar inmersión(es) del viaje*. Las inmersiones que han sido
separadas aparecerán ahora encima o debajo del viaje al que pertenecieron, en
función de la fecha y la hora de la inmersión separada.

==== Añadir una inmersión al viaje de arriba

Las inmersiones seleccionadas pueden moverse del viaje al que pertenecen al
inmediatamente superior al actual. Para ello se selecciona y hace clic-derecho
en los buceos para mostrar el menú, luego se selecciona *Añadir inmersión(es) al
viaje de arriba*.

==== Desplazar la hora de inicio del buceo(s)

En ocasiones es necesario ajustar la hora de comienzo de una inmersión. Esto
puede aplicarse a situaciones en las que las inmersiones se han efectuado en
diferentes zonas horarias o si el ordenador de buceo tiene mal configurada la
hora. Se selecciona y hace clic-derecho en la inmersión(es) a ajustar. Esto
despliega el menú. Seleccionar *Desplazar horas*. Se especifica el tiempo (en
horas y minutos) en el que deben ajustarse los buceos y se hace clic en la
opción que indica si el ajuste debe ser hacia adelante o hacia atrás.

==== Juntar buceos en uno solo

En ocasiones una inmersión se interrumpe brevemente, p.e. si un buceador regresa
a superficie unos pocos minutos, dando como resultado dos o más inmersiones
grabadas por el ordenador y apareciendo como buceos distintos en el panel *Lista
de inmersiones*. Se pueden unir estos buceos en uno solo seleccionando las
correspondientes inmersiones y haciendo clic-derecho para mostrar el menú.
Entonces se selecciona *Mezclar inmersiones seleccionadas*. Puede que sea
necesario editar la información de la inmersión en el panel *Notas* para
reflejar situaciones o condiciones que afecten al buceo
resultante de la fusión. La figura a continuación muestra el perfil de dos
inmersiones que fueron unidas:

image::images/MergedDive.png["Ejemplo: Inmersión mezclada",align="center"]


==== Dividir inmersiones seleccionadas

En algunas ocasiones, un buceador llega a superficie y vuelve a bucear
inmediatamente. Sin embargo, puede suceder que el ordenador de buceo no
registre una nueva inmersión, sino que siga con la anterior. En este caso, es
posible separar una inmersión para que las dos se muestren como buceos
independientes en la  *Lista de inmersiones*. Si se efectúa esta operación
_Subsurface_ divide la inmersión(es) seleccionada(s) en puntos donde la
profundidad es inferior a un metro.

==== Cargar imágenes desde archivo
Este tema se discute en la sección: xref:S_LoadImage[Adding photographs to dives].

==== Cargar imágenes desde la web
Este tema se discute en la sección: xref:S_LoadImage[Adding photographs to dives].

==== Deshacer manipulaciones de inmersiones

Se pueden deshacer o rehacer acciones importantes, de las que se han comentado
anteriormente, sobre inmersiones o viajes. Aquí se incluyen: _Borrar inmersión_,
_Mezclar inmersiones_, _Dividir inmersiones, _Renumerar inmersiones_ y _Desplazar hora de buceo_.
Para hacerlo, tras haber llevado a cabo cualquiera de estas acciones, se
selecciona _Editar_ desde el *Menú Principal*, lo que presentará un desplegable
con las posibilidades _Deshacer_ y _Rehacer_.

[[S_Filter]]
=== Filtrar la Lista de Inmersiones

Los buceos del panel *Lista de inmersiones* pueden filtrarse, esto es, se pueden
seleccionar únicamente algunos de los buceos basándose en sus atributos, p.e.
las etiquetas, el lugar de buceo, el divemaster, compañeros o traje protector.
El filtrado permite, por ejemplo, listar las inmersiones profundas en un punto
determinado o, por el contrario, las inmersiones en cuevas con cierto
compañero.

Para abrir el filtrado, seleccionar _Registro -> Filtrar la lista de inmersiones_
desde el menú principal. Esto abrirá el _Panel de filtrado_ en la parte de arriba
de la ventana de _Subsurface_. Arriba a la derecha del panel se ubican tres
iconos (ver imagen a continuación).
El _Panel de filtrado_ puede reiniciarse (p.e. limpiar todos los filtros
actuales) seleccionando la flecha amarilla. El _Panel de filtrado_ también puede
minimizarse seleccionando la *flecha verde*. Cuando está minimizado solo se
muestran los tres iconos. El panel puede maximizarse clicando el icono que lo
minimizó. El filtro se cierra y reinicia seleccionando el *botón rojo* con la
cruz blanca.

image::images/Filterpanel.jpg["Figura: Panel de filtrado",align="center"]

Se pueden utilizar cuatro criterios para filtrar la lista de inmersiones:
las etiquetas, las personas (compañeros/divemasters), punto de inmersión y traje
de buceo, cada uno de los cuales viene representado por una lista seleccionable.
Sobre cada lista hay un segundo nivel de filtrado. Por ejemplo, tecleando "_Ba_"
en la casilla de texto sobre las ubicaciones, la lista podría quedar reducida a
"_Bajo Piles I_", "_Bajo Piles II_" y "_Bajo de Testa_". Filtrar la lista
permite encontrar rápidamente términos de búsqueda para filtrar la lista de
inmersiones.

Para activar el filtrado de la lista de inmersiones, se necesita seleccionar
al menos una casilla en una de las cuatro listas. La lista de inmersiones se
reduce para mostrar solo los buceos que cumplen los criterios seleccionados en
las listas. Las cuatro listas funcionan como un filtro con operadores _Y_,
_Subsurface_ filtraría, pues, para "_cueva_" como etiqueta y "_José García_"
como compañero; pero los filtros dentro de una categoría son inclusivos, esto
es, filtrar por etiquetas con "cueva" y "barco" mostraría todas las inmersiones
en las que aparezcan las etiquetas "cueva" _O_ "barco", solas o conjuntamente.

[[S_ExportLog]]
== Exportar el registro de inmersiones o parte del mismo

Hay dos posibilidades de exportar información de buceo desde _Subsurface_:

- Exportar información de buceo a _Facebook_

- xref:S_Export_other[Exportar información de buceo a otros destinos o formatos]

[[S_Facebook]]
=== Exportar información de buceo a _Facebook_

La exportación de inmersiones a _Facebook_ se maneja de forma diferente a otros
tipos de exportación porque se requiere una
conexión a esta red social y se necesita un usuario de _Facebook_ y su password.
Si, desde el menú principal, seleccionamos _Compartir -> Conectar a ->
Facebook_ (imagen *A* siguiente), se nos presentará una pantalla de acceso
(imagen *B* a continuación). Introducimos nuestro usuario y password de
_Facebook_.
Desde la ventana de _Subsurface_ es fácil saber si se tiene una conexión válida
con _Facebook_. Desde el *Menú principal*, selecciona _Compartir_
(ver imagen *A* a continuación). Normalmente la opción _Facebook_ está
desactivada, pero, si hay una conexión establecida, la opción está activa y
puede ser seleccionada.
Tras haber establecido una conexión con _Facebook_, se mostrará un panel con
un mensaje: "_Para desconectar Subsurface de tu cuenta de Facebook, utiliza la
entrada del menú 'Compartir'_."
Cierra este panel.

image::images/facebook1.jpg["Figure: Facebook login",align="center"]

Habiendo establecido una conexión a _Facebook_, transferir un perfil al
historial es fácil.
Selecciona en la *Lista de Inmersiones* de _Subsurface_ el buceo que quieras
transferir; entonces, desde el *Menú* selecciona _Compartir -> Facebook_,
aparecerá un diálogo en el que se definirá la cantidad de información
adicional que se desea compartir en el historial junto con el perfil (ver imagen
*A*, a continuación). Se necesita proporcionar el nombre de un álbum de _Facebook_
para poder enviar el perfil de inmersión. Las casillas seleccionables de la
izquierda nos permiten seleccionar la información que vamos a enviar. Esta
información se muestra en la ventana de texto de la derecha (ver imagen *A*
a continuación). El mensaje que se va a enviar se puede editar directamente en
esta ventana de texto. Tras haber elegido la información y verificado lo que se va
a subir, se selecciona el botón _OK_ lo que inicia la transferencia a _Facebook_.
Unos momentos después aparecerá un mensaje indicando una transferencia correcta.

El álbum creado y el post al historial se marcarán como privados. Para que
los amigos puedan ver el post habrá que cambiar los permisos desde un acceso
normal a _Facebook_ desde un navegador o desde la app de _Facebook_. Aunque
esto suponga un paso de más, los desarrolladores entienden que esta es la mejor
solución para evitar subidas no deseadas en el historial público.

image::images/facebook2.jpg["Figure: Facebook data submission",align="center"]

Si se considera necesario, cierra la conexión a _Facebook_, seleccionando
desde el *Menú principal*, _Compartir -> Desconectar de -> Facebook_ (imagen
*B* anterior).

[[S_Export_other]]
=== Exportar información de buceo a otros destinos o formatos
Para exportar a otros destinos,
se llega a la función de exportación seleccionando _Archivo -> Exportar_ lo que
despliega el diálogo de exportación. Este diálogo siempre ofrece dos opciones:
guardar TODAS las inmersiones, o guardar solo las inmersiones seleccionadas en
el panel *Lista de Inmersiones* de _Subsurface_. Marca la casilla seleccionable
apropiada (ver imagen a continuación).

image::images/Export_f20.jpg["Figura: Diálogo de exportación",align="center"]

Un registro de buceo puede guardarse en tres formatos:

* Formato XML de _Subsurface_. Es el formato usado nativamente por _Subsurface_.


* Universal Dive Data format (UDDF). Ver http://uddf.org para más información.
  UDDF es un formato genérico que permite la comunicación entre muchos ordenadores
  de buceo y programas de de ordenador.
* _Divelogs.de_, un registro de inmersiones basado en internet. Para enviar
  buceos a _Divelogs.de_, se necesita un usuario y una password de _Divelogs.de_.
  Hay que registrarse en _http://es.divelogs.de_ y suscribir el servicio para
  poder enviar datos de inmersiones desde _Subsurface_.
* _DiveShare_ es también un repositorio de inmersiones basado en internet que se
  dirige a inmersiones recreativas. Para subir inmersiones se necesita una
  identificación de usuario, por lo que es necesario registrase en _http://scubadiveshare.com_.
* _Detalles de inmersión CSV_, que incluye la información más crítica del perfil de la
  inmersión. La información que se incluye es número, fecha, hora, duración,
  profundidad, temperatura y presión. En resumen, la mayoría de la información
  que un buceador recreativo conserva en un registro escrito.
* _Perfil de inmersión CSV_, que incluye una gran cantidad de detalles para
  cada inmersión, entre ellos el perfil de profundidad, temperaturas
  e información de presiones para cada inmersión.
* Formato _HTML_, en el cual los buceos se guardan en archivos HTML,
  visualizables con un navegador de internet.Se soportan la mayoría de navegadores
  modernos, pero debe estar activado Javascript. Este archivo *NO* es editable. El
  registro de inmersiones en HTML contiene la mayor parte de la información del
  divelog. Sin embargo, no muestra los valores calculados del panel *Perfil de
  Inmersión*, p.e. la presión calculada de la botella, presiones de los gases o
  PMO. Dispone de una opción de búsqueda que permite rastrear el diario. La exportación
  a HTML se especifica en la segunda pestaña del diálogo de exportación (imagen
  *B* anterior). Un uso típico de esta opción es exportar todas nuestros buceos
  a un smartphone o tablet donde nos serviría de registro portátil, util para
  compañías a las que les gusta verificar el historial de un buceador.
* Formato _mapamundi_, un archivo HTML con un mapa del mundo en el que quedará
  marcada cada inmersión y alguna información sobre ella. El mapa *NO* es
  editable. Si se selecciona cualquiera de los puntos de buceo
  sobre el mapa, se muestra en texto un sumario de la inmersión, como se ve
  en la imagen a continuación.

image::images/mapview_f20.jpg["Figura: Vista de exportación en formato Mapamundi",align="center"]

* Formato _TeX_, un archivo para imprimir usando el software tipográfico TeX.
  Elige un nombre de archivo con extensión '.tex'. También necesitarás un
  archivo de plantilla en la misma carpeta que el .tex que puede obtenerse de
  link:http://www.atdotde.de/%7erobert/subsurfacetemplate/[http://www.atdotde.de/~robert/subsurfacetemplate/].
  El archivo puede procesarse, entonces, con TeX (no LaTeX), por ejemplo con
  el comando '$ pdftex filename.tex'.

image::images/texexample.png["Figure: Export to TeX", align="center"]


* _Profundidad de imágenes_, que crea un fichero de texto que contiene los
  nombres de todos los archivos de imágenes añadidos a cualquiera de los buceos
  seleccionados del la _Lista de inmersiones_, junto con la profundidad a la
  fue tomada la fotografía.

* _Ajustes generales_, en la pestaña HTML, se proporcionan las siguientes
  opciones:
** Numeración de Subsurface: Si se activa esta opción, las inmersiones se
   exportan con la misma numeración que tienen asociada en _Subsurface_. De lo
   contrario, los buceos se numerarán a partir de 1.
** Exportar estadísticas anuales: Si se selecciona esta opción, se anexará una
   tabla con estadísticas anuales a los datos exportados a HTML.
** Solo exportar lista: Solo se exportará una lista de inmersiones. No se
   dispondrá de información detallada de los buceos.
* _Opciones de estilo_: Algunas opciones relativas al estilo de visualización
  en el navegador, como el tamaño de la letra o el tema aplicado.

[[S_Cloud_access]]
== Guardar un diario de _Subsurface_ en la Nube

Para cualquier buceador, la información contenida en su diario es muy importante.
No es únicamente un registro de actividades de buceo para su propio placer
personal, sino que es información importante requerida para su admisión en
futuros cursos de entrenamiento o (en ocasiones) incluso en puntos de buceo. La
seguridad del diario es, así pues, crítica. De cara a poseer un diario que pueda
soportar el fallo del disco duro del ordenador de casa, el robo o la perdida del
equipo, etc, la _nube_ es una solución obvia. Esto, además, añade el beneficio
de que se puede acceder al diario, casi, desde cualquier parte del mundo sin
tener que llevarlo encima. Por este motivo, facilidades como _divelogs.de_ y
_Diving Log_ ofrecen la posibilidad de guardar dicha información en internet.

_Subsurface_ incluye acceso a almacenamiento en la nube integrado de forma
transparente, disponible para todos los usuarios de Subsurface. Guardar y
recuperar un divelog desde la nube no es más difícil que hacerlo desde un disco
duro. El único requisito es que, previamente, nos hemos de registrar como
usuarios. Para utilizar el _Almacenamiento en la nube de Subsurface_ sigue estos
pasos:

=== Crea una cuenta en el almacenamiento en la nube:

** Abrir las _Preferencias de Red_ seleccionando _Archivo_ -> _Preferencias_ ->
   _Red_.
** En la sección llamada _Almacenamiento en la nube de Subsurface_, introduce un
   correo electrónico que _Subsurface_ pueda utilizar para registrarnos.
** Introduce una contraseña que _Subsurface_ utilizará para guardar y recuperar
   el divelog en la nube.
** Se clica en _Aplicar_ o en _OK_ para enviar el email y la password al
   servidor en la nube. El servidor responderá con un correo a la dirección
   facilitada que contendrá un PIN de verificación (está será la única ocasión
   en que _Subsurface_ usará la dirección de correo proporcionada). El diálogo
   _Preferencias de Red_ mostrará una nueva casilla de texto, que no se mostraba
   antes, para el PIN.
** Se introduce el PIN en la casilla correspondiente del diálogo (Este campo solo
   será visible mientras el servidor espera la confirmación de la dirección de
   correo).
** Clica de nuevo en _Aplicar_ o en _OK_ y la cuenta del _Almacenamiento
   de Subsurface en la nube_ se marcará como verificada y se podrá utilizar el
   servicio.

=== Usar el _Almacenamiento de Subsurface en la nube_

** Una vez que se ha inicializado el almacenamiento en la nube, aparecen dos
   nuevas opciones en el desplegable _Archivo_ del _Menú principal_: _Abrir
   almacenamiento en la nube_ y _Guardar en almacenamiento en la nube_. Estas
   opciones permiten al usuario descargar y guardar los registros en el
   servidor de _Subsurface_ en la nube.
** En la pestaña de _Preferencias predeterminadas_ se puede seleccionar usar el
   almacenamiento en la nube como archivo por defecto seleccionando la casilla
   marcada como _Archivo por defecto en la nube_.  Esto significa que los datos
   del almacenamiento en la nube se cargarán al iniciar _Subsurface_ y se
   guardarán allí al salir del programa.

** _Subsurface_ mantiene una copia local de los datos y sigue siendo completamente
   funcional si se utiliza desconectado. Simplemente sincronizará los datos con el
   servidor la próxima vez que se utilice el programa y exista conexión a internet.

[[S_Cloud_storage]]
=== Acceso web al _Almacenamiento de Subsurface en la nube_

Uno de los efectos interesantes de utilizar el _Almacenamiento de Subsurface
en la nube_ es que también se puede acceder a los datos con cualquier navegador.
Simplemente se abre https://cloud.subsurface-divelog.org[https://cloud.subsurface-divelog.org],
se accede con los mismos e-mail y password, y se pueden visualizar los datos
del registro hasta la última sincronización efectuada con el _Almacenamiento
en la nube de Subsurface_. La información que se muestra son solo los contenidos
de los registros, NO los valores calculados que aparecen en el panel *Perfil*,
por ejemplo, presiones de botellas, techos deco o presiones parciales de
O~2~/He/N~2~.

=== Otros servicios en la nube

Si se prefiere no usar el almacenamiento en la nube integrado (y no se necesita
tener acceso vía web a los datos), también resulta muy fácil guardar los
divelogs en la nube usando uno de los servicios disponibles en internet.

Por ejemplo http://www.dropbox.com/[_Dropbox_] ofrece una aplicación gratuita
que permite que se vean como locales en nuestro ordenador los archivos guardados
en sus servidores.

image::images/Cloud.jpg["FIGURE: Carpeta de Dropbox",align="center"]

El programa _Dropbox_ crea una copia del contenido de _Dropbox_ en la nube, en
una carpeta de nuestro ordenador. Cuando el ordenador se conecta a internet, el
contenido de nuestra carpeta y la nube se sincronizan. Así pues, las operaciones
_Abrir_ y _Guardar_ de los diarios se efectúan sobre la copia local de la carpeta
_Dropbox_, no siendo necesario disponer de conexión a internet al realizar estas
operaciones.  Si se modifica la copia local, p.e. al añadir una inmersión, la
copia en el servidor _Dropbox_ en la _nube_ se actualizará automáticamente al
volvernos a conectar a internet.

Actualmente el servicio no tiene ningún coste. Dropbox (Windows, Mac y Linux)
se puede instalar accediendo a la http://www.dropbox.com/install[_página de instalación_]
_de Dropbox_.

Como alternativa, se puede utilizar _Dropbox_ como mecanismo para mantener una
copia de seguridad del diario.

Para guardar un diario en _Dropbox_, selecciona _Archivo-> Guardar como_ desde
menú principal de _Subsurface_, navega a la carpeta Dropbox y selecciona el
botón _Guardar_.  Para usar el diario en _Dropbox_, selecciona _Archivo->Abrir
registro_ desde el menú principal de _Subsurface_, navega al archivo en la
carpeta Dropbox y selecciona el botón _Abrir_.

Existen varios servicios de pago en Internet (Google, Amazon ...) con los que
se puede seguir el mismo proceso para tener los diarios de buceo almacenados en
la nube.

[[S_user_space]]
== Varios usuarios de _Subsurface_ en un solo ordenador

Es frecuente utilizar _Subsurface_ por dos o más personas desde el mismo
ordenador; por ejemplo, los miembros de una misma familia pueden compartir el
mismo ordenador. Existen dos aproximaciones para hacer esto:

*A)* Si los usuarios de un ordenador no inician sesión con diferentes nombres
     de usuario, la forma más simple es que cada uno de ellos utilice su
     propio archivo de divelog con Subsurface. En este caso Juan trabajará con
     el divelog _Juan-divelog_ y María lo hará con _Maria-divelog_. Selecciona
     el registro apropiado desde el *Menú Principal*, _Archivo -> Abrir
     registro_ o desde la parte inferior del menú _Archivo_ donde se mostrarán
     los utilizados recientemente. Sin embargo surgirán problemas si los
     usuarios prefieren diferentes ajustes para _Subsurface_. Por ejemplo, un
     buceador puede preferir visualizar el techo en el perfil y los iconos de
     fotos en la *Lista de Inmersiones* y el otro no. Además, la conexión a la
     nube es única para cada instalación de _Subsurface_ y, si más de un
     usuario deseara guardar datos en la nube sería bastante molesto tener que
     abrir las *Preferencias*  y cambiar cada vez la ID de usuario. Para
     evitar estos problemas, lanza _Subsurface_ con la opción en linea de
     comando _--user=<nombre de usuario>. De esta forma Juan podría ejecutar
     _Subsurface_ con la siguiente instrucción:

         $ subsurface --user=Juan

     y María podría ejecutar _Subsurface_ con:

         $ subsurface --user=Maria

En este caso, las preferencias, ajustes y acceso a la nube de cada
usuario se guardan por separado, permitiendo a cada buceador
interaccionar con _Subsurface_ de la forma que prefiera y con acceso
individual a la nube. El proceso anterior puede hacerse más simple con un
link o acceso con icono de escritorio que ejecute la instrucción. La
utilización de la opción _--user=_ permite a cada usuario crear, mantener
y conservar un divelog separado con una interfaz de usuario
personalizada. De esta forma, cuando cada usuario ejecuta _Subsurface_,
se abre con el divelog correcto y también con las preferencias de
pantalla y conservación correctas, y cada buceador puede acceder a su
propio registro desde dispositivos móviles utilizando
https://subsurface-divelog.org/documentation/subsurface-mobile-user-manual[_Subsurface-Mobile_].

*B)* Por otra parte, si los usuarios acceden al mismo ordenador utilizando
     diferentes códigos de usuario y passwords, _Subsurface_ está disponible
     independientemente para cada usuario y, de forma automática, tienen
     diferentes perfiles de usuario y ajustes, incluyendo acceso único a la
     nube y acceso a _Subsurface-mobile_.

[[S_PrintDivelog]]
== Imprimir un diario

_Subsurface_ proporciona un interfaz simple y flexible para imprimir el diario
completo o solo unas pocas inmersiones seleccionadas. Se pueden utilizar
plantillas pre instaladas o escritas a medida para seleccionar donde situar
los datos en la página.

Antes de imprimir, se deben tomar dos decisiones:

- ¿ Se desea imprimir el registro completo o solo parte de él ? Si solo se desea
  parte del registro, entonces el usuario selecciona los buceos deseados en el
  panel *Lista de inmersiones*.
- ¿ Que información sobre presiones parciales de los gases se desea tener en el
  perfil ? El usuario activaría los botones apropiados de la barra de la izquierda
  del panel *Perfil de Inmersión*.

Si se ha seleccionado_Archivo -> Imprimir_ desde el menú principal, aparecerá
el diálogo siguiente (imagen *A). Se necesita especificar tres cosas para
conseguir el diseño de información deseado:

image::images/Print1_f22.jpg["FIGURA: Diálogo de imresión",align="center"]

1. En _Tipo de impresión_ seleccionar una de las dos opciones:

- _Impresión de lista de inmersiones_: Imprime buceos de la *Lista de inmersiones*
con perfiles y otra información.
- _Impresión de estadísticas_: Imprime estadísticas anuales de las inmersiones.

2. En _Opciones de impresión_ seleccionar:

- _Imprimir solo inmersiones seleccionadas_. Se imprimirán solo las inmersiones de
la lista que se hubieran seleccionado previamente. Si no se activa esta casilla,
se imprimirán *todas* las inmersiones del registro.
- _Impresión en color_.  Si no se selecciona se imprimirá en escala de grises
(blanco y negro).

3. En _Plantilla_ seleccionar una plantilla que usar como distribución de la
página. Existen varias plantillas (ver imagen *B* anterior).

- _Table_: Se imprime una tabla resumen de todas las inmersiones seleccionadas
(ver imagen).

image::images/Print_summarylist_f22.jpg["FIGURA: Imprimir tabla resumen",align="center"]

- _Flow layout_: Imprime el texto asociado a cada inmersión, sin imprimir los
perfiles de los buceos (ver imagen):

image::images/Print_flow_layout_f22.jpg["FIGURE: Print flow layout",align="center"]

-_One Dive_: Imprime una inmersión por página, mostrando el perfil (ver imagen)

image::images/print2_f22.jpg["FIGURE: Print one dive / page",align="center"]

- _Two Dives_: Imprime dos inmersiones por página mostrando los perfiles.
- _Six Dives_: Imprime seis inmersiones por página mostrando los perfiles.

Los usuarios pueden _Previsualizar_ la página a imprimir pulsando el botón
_Previsualizar_ del diálogo (ver imagen *A* al inicio de la sección). Tras
visualizar , se pueden efectuar cambios en las opciones del diálogo de impresión,
hasta completar una distribución que se ajuste al gusto personal.

A continuación, selecciona el botón _Imprimir_ (ver imagen *A* al inicio de
esta sección). Esto activa el diálogo normal de impresión del sistema
operativo, que nos permitirá elegir la impresora y configurar sus propiedades.

image::images/Print_print_f22.jpg["FIGURE: Print one dive / page",align="center"]

Ajusta la resolución de la impresora a un valor apropiado modificando sus
propiedades . Finalmente selecciona el botón _Print_ para imprimir los buceos.
A continuación un ejemplo (bastante pequeño) de la salida de una página.

image::images/Printpreview.jpg["FIGURE: Previsualización de impresión",align="center"]

=== Escribir una plantilla de impresión a medida (avanzado)

Escribir una plantilla a medida es una forma efectiva de producir impresiones
altamente personalizadas. Subsurface utiliza plantillas HTML con Grantlee como
sistema de impresión. Se puede crear una plantilla, exportar una nueva plantilla,
importar una existente o borrarla. Ver el <<S_APPENDIX_E,APÉNDICE E>> para ver
como escribir o modificar una plantilla.

[[S_Configure]]
== Configurar un ordenador de buceo

_Subsurface_ permite configurar algunos ordenadores de buceo. En estos momentos,
los Heinrichs-Weikamp OSTC2 y OSTC3 y los Suunto de la familia Vyper (Stinger,
Mosquito, D3, Vyper, Vytec, Cobra, Gekko y Zoop).  Se pueden leer y modificar un
gran número de ajustes. En primer lugar hay que asegurarse de tener instalado el
driver adecuado para el ordenador de buceo y de conocer el nombre de dispositivo
asignado al ordenador por el sistema operativo.
Ver el <<_apendice_a_informacion_especifica_del_sistema_operativo_para_importar_inmersiones_desde_un_ordenador_de_buceo, APÉNDICE A>>
para información sobre como hacerlo.

Una vez que el ordenador de buceo está al PC con _Subsurface_, se selecciona
_Archivo -> Configurar ordenador de buceo_ en el menú principal. Si se ha
indicado el nombre de dispositivo correcto en el campo de texto de la parte
superior, esto abrirá y seleccionará el modelo correcto en el panel de la
izquierda (ver imagen a continuación).

image::images/Configure_dc_f20.jpg["FIGURA: Configurar ordenador de buceo",align="center"]

Utilizando los botones apropiados del panel de configuración, pueden llevarse
a cabo las siguientes acciones:

 - *Descargar detalles disponibles*. Descarga a _Subsurface_ la configuración
del ordenador de buceo, mostrándola en el panel.
 - *Guardar cambios en el dispositivo*. Esto cambia la configuración del
ordenador de buceo para hacerla coincidir con la que se muestra en el panel.
 - *Copia de seguridad*. Guarda los datos de configuración en un archivo.
_Subsurface_ solicitará una ubicación y un nombre de archivo para guardar la
información.
 - *Restaurar copia de seguridad*. Carga la información de un archivo de copia
de seguridad y la muestra en el panel.
 - *Actualizar firmware*. Si está disponible un nuevo firmware para el
ordenador de buceo, este será cargado al mismo.

[[S_Preferences]]
== Ajustar las Preferencias del usuario para _Subsurface_

Hay varios ajustes en _Subsurface_ que el usuario puede especificar. Se
encuentran a través de _Archivo → Preferencias_. Los ajustes se efectúan en
seis grupos: *Predeterminados*, *Unidades*, *Gráfico* , *Lenguaje*, *Red*,
y *Georeferencia*. Las
siete secciones funcionan con los mismos principios: el usuario debe especificar
los ajustes que desee modificar, luego aplicarlos usando el botón *Aplicar*.
En este punto los nuevos ajustes no se han guardado aún. Para aplicarlos
permanentemente, selecciona el botón _Guardar_. Si no se desea, pulsa
_Cancelar_.

=== Predeterminados

Hay varios ajustes en el panel *Predeterminados*:

image::images/Pref1_f23.jpg["FIGURA: Pantalla de Predeterminados en Preferencias",align="center"]

** *Listas y tablas*: Aquí se pueden elegir el tipo de fuente y el tamaño de la
    misma en el panel *Lista de inmersiones*. Reduciendo el tamaño de la fuente, se
    pueden ver más buceos en una sola pantalla.

** *Inmersiones*: En este bloque se especifica la carpeta y nombre de archivo
    del registro de buceo electrónico. Es un archivo con extensión .xml o .ssrf. Al iniciar
    _Subsurface_ sin argumentos cargará automáticamente el registro especificado
    aquí. Existen tres opciones:
    - _Sin archivo por defecto_: Si se selecciona, _Subsurface_ no abre ningún
      archivo automáticamente al iniciarse
    - _Archivo por defecto local_: Si se selecciona, _Subsurface_ abre un archivo
      del disco duro local al iniciarse.
    - _Archivo por defecto en la nube_: Si se selecciona, _Subsurface_ abre el
      divelog en la nube que se inicializó desde la pestaña _Red_ de las
      *Preferencias* (ver a continuación).

** *Mostrar invalidas*: Las inmersiones pueden marcarse como "invalidas" (cuando
    el usuario desea ocultar buceos que no considere validos, p.e. en piscina, pero
    aún quiera mantenerlos registrados en el diario). Esta opción controla si estas
    inmersiones se muestran en la lista.

** *Botella por defecto*: Se puede especificar una botella por defecto de las
    que apareceran en la lista desplegable.
    Es muy cómodo si se bucea habitualmente con el mismo tipo de botella, asigna a
    cada nueva inmersión una botella del tipo aquí definido.

** *Animaciones*: Algunas acciones, al mostrar el perfil, se ejecutan utilizando
    animaciones. Por ejemplo, los valores de los ejes para la profundidad y el
    tiempo cambian de una inmersión a otra. Al visualizar inmersiones distintas
    estos cambios en las características de los ejes no suceden de forma
    instantánea, sino que son animados. La _Velocidad_ de las animaciones puede
    controlarse ajustando esta regleta, con mayor velocidad a la izquierda y
    significando "0" ninguna animación en absoluto.

** *Servicio web de Subsurface*: Cuando uno se suscribe al <<S_Companion,
    servicio web de Subsurface>>, se proporciona una ID de usuario muy larga y
    difícil de recordar. Este es el lugar donde guardar esa ID. Seleccionando la
    opción _¿Guardar localmente la ID de usuario?_ nos aseguramos de que se guarda
    una copia de dicha ID en el ordenador.

** *Borrar todos los ajustes* Tal como se indica en el botón bajo esta cabecera,
    se borran todos los ajustes y se reinician con los valores por defecto.

=== Unidades

image::images/Pref2_f23.jpg["FIGURA: Página de preferencias de unidades",align="center"]

Aquí el usuario puede elegir entre medidas métricas o imperiales para
profundidad, presión, volumen, temperatura y masa. Al seleccionar el botón de
Métrico o Imperial de arriba, el usuario indica que todas las unidades vayan en
las correspondientes al sistema elegido. Como alternativa, si se selecciona
*Personalizar* se pueden mezclar, con algunas medidas en métrico y otras en
imperial.

Independientemente de los ajustes citados, en la opción _Unidades de tiempo_
se puede elegir si se desea que las
velocidades de ascenso/descenso se muestren en m/s o en m/min. Los buzos con
botella, habitualmente, manejan velocidades en m/min, sin embargo, los apneístas
ascienden mucho más deprisa por lo que suelen utilizar velocidades en m/s.
Igualmente, las coordenadas GPS pueden representarse de la forma tradiciona
(grados, minutos, segundos) o como grados con decimales, elige la más adecuada
a tus necesidades.


=== Gráfico
[[S_CCR_options]]

image::images/Pref4_f23.jpg["FIGURA: Página de Preferencias del gráfico",align="center"]

[[S_GradientFactors]]
Este panel permite dos tipos de selecciones:

* *Ajuste de las Presiones de Gases*. Aunque también se incluyen las presiones
parciales de nitrógeno y helio, esta parte corresponde principalmente a la
gestión del oxígeno:
* ** _Umbrales_: _Subsurface_ puede mostrar las presiones parciales de nitrógeno,
   oxígeno y helio durante el buceo. Se activan utilizando la barra de herramientas
   de la izquierda de panel *Perfil de inmersión*. Para cada uno de estos gases,
   los usuarios puede especifica un valor umbral a la derecha en el panel de
   Preferencias. Si cualquiera de los gráficos sube por encima de este nivel,
   entonces el gráfico se resalta en rojo, indicando que se ha excedido dicho
   umbral de presión parcial. El umbral de pO~2~ es el más importante y se
   suele usar un valor de 1.6.

** _pO~2~ al calcular la PMO_ es el valor usado para calcular la profundidad
   máxima operativa (PMO o MOD) de un gas. Especifica una presión parcial
   apropiada. Habitualmente se usa un valor de 1.4.

** CCR Options: Estas opciones determinan la gestión del oxigeno en
inmersiones con CCRs
*** _Setpoint por defecto en el Planificador_: Especifica el setpoint de O~2~
    de una planificación con CCR. Este dertermina la pO~2~ a mantener durante el
    buceo. Se pueden añadir cambios a lo largo de la inmersión desde el menú
    contextual.

*** _CCR: Mostrar los setpoints al ver la pO~2~_: Con esta casilla activada,
    el gráfico de pO~2~ del Perfil mostrará una capa en rojo que indicará los
    valores del setpoint. Ver la sección en
    xref:S_CCR_dives[Inmersiones con Rebrather de circuito cerrado].

*** _CCR: Mostrar los valores individuales de los sensores de O~2~ al ver la
    pO~2~_: Muestra los valores de pO~2~ asociados con cada uno de los sensores de
    oxígeno de un sistema CCR. Ver la sección de
    xref:S_CCR_dives[Inmersiones con Rebrather de circuito cerrado].

* *Ajuste del techo*. Estos ajustes tienen que ver con la gestión del
  nitrógeno y el helio al determinar como el techo de descompresión (techo de
  ascenso) se calculará y se mostrará:

** _Trazar en rojo el techo informado por el ordenador de buceo_: Esta casilla
   seleccionable permite exactamente lo que dice. El color por defecto es blanco.
   No todos los ordenadores de buceo
   facilitan los valores de los techos. Si el ordenador de buceo lo facilita, puede
   diferir de los techos calculados por _Subsurface_. Esto se debe al uso de
   diferentes algoritmos, diferentes factores de gradiente y a la forma dinámica en
   que los ordenadores de buceo calculan los techos durante la inmersión.

** _Algoritmo para calcular el techo_. Seleccionar entre el modelo
   descompresivo Bühlmann ZH-L16 y el modelo VPM-B:
*** _VPM-B_: Indica un nivel de conservadurismo para calcular el techo. Los
valores varían entre 0 (menos conservativo) y 4 (más conservativo).

[[GradientFactors_Ref]]

*** _Bühlmann_: Indica los factores de gradiente (GFbajo y GFalto) para
calcular el techo utilizando el algoritmo de Bühlmann ZH-L16. GF_bajo es el
factor de gradiente a profundidad y GF_alto el factor de gradiente en
superficie.
Los factores de gradiente añaden conservadurismo a la exposición al nitrógeno
y el helio de forma similar al ajuste de conservadurismo de muchos
ordenadores. A menor valor de un factor de gradiente, tanto más conservativos
son los cálculos con respecto a la carga de gases inertes y la profundidad de
los techos. Factores de gradiente de 20/60 se consideran conservativos y de
70/90 se consideran arriesgados.
Además hay que decidir si se activa la casilla _GFbajo a la máxima
profundidad_. Si se selecciona, el GF_bajo se usa para la profundidad máxima
del buceo y se incrementa linealmente hasta el GF_alto al llegar a superficie.
Si no se selecciona, el GF_bajo se usa entre la máxima profundidad y la
primera parada de descompresión, a partir de la cual el factor de gradiente se
incrementará linealmente hasta el valor del GF_alto en superficie. Para más
información visita

*** http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values by Erik Baker, _Immersed_ Vol. 3, No. 3.]

*** http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/5037-gradient-factors-for-dummies.html[Gradient factors for dummies, by Kevin Watts]

** _Opciones de _pSCR_. Estas preferencias determinan como se planificará las
inmersiones con rebrather de circuito semicerrado pasivo (pSCR) y como se
calculará el techo de descompresión:

** _Ratio metabólico_: Para un rebreather semicerrado (pSCR)
   este es el volumen de oxígeno usado por el buceador en un minuto. Fija este
   valor para planificar buceos con pSCR y cálculos de descompresión.

** _pSCR Ratio_: En equipos pSCR el ratio de vertido es la cantidad de gas
   expulsada del circuito frente a la cantidad de gas recirculada en el circuito.
   Se suele usar un ratio 1:10.

* *Miscelanea*

**_Mostrar botellas no usadas en la pestaña Equipo_: Esta casilla permite
mostrar la información de botellas no utilizadas al visualizar la pestaña
*Equipo*. Si la casilla no se selecciona y existen en la inmersión botellas
que no se han usado, estas botellas se omiten en la lista.

**_Mostrar la profundidad media en el perfil_: Si se activa esta casilla, el
panel de *Perfil de Inmersión* mostrará una línea gris con la profundidad
media de la inmersión hasta un momento dado. Normalmente es una curva con
forma de "U" mostrando la media más profunda justo antes de iniciar el
ascenso.

=== Lenguaje

Se elige el lenguaje que debe utilizar _Subsurface_.

image::images/Pref3_f23.jpg["FIGURA: página de preferencias de lenguaje",align="center"]

Una casilla de selección permite usar el lenguaje _Predeterminado del sistema_
que, en la mayoría de los casos será el ajuste correcto; con esto _Subsurface_
simplemente se ejecuta con los mismos ajustes de lenguaje/país que el SO
subyacente. Si esto, por alguna razón, no fuera deseable, se puede deseleccionar
la casilla y elegir una de las combinaciones de lenguaje/país incluidas en la
lista de traducciones. La casilla de texto _Filtro_ permite listar lenguajes
similares. Por ejemplo hay diversas variantes de inglés o francés.

En esta sección también se pueden especificar los formatos apropiados de fecha
y hora que se usarán en los detalles de las inmersiones.

=== Red

Este panel facilita la comunicación entre _Subsurface_ y las fuentes de datos en
internet.

Esto es importante cuando _Subsurface_ tiene que comunicarse con servicios como
el <<S_Companion,servicio web de _Subsurface_>> o importar/exportar datos de
_Divelogs.de_. El acceso a internet viene determinado por el tipo de conexión y
por el proveedor de acceso (ISP) utilizado. El ISP debería proporcionar la
información necesaria.

image::images/Pref5_f23.jpg["FIGURA: página de preferencias de red",align="center"]

Este diálogo tiene tres secciones:

** _Tipo de proxy_:
   Si se utiliza un servidor proxy para acceder a internet, el tipo de proxy se
   selecciona del desplegable, tras
   lo cual debe facilitarse la dirección IP del servidor y el número de puerto. Si
   el servidor proxy utiliza autenticación también han de indicarse el usuario y su
   password para que _Subsurface_ pueda pasar automáticamente a través del proxy
   para acceder a internet.

** _Almacenamiento en la nube de Subsurface_:
   Para poder guardar nuestro divelog en la nube, se precisa una dirección
   de correo electrónico y una password. Esto permite a _Subsurface_ mandar
   un correo electrónico al usuario con información de seguridad relativa al
   almacenamiento en la nube. Tiene dos opciones adicionales:
   - _Sincronizar con la nube en segundo plano_: Permite guardar la información
     en la nube mientras el usuario lleva a cabo otras tareas en _Subsurface_.
   - _Guardar contraseña localmente_: Permite guardar la contraseña de acceso
     a la nube en el disco duro. ¡¡¡ OJO !!! La contraseña se guarda en texto
     plano sin encriptar.

** _Servicio web de Subsurface_:
   Al suscribirnos al <<S_Companion,Servicio web de Subsurface>>, se nos
   facilita una identificación de usuario muy larga y dificil de recordar.
   Este es el lugar donde guardarla. Seleccionando la opción, nos asegurammos
   de tener una copia local de la misma.

=== Georefencia

_Subsurface_ proporciona un servicio de búsqueda geográfica (Esto es, la
capacidad de buscar el nombre de un lugar, en base a unas coordenadas
geográficas proporcionadas haciendo clic en el panel *Globo*, de un GPS o
desde la app _Subsurface companion_) basado en internet, que localiza el
nombre conocido más cercano a nuestra posición. Obviamente la función solo
actúa con conexión a internet. La configuración se puede efectuar como en
la imagen a continuación

image::images/Pref7_f23.jpg["FIGURE: Facebook login panel",align="center"]

[[S_DivePlanner]]
== El Planificador de _Subsurface_
La planificación de inmersiones es una característica avanzada de _Subsurface_
accesible desde _Registro -> Planificar Inmersión_ en el menú principal. Permite
calcular la carga de gases inertes durante una inmersión utilizando el algoritmo
Bühlmann ZHL16 con factores de gradiente tal y como lo implementó Erik Baker.

****
[icon="images/icons/warning2.png"]
[WARNING]

Esta prestación *ES EXPERIMENTAL* y supone que el usuario ya está familiarizado
con el interfaz de _Subsurface_. Se utiliza *EXPLICITAMENTE* bajo las siguientes
condiciones:

- El usuario está versado en la planificación de inmersiones y tiene el
  entrenamiento necesario para planificar inmersiones.
- El usuario planifica buceos dentro de los límites para los que está
  certificado.
- La planificación de inmersiones hace grandes suposiciones sobre las
  características de la _persona media_ y no puede compensar las características
  fisiológicas individuales , de salud o de estilos de vida.
- La seguridad de un plan de buceo depende mucho de la forma en que se use el
  planificador.
- El usuario esta familiarizado con la interfaz de usuario de _Subsurface_.
- Un usuario que no este completamente seguro de cualquiera de los requisitos
  anteriores, no debería utilizar esta capacidad de _Subsurface_.
****

=== La pantalla del planificador de _Subsurface_

Al igual que el diario de _Subsurface_, la pantalla del planificador se divide
en varias secciones (ver imagen a continuación). Los parámetros de ajuste de una
inmersión se introducen en las diversas secciones a la izquierda de la pantalla.
El ajuste se divide en varias secciones: Gases disponibles, Ritmos, Planificar,
Opciones de gases y Notas.

Arriba a la derecha hay un *panel de diseño* verde sobre el cual puede
manipularse directamente el perfil de inmersión arrastrando y haciendo clic como
se explica a continuación. Esta característica hace al planificador de
_Subsurface_ único en facilidad de uso.

Abajo a la derecha hay un panel de texto con la cabecera _Detalle del Plan_.
Aquí es donde se proporcionan los detalles del plan de inmersión de forma que
pueda copiarse con facilidad a otro software. También es donde se imprimirá
cualquier mensaje de aviso sobre el plan de buceo.

image::images/PlannerWindow1_f20.jpg["FIGURA: Ventana de inicio del planificador",align="center"]

=== Inmersiones con circuito abierto

- En la parte de abajo al centro del planificador (círculo azul en la imágen
  anterior) hay un desplegable con tres opciones. Selecciona la correcta
  entre ellas:
  ** Circuito abierto (por defecto)
  ** CCR
  ** pSCR

- En el área de arriba a la izquierda de la pantalla del planificador, hay que
  asegurarse de que los parámetros constantes son correctos. Son: Fecha y hora
  de inicio de la inmersión, Presión atmosférica, y altura sobre el nivel del
  mar. Estos dos últimos están relacionados, variando uno se modifica el otro.
  La presión atmosférica por defecto a nivel del mar son 1.013 bar.

- En la tabla etiquetada como _Gases disponibles_, añadir la información de las
  botellas que se han de utilizar y la composición de los gases de cada botella.
  Esto se hace de forma similar a <<cylinder_definitions,como se rellena la información
  de botellas en un diario>>. Se elige el tipo de botella de la lista desplegable
  y se especifica la presión de trabajo de la botella. Si dejamos en blanco la
  concentración de oxígeno (O2%) se asume que el gas que contiene es aire. En otro
  caso, se introducen las concentraciones de oxígeno y/o helio en las casillas del
  diálogo. Si es necesario , se añaden botellas utilizando el icono "+" de arriba
  a la derecha.

- La tabla _Gases disponibles_ incluye tres campos para profundidades,
  etiquetados:
 ** Cambio deco a: La profundidad de cambio para gases deco. A menos que las
    cambie el usuario, se calcularan automáticamente en base a la preferencia de
    pO₂ para la deco (por defecto 1.6 bar).
 ** PMO Fondo: La profundidad máxima opertiv del gas, si se utiliza como gas
    de fondo. Calculada automáticamente en base la preferencia de pO₂ (por
    defecto 1.4 bar). Editar este campo modificará el O₂% de acuerdo con la
    profundidad marcada. Ajustalo a ''*'' para calcular el mejor O₂% para la
    profundidad máxima del buceo.
 ** MND: La profundidad narcótica máxima del gas. Calculada automáticamente en
    base a la preferencia marcada como END (por defecto 30m). Editar este campo
    modificará el He% de acuerdo con la profundidad marcada.  Ajustala a ''*''
    para calcular el mejor He% para la profundidad máxima.

- El perfil del buceo a planificar se puede crear de dos maneras:
 * Arrastrar los puntos del perfil
   (los pequeños círculos blancos) para que representen la inmersión. Se pueden
   crear puntos adicionales haciendo doble-clic sobre el perfil de buceo. Se
   pueden borrar haciendo clic-derecho en un punto concreto y seleccionando
   _borrar_ en el menú contextual.
 * La forma más eficiente de crear un perfil es introducir los valores
   apropiados en la tabla llamada _Puntos del planificador de inmersiones_.
   La primera línea de la tabla representa la duración y profundidad final
   de un descenso desde superficie. Los segmentos siguientes describirán la
   fase de fondo de la inmersión. La columna _CC setpoint_ solo es relevante
   para para buceadores en circuito cerrado.
   El ascenso, normalmente, no se especifica, ya que esto es lo que se supone
   que el planificador debe calcular.
   Añade segmentos adicionales al perfil utilizando el icono "+" arriba a la
   derecha de la tabla. Los segmentos introducidos en la tabla aparecen de
   forma automática en el diagrama "Perfil de la inmersión".

==== Inmersiones recreativas

El modo recreativo es lo que más se aproxima a planificar una inmersión
basándonos en el límite de no descompresión (LND). Tiene en cuenta el tiempo
que un buceador puede estar a la profundidad actual sin incurrir en paradas
de descompresión obligatorias, y usando el gas disponible menos una reserva.
El planificador  tiene en cuenta automáticamente la carga nitrógeno acumulada
en inmersiones previas. Sin embargo, las tablas convencionales también tienen
en cuenta los buceos anteriores ¿Por qué utilizar un planificador para buceos
recreativos? Al utilizar las tablas recreativas se tiene en cuenta la máxima
profundidad de una inmersión. Sin embargo, pocas inmersiones se efectúan a
una profundidad constante que corresponda con la máxima (perfil "cuadrado").
Esto supone que las tablas sobre estiman la carga de nitrógeno acumulada de
las inmersiones previas. El planificador de _Subsurface_ calcula la carga de
nitrógeno de acuerdo con los perfiles reales de las inmersiones anteriores de
forma similar a como lo hacen los ordenadores de buceo durante la inmersión.
Esto significa que el buceador es "bonificado" por no permanecer a profundidad
máxima en las inmersiones anteriores, permitiendo planificar una inmersión
posterior más larga. Para que el planificador funcione es, pues, crucial haber
descargado a _Subsurface_ todas las inmersiones anteriores antes de hacer la
planificación.

Para planificar un buceo, es necesario definir los ajustes apropiados.

- Asegurarse de que el día y la hora se han ajustado a los de la inmersión
planeada. Esto permite calcular la carga de nitrógeno de los buceos anteriores.

- Justo bajo la cabecera _Planificar_ hay dos casillas seleccionables
  _Recreativo_ y _Parada de seguridad_. Para inmersiones recreativas se seleccionan
  ambas casillas.

- Luego se define el tamaño de las botellas, la mezcla de gas (aire o % de
  oxígeno) y la presión inicial de las botellas en la parte superior izquierda
  del planificador, en _Gases disponibles_.

- El planificador calcula si la botella elegida contiene suficiente aire/gas
  para completar la inmersión planeada. Para que esto sea realista, bajo
  _Opciones de gases_, se especifica un consumo de aire en superficie (CAS)
  adecuado para la opción _CAS en fondo_. Los valores adecuados se situarían
  entre 15 l/min y 30 l/min, siendo para buceadores noveles o buceos difíciles
  próximos a 30 l/min.

- Definir la cantidad de gas que se pretende que sobre en la botella al final
  de la inmersión, justo antes de iniciar el ascenso. Se suele usar un valor de
  50 bar. La razón para esta reserva de gas guardarlo para una posible
  necesidad de ascender compartiendo aire con el compañero. Es bastante
  difícil estimar cuanto gas se usaría al compartir, así que la mayoría de
  agencias establecen una cantidad fija p.e 40 o 50 bares. _Subsurface_ aún lo
  hace mejor, porque conoce el ascenso y tiene en cuenta el gas consumido en
  el mismo. Además de esto, _Subsurface_ aún utiliza una reserva fija de
  presión. La cantidad de gas de esta reserva puede ser configurada por el
  usuario.

- Definir la profundidad de la inmersión arrastrando los puntos blancos en el
  perfil o introduciendo la profundidad en la tabla que se encuentra en _Puntos
  del planificador de inmersiones_. Si se tratara de una inmersión multinivel,
  se añaden los puntos necesarios que representen el plan, bien añadiéndolos en
  el perfil de la inmersión, bien en la tabla citada. _Subsurface_ extenderá
  la sección de fondo de la inmersión a la duración máxima dentro del LND.

- Se puede modificar la velocidad de ascenso. Las velocidades de ascenso
  establecidas por defecto son aquellas consideradas seguras para el buceo
  recreativo.

- El perfil del planificador indica el tiempo máximo de inmersión dentro de
los límites de no descompresión, utilizando el algoritmo Bülmann ZH-L16 y el
gas y la profundidad especificados como se ha descrito anteriormente. El
planificador de _Subsurface_ permite una visualización rápida de la duración
de una inmersión en función de la profundidad, teniendo en cuenta la carga de
nitrógeno residual resultante de las inmersiones previas. El plan de buceo
incluye una estimación de la cantidad de aire/gas que se va a utilizar,
dependiendo de los ajustes de las botellas especificadas en _Gases disponibles_.
Si la presión inicial de la botella se ajusta a "0", la duración del buceo que
se mostrará será el auténtico límite de no descompresión (LND) sin tener en
cuenta el gas utilizado durante la inmersión. Si la superficie sobre el perfil
se vuelve roja, significa que se han sobrepasado los límites del buceo recreativo
y se necesita reducir, bien la profundidad, bien la duración.

A continuación se muestra una imagen de un plan para una inmersión recreativa
a 30 metros. Aunque el límite de no descompresión es 23 minutos, la duración
del buceo se ve limitada por la cantidad de aire en la botella, reflejada por
la ventana de texto informativa abajo a la derecha del panel en la que se nos
indica que no existe suficiente gas para compartir con el compañero durante el
ascenso.

image::images/rec_diveplan.jpg["FIGURE: A recreational dive plan: setup",align="center"]

==== Inmersiones en circuito abierto no recreativas, incluyendo descompresión

La planificación no recreativa supone exceder los límites de no descompresión
y/o utilizar múltiples gases.  Tales inmersiones se planifican en tres fases:

*a) Control de gases inertes*: Esto se consigue especificando las velocidades
de descenso y ascenso, así como el modelo descompresivo (GF bajo y GF alto o
nivel de conservadurismo) bajo los encabezamientos _Velocidades_ y _Planificar_
en la parte inferior de la pantalla de planificación. Están soportados dos
modelos descompresivos, el modelo Bühlmann y el modelo VPM-B. Elige uno de los
dos modelos. Si se selecciona el modelo Bühlmann, se necesita especificar los
factores de gradiente (GF_alto y GF_bajo). En principio se utilizarán los
factores de gradiente especificados en la pantalla de _Preferencias_ de
_Subsurface_. Si se modifican en el planificador(ver _Opciones de gases_), se
utilizan los nuevos valores sin modificar los marcados en las _Preferencias_.
Los ajustes de los factores de gradiente afectan enormemente a los techos
calculados y sus profundidades.
Un _GF bajo_ muy pequeño produce paradas de descompresión más pronto durante la
inmersión.
** Para más información sobre factores de gradiente visita la sección
xref:S_GradientFactors[Ajustes de la Preferencias de factores de gradiente].

Si se seleccioná ell modelo VPM-B, es necesario especificar el nivel de
conservadurismo, en una escala de 0 (menos conservador) a 4 (más conservador).
Este modelo tiende a dar paradas deco a mayores profundidades que el modelo de
Bühlmann y, a menudo, produce perfiles ligeramente más cortos que este último
al coste de mayores presiones en los tejidos de los compartimentos lentos..
Cuando elijas uno de los modelos, recuerda que no son modelos fisiológicos
exactos, sino modelos matemáticos que parecen funcionar en la práctica.

Para más información externa a este manual ver:

 * link:http://www.tek-dive.com/portal/upload/M-Values.pdf[Understanding M-values by Erik Baker, _Immersed_ Vol. 3, No. 3.]
 * link:http://www.rebreatherworld.com/general-and-new-to-rebreather-articles/5037-gradient-factors-for-dummies.html[Gradient factors for dummies, por Kevin Watts]
 * link:http://www.amazon.com/Deco-Divers-Decompression-Theory-Physiology/dp/1905492073/ref=sr_1_1?s=books&ie=UTF8&qid=1403932320&sr=1-1&keywords=deco+for+divers[_Deco for Divers_, by Mark Powell (2008). Aquapress] Southend-on-Sea, UK. ISBN 10:1-905492-07-3. Un excelente estudio no técnico en el que se discuten ambos modelos, el de Bühlmann y el VPM-B.

La velocidad de ascenso es crítica para la desgasificación al final de la
inmersión y se especifica para varios rangos utilizando la profundidad media
como vara de medir. La profundidad media del plan se indica como una línea gris
sobre el perfil. Las velocidades de ascenso en los niveles más
profundos se sitúan, a menudo, en el rango de 8 a 12 m/min, mientras que en los
niveles más superficiales suelen estar en los 3 a 6 m/min llegando en ocasiones
a 1 m/min. La velocidad de descenso también se especifica. Si activamos la
opción _Caer a la primera profundidad_ , la fase de descenso se efectuará a la
máxima velocidad indicada en la sección _Velocidades_ de los ajustes.

*b) Control del oxígeno*: En las _Opciones de gases_ es necesario
especificar la máxima presión parcial de oxígeno para la parte del fondo
(_pO2 en fondo_ ) y también para la fase de descompresión (_pO2 en deco_).
Los valores más comunes son 1.4 bar para el fondo de la inmersión y 1.6 bar
para las paradas de descompresión. Habitualmente no se excede una presión
parcial de 1.6 bar de O2. Los ajustes de pO2 y la profundidad a la que cambiar
de gases también pueden editarse en el diálogo _Gases disponibles_. Normalmente
el planificador decide el cambio a otro gas cuando, durante el ascenso, la
presión parcial del nuevo gas se sitúa por debajo de 1.6 bar.

*c) Control del gas*: En inmersiones con circuito abierto esta es una
consideración prioritaria. Es necesario mantenerse en los límites de la cantidad
de gas de la botella, manteniendo un margen de seguridad apropiado para regresar
a superficie, posiblemente compartiendo gas con un compañero. En las _Opciones
de gases_ especifica la mejor (pero conservativa) estimación de tu "consumo de
aire equivalente a superficie" (CAS, del inglés SAC, también llamado RMV) en
litros/minuto (en estos momentos solo están soportadas las unidades del Sistema
Internacional). Se especifica el CAS para el fondo (_CAS en fondo_) y también
para la fase de descompresión (_CAS en deco_). Son comunes valores de 15 a
30 l/min. Para hacer una buena gestión del gas, una regla del pulgar no es
suficiente y se necesita monitorizar el consumo regularmente, dependiendo de
diferentes condiciones ambientales y de equipo. El planificador calculará el
volumen total de gas a utilizar durante la inmersión y emitirá un aviso si se
excede la cantidad total de gas disponible. Las buenas prácticas exigen que no
se bucee al límite del gas disponible, sino que se mantenga una reserva de gas
apropiada para atender circunstancias imprevistas. En el caso del buceo técnico,
esta reserva puede ser, fácilmente, del 66% del gas disponible.

Ahora, por fin, se puede empezar la planificación detallada de tiempos y
profundidades. _Subsurface_ ofrece una interfaz gráfica única para llevar a cabo
esta parte de la planificación. El mecanismo es similar a introducir a mano un
perfil en el diario de inmersiones. Al activar el planificador, se genera un
perfil por defecto de 40 minutos a 15 metros. Los puntos blancos (puntos de
paso) del perfil, se pueden arrastrar con el ratón. Se crean más puntos haciendo
doble-clic en la línea del perfil. Se arrastran los puntos de paso paso hasta
estar seguros de que el perfil refleja la inmersión que se pretende efectuar.
No es necesario especificar la fase de ascenso ya que será calculada por el
planificador basándose en los ajustes que se hayan especificado.
Si se sobrepasa cualquiera de los límites establecidos, la superficie sobre el
perfil se volverá roja.

Cada punto de paso en el perfil crea un _punto en el planificador_ en la tabla
a la izquierda del panel del planificador. Hay que asegurarse de que el valor
del _Gas usado_ en cada fila de esta tabla corresponde a una de las mezclas
especificadas en la tabla de _Gases disponibles_. Se añaden nuevos puntos hasta
que las principales características del buceo estén completas, p.e. el segmento
de tiempo en el fondo y paradas profundas (si se implementan). Se dejan los
restantes puntos del ascenso a _Subsurface_. En la mayoría de los casos
_Subsurface_ calcula puntos de paso adicionales para completar los requisitos
de descompresión de la inmersión.

Los puntos de paso relacionados en el diálogo _Puntos del planificador_ pueden
editarse a mano para obtener una representación precisa del plan. De hecho
podría crearse el plan completo editando los puntos desde el diálogo.

Indica cualquier cambio de gas, tal como se explicaba en la sección
<<S_CreateProfile,Crear a mano un perfil de inmersión>>. Estos cambios deberían
reflejar las botellas y composiciones de gas definidas en la table _Gases
disponibles_. Si se usan dos o más gases, se sugerirán automáticamente cambios
de gas durante la fase de ascenso a superficie. Sin embargo, estos cambios
pueden borrarse haciendo clic-derecho en el cambio de gas, o pueden crearse
manualmente de la misma forma, haciendo clic-derecho en el punto de paso
adecuado.

A continuación hay un ejemplo de planificación de inmersión a 45m usando EAN26,
seguido de un ascenso usando EAN50:

image::images/DivePlanner2_f20.jpg["FIGURA: Planificar una inmersión: construcción",align="center"]

Una vez que lo anterior se ha completado, se puede guardar clicando el botón
_Guardar_ arriba en el centro del panel del planificador. El plan de buceo
guardado aparecerá en el panel *Lista de Inmersiones*.

*Los detalles del plan de buceo*

En la parte inferior derecha del planificador, bajo el encabezamiento _Detalles
del plan de buceo_, se proporcionan los detalles exactos del plan de inmersión.
Estos detalles pueden modificarse seleccionando cualquiera de las opciones bajo
el encabezamiento _Notas_ del planificador, justo a la izquierda
del anterior. Si se solicita un _Plan de buceo detallado_, se obtendrá un plan
detallado al nivel de oraciones. Si cualquiera de los límites especificados se
sobrepasa, se obtendrá un mensaje de aviso bajo la información del plan.

Si se selecciona la opción _Mostrar duración de segmentos_, se indicará la
duración de cada segmento de profundidad en los _Detalles del plan de buceo_.
Esta duración INCLUYE el tiempo de transición hasta llegar al nivel. Sin
embargo, si se selecciona _Mostrar transiciones en deco_, las transiciones se
muestran separadamente de las duraciones de las paradas en cada nivel.

=== Planificar inmersiones con pSCR

Para planificar una inmersión usando un rebreather pasivo de circuito
semi-cerrado, selecciona _pSCR_ en lugar de _Circuito abierto_ en la lista
desplegable.
Los parámetros para la inmersción con pSCR se pueden ajustar seleccionando
_Archivo -> Preferencias -> Gráfico_ desde el menú principal, donde el cálculo
de consumo de gas tiene en cuenta el ratio de vertido (por defecto 1:10) así
como el ratio de metabolismo. El cálculo también tiene en cuenta la pérdida
de oxígeno por la boquilla del rebreather. Si la pO~2~ cae por debajo de lo que
se considera un valor seguro, aparecerá un aviso en los _Detalles del plan de
buceo_.  Una configuración típica con pSCR es con una sola botella y una o más
botellas de emergencia. Así pues, el ajuste de las tablas de _Gases disponibles_
y _Puntos del planificador_ son muy similares a las de un plan con CCR, como se
ha descrito anteriormente. Sin embargo, no se especifican setpoints de oxígeno
en las inmersiones con pSCR. A continuación hay un plan de inmersión para un
buceo con pSCR. El buceo es comparable al anterior con CCR, pero hay que hacer
notar la mayor duración del ascenso debido al menor contenido de oxígeno en el
circuito por la caída de oxígeno en la boquilla del equipo pSCR.

image::images/Planner_pSCR1_f20.jpg["FIGURE: Planning a pSCR dive: setup",align="center"]

=== Planificar inmersiones con CCR

Para planificar una inmersión utilizando un rebreather de circuito cerrado,
selecciona la opción _CCR_ en la lista desplegable (en un circulo azul en la
imagen a continuación.

*Gases disponibles*: en la tabla de _Gases disponibles_, introduce los datos de
la botella de diluyente y las de bail-out. NO indiques información para la
botella de oxígeno, ya que está implícita al haber seleccionado _CCR_.

*Introducir setpoints*: Especifica un setpoint por defecto en la pestaña de
Preferencias seleccionando _Archivo -> Preferencias -> Gráfico_ desde el menú
principal. Todos los segmentos introducidos por el usuario en los _Puntos del
planificador_ utilizan el valor del setpoint por defecto. Luego se pueden
especificar diferentes setpoints para los diferentes segmentos en la tabla.
Un setpoint cero significa que el buceador ha pasado a circuito abierto para
el segmento en que se ha indicado. La descompresión siempre se calcula usando
el setpoint del último segmento que se haya añadido manualmente. De esta forma,
si se desea planificar un ascenso de emergencia, se añadiría un segmento de un
minuto al final de la inmersión con un setpoint de valor cero. El algoritmo de
descompresión no cambia de mezclas automáticamente mientras se está en modo CCR
pero, desde luego, lo hace para ascensos de emergencia en circuito abierto.

El perfil para una inmersión con CCR puede parecerse a la imagen a continuación

image::images/Planner_CCR1_f20.jpg["FIGURE: Planning a CCR dive: setup",align="center"]

Fíjate que, en los _Detalles del plan de buceo_, no se calcula el consumo de
gas para un segmento en CCR, por tanto, lo normal es obtener valores de 0 l.

[[S_Replan]]
=== Modificar un plan de inmersión existente

Normalmente, cuando se ha guardado un plan de inmersión, se encuentra disponible
desde la *Lista de Inmersiones* como cualquier buceo. Desde la *Lista de
Inmersiones* no hay forma de cambiar un plan. Para efectuar cambios a un plan de
buceo, selecciónalo en la *Lista de Inmersiones*, luego, desde el menú principal
selecciona _Registro -> Re-planificar inmersión_, con ello se abrirá el plan en
el planificador, permitiendo hacer las modificaciones oportunas  y guardarlas de
la forma habitual.

=== Planificar inmersiones sucesivas

Se pueden planear fácilmente inmersiones sucesivas si la fecha y hora de las
mismas se especifican correctamente en el campo arriba a la izquierda _Hora de
inicio_. _SUbsurface_ calcula las cargas de gases inertes de la primera
inmersión y su efecto se evalúa en las posteriores.

Si se acaba de completar una inmersión larga/profunda y se está planificando
otra, se selecciona de la *Lista de inmersiones* la que se acaba de completar y
se activa el planificador. Dependiendo de la hora de inicio del buceo planeado,
el planificador toma en cuenta la carga de gas en la que se ha incurrido durante
la inmersión completada y permite planear con estas limitaciones.

Si solo se usan unas pocas configuraciones (p.e. en GUE), puede crearse una
plantilla de acuerdo con una de las configuraciones. Si ahora se desea planear
una inmersión usando esta configuración, simplemente se selecciona la plantilla
de la *Lista de inmersiones* y se activa el planificador: el planificador tendrá
en cuenta la configuración de la plantilla seleccionada.

=== Imprimir el plan de inmersión

Seleccionar el botón _Imprimir_ permite imprimir los _Detalles del plan de
buceo_ para unas "wet notes". También se pueden copiar y pegar los _Detalles del
plan de buceo_ para incluirlos en un archivo de texto o un procesador de
textos.

Los planes de inmersión tienen muchas características en común con los registros
de buceo (perfil, notas, etc). Después de haber guardado un plan, los detalles y
los cálculos de gas quedan almacenados en la pestaña *Notas*.
Mientras se está diseñando un plan, se puede imprimir utilizando el botón
_Imprimir_ del planificador. Esto imprimirá los detalles y cálculos de gases del
panel _Detalles del plan de inmersión_ del planificador. Sin embargo, tras haber
sido guardado, aparece de una forma muy similar a una anotación en el diario y
no se puede acceder a los cálculos de gas de la misma forma que durante el proceso
de planificación. En esta situación, la única manera de imprimir el plan es usar
_Archivo -> Imprimir_ en el menú principal, igual que haríamos para imprimir un
registro de inmersión.

[[S_MergeDivePlan]]
=== Guardar una inmersión con su planificación

En la sección que abordaba las <<S_MultipleDiveComputers, inmersiones usando más de un ordenador de buceo>>
se discutió la forma en que se pueden visualizar diferentes perfiles de una
misma inmersión utilizando las fechas derecha/izquierda del teclado. Se puede
utilizar un método similar para guardar un plan de buceo con el perfil de la
inmersión real, una vez que se descargado a _Susburface_.
Para ello haremos lo siguiente:

- Haz la planificación y guarda el plan definitivo en la _Lista de Inmersiones_
- Tras bucear, descarga los datos del ordenador a _Subsurface_
- Cambia la fecha y la hora del _plan de buceo_ para hacerlas coincidir con
  los de la inmersión real del ordenador de buceo.
- En la _Lista de inmersiones_ selecciona el plan y inmersión real y mezcla
  las dos utilizando el menú contextual de la _Lista de inmersiones_ que se
  despliega haciendo clic derecho sobre una de las inmersiones seleccionadas.

La versión en texto del plan se añade a las notas.
Con la inmersión resultante en la _Lista de inmersiones_ seleccionada, cambia
entre el perfil planeado y el ejecutado realmente utilizando las fechas
derecha/izquierda del teclado.

== Ejecutar _Subsurface_ desde la línea de comandos
_Subsurface_ puede ejecutarse desde la línea de comandos para que tome algunos
ajustes especiales o como parte de un proceso automatizado basado en scripts
que manipule un divelog. El formato al lanzar _Subsurface_ desde la línea de
comandos es:

	subsurface [opciones] [divelog ...] [--import divelog ...]

Las opciones incluyen:
|======================
|*Opción*|*Descripción*
|--help|Muestra un sumario de opciones de la línea de comandos
| -h|Muestra un sumario de opciones de la línea de comandos
|--import divelog ...|Un nombre antes de esta opción se considera un divelog ya existente, todos los nombres tras la opción se importan al divelog anterior
|--verbose|Muestra información de depuración mientras se ejecuta _Subsurface_
| -v|Muestra información de depuración mientras se ejecuta _Subsurface_
| -v -v|Muestra aún más información de depuración
|--version|Muestra la vesión actual de _Subsurface_
|--survey|Abre la xref:S_UserSurvey[encuesta de usuarios] inmediatamente después de lanzar _Subsurface_
|--user<nombre de usuario>|Selecciona la xref:S_user_space[configuración de trabajo] del usuario <nombre de usuario>
|--cloud-timeout=<duración>|Ajusta el tiempo de espera para la conexión con la nube (0 < duración < 60). Esto permite mayores tiempos de espera si tenemos una conexión a internet lenta
|--win32console|Crea una consola dedicada en caso necesario (solo Windows). Indica esta opción antes que ninguna otra
|======================

== Descripción de las opciones del menú principal de _Subsurface_

Esta sección describe las funciones y manejo de las opciones del menú principal
de _Subsurface_. Varias de las opciones que veremos luego son links a secciones
de este manual que describen las operaciones con más detalle.

=== Archivo

- <<S_NewLogbook,_NuevoRegistro_>> - Cierra el diario abierto en estos momentos
  y limpia toda la información.
- _Abrir Registro_ - Abre el navegador de archivos para seleccionar un archivo
  de registro que abrir.
- _Guardar_ - Guarda el diario abierto en estos momentos.
- _Guardar como_ - Guarda el diario actual con un nombre de archivo diferente.
- _Abrir almacenamiento en la nube_ - Abre el diario previamente configurado en
  <<S_Cloud_storage,_Almacenamiento en la nube_>>.
- _Guardar en almacenamiento en la nube_ - Guarda el diario actual en el
  <<S_Cloud_storage,_Almacenamiento en la nube_>>.
- _Cerrar_ - Cierra el registro de inmersiones abierto en estos momentos.
- <<S_ExportLog,_Exportar_>> - Exporta el diario abierto actualmente (o las
  inmersiones seleccionadas en el diario) a algún otro formato.
- <<S_PrintDivelog,_Imprimir_>> - Imprime el registro de inmersiones abierto.
- <<S_Preferences, _Preferencias_>> - Fija las preferencias del usuario de
  _Subsurface_.
- <<S_FindMovedImages, _Encontrar imágenes movidas_>> - Si las fotos que se
  hicieron durante las inmersiones se han cambiado de carpeta o de disco, las
  localiza y las une alas inmersiones correspondientes.
- <<S_Configure, _Configurar ordenador de buceo_>> - Edita la configuración de
  un ordenador de buceo.
- _Salir_ - Sale de _Subsurface_.

=== Editar
- La opción editar permite deshacer y rehacer una acción, por ejemplo borrar
una inmersión.

=== Importar
- <<S_ImportDiveComputer,_Importar del ordenador de buceo_>> - Descarga
  información desde un ordenador de buceo.
- <<Unified_import,_Importar Archivos de registro_>> - Importa información de
  buceo desde un fichero que esté en un formato compatible con _Subsurface_.
- <<S_Companion,_Importar datos GPS del Servicio web de Subsurface_>> - Carga
  coordenadas GPS desde la app para teléfonos móviles.
- <<S_ImportingDivelogsDe,_Importar desde Divelogs.de_>> - Importa información
  de buceo desde www.divelogs.de.

=== Registro
- <<S_EnterData,_Añadir inmersión_>> - Añade manualmente una nueva inmersión al
  panel Lista de inmersiones.
- _Editar inmersión_ - Edita una inmersión cuyo perfil se hizo manualmente y no
  descargándola desde un ordenador de buceo.
- <<S_DivePlanner,_Planificar inmersión_>> - Esta característica permite
  planificar inmersiones.
- <<S_Replan,_Editar inmersión en planificador_>> - Edita un plan de buceo que se ha
  guardado en la *Lista de Inmersiones*.
- <<S_CopyComponents,_Copiar componentes_>> - Al seleccionar esta opción se
  se puede copiar información de varios campos de una inmersión al portapapeles.
- _Pegar componentes_ - Pega, en las inmersiones previamente seleccionadas de
  la *Lista de Inmersiones*, la información copiada previamente usando la opción
  _Copiar componentes_.
- <<S_Renumber,_Renumerar_>> - Renumera las inmersiones listadas en el panel
  Lista de inmersiones.
- <<S_Group,_Auto agrupar_>> - Agrupa automáticamente los buceos de la Lista de
  inmersiones en viajes de buceo.
- <<S_DeviceNames,_Editar nombres de dispositivos_>> - Edita los nombres
  asignados a los ordenadores de buceo.
- <<S_Filter, _Filtrar la lista de inmersiones_>> - Seleccionar únicamente
  algunas inmersiones, basándose en criterios específicos.

=== Vista
- <<S_ViewPanels,_Todo_>> - Se presentan los cuatro paneles principales de
  _Subsurface_ simultáneamente.
- <<S_ViewPanels,_Lista_de_inmersiones_>> - Se visualiza solo el panel Lista de
  inmersiones.
- <<S_ViewPanels,_Perfil_>> - Se visualiza solo el panel Perfil de inmersión.
- <<S_ViewPanels,_Info_>> - Se visualiza solo el panel Notas.
- <<S_ViewPanels,_Globo_>> - Se presenta solo el panel Mapamundi.
- _Estadísticas anuales_ - Muestra estadísticas anuales resumidas sobre las
  inmersiones efectuadas en este año y los pasados.
- _Anterior ordenador_ - Si una inmersión se ha registrado con más de un ordenador
  de buceo, cambia a los datos del anterior ordenador de buceo.
- _Siguiente ordenador_ - Cambia al siguiente ordenador de buceo.
- _Pantalla completa_ - Activa el modo de pantalla completa.

=== Ayuda
- _Acerca de Subsurface_ - Muestra un panel con el número de versión de
  _Subsurface_ e información de la licencia.
- _Comprobar si hay actualizaciones_ - Encuentra si hay disponible una nueva
  versión de _Subsurface_ en la  http://subsurface-divelog.org/[página web de _Subsurface_].
- <<S_UserSurvey,_Encuesta de usuarios_>> - Ayuda a hacer mejor _Subsurface_
  tomando parte en nuestra encuesta a usuarios, o completando otra si tus hábitos
  de buceo han cambiado.
- _Manual de usuario_ - Abre una ventana que muestra este manual.

== APÉNDICE A: Información específica del sistema operativo para importar inmersiones desde un ordenador de buceo.

=== Asegúrate de que el SO tiene instalados los drivers necesarios
[icon="images/icons/drivers.jpg"]
[NOTE]
El sistema operativo del ordenador de sobremesa necesita los drivers correctos
para comunicarse con el ordenador de buceo de la forma en que este lo prefiera
(p.e. bluetooth, USB, infrarrojos).

* En Linux esto significa que el usuario tiene que tener cargados los módulos
del kernel correctos. La mayoría de las distribuciones lo harán automáticamente.
Sin embargo algunos protocolos de comunicación requieren un driver adicional,
especialmente para tecnología poco usada como los infrarojos.

* En Windows, el SO debería ofrecer descargar el driver correcto cuando el
usuario conecte su ordenador de buceo al puerto USB y el sistema operativo vea
el dispositivo por primera vez.

* En un Mac, en ocasiones, el usuario tiene que buscar manualmente el driver
correcto. Por ejemplo, el driver correcto para los dispositivos Mares Puck puede
encontrarse como Mac_OSX_VCP_driver.zip en el
http://www.silabs.com/support/pages/document-library.aspx?p=Interface&f=USB%20Bridges&pn=CP2101[repositorio
de documentos y software de Silicon Labs].

[[S_HowFindDeviceName]]
=== Como encontrar el nombre de dispositivo para conexiones USB y ajustar sus permisos de escritura
[icon="images/icons/usb.jpg"]
[NOTE]
Cuando un usuario conecta el ordenador de buceo utilizando un conector USB,
normalmente _Subsurface_ propondrá una lista desplegable que contendrá el nombre
de dispositivo correcto (o punto de montaje para el Uemis Zurich), o
deshabilitará el desplegable de selección si no se necesita ningún nombre. En
los raros casos en que esto no funcione, aquí hay algunas instrucciones sobre
formas de averiguar cual es el nombre de dispositivo.

.En Windows:

Simplemente intenta COM1, COM2, etc. La lista desplegable debería contener todos
los dispositivos COM conectados.

.En MacOS:

El desplegable debería encontrar todos los ordenadores de buceo conectados.

.En Linux:

Hay una forma definitiva de encontrar el puerto:

 - Desconectar el cable USB del ordenador de buceo
 - Abrir un terminal
 - Teclear el comando: dmesg y pulsar enter
 - Conectar el cable USB del ordenador de buceo
 - Teclear el comando: dmesg y pulsar enter

En el terminal debería poderse ver un mensaje similar a este:

	usb 2-1.1: new full speed USB device number 14 using ehci_hcd
	usbcore: registered new interface driver usbserial
	USB Serial support registered for generic
	usbcore: registered new interface driver usbserial_generic
	usbserial: USB Serial Driver core
	USB Serial support registered for FTDI USB Serial Device
	ftdi_sio 2-1.1:1.0: FTDI USB Serial Device converter detected
	usb 2-1.1: Detected FT232BM
	usb 2-1.1: Number of endpoints 2
	usb 2-1.1: Endpoint 1 MaxPacketSize 64
	usb 2-1.1: Endpoint 2 MaxPacketSize 64
	usb 2-1.1: Setting MaxPacketSize 64
	usb 2-1.1: FTDI USB Serial Device converter now attached to ttyUSB3
	usbcore: registered new interface driver ftdi_sio
	ftdi_sio: v1.6.0:USB FTDI Serial Converters Driver

En la tercera línea desde abajo muestra que se detecta el adaptador USB FTDI y
está conctado a +ttyUSB3+ . Ahora puede usarse esta información en el ajuste de
la importación como +/dev/ttyUSB3+ lo que dirigirá a _Subsurface_ al puerto USB
correcto.

Asegurarse de que el usuario tiene permisos de escritura en el puerto serie USB:


En sistemas operativos tipo Unix los puertos USB solo pueden accederse por
usuarios que sean miembros del grupo dialout. Si uno no es root, puede que no
sea miembro de dicho grupo y no podrá utilizar el puerto USB. Asumamos que el
nombre de usuario de uno es johnB.

- Como root se teclea: +usermod -a -G dialout johnB+ (usuarios de Ubuntu: +sudo
usermod -a -G dialout johnB+) . Esto hace a johnB miembro del grupo +dialout+.
- Teclea: +id johnB+ Esto listará todos los grupos a los que pertenece johnB y
verifica que se ha creado la pertenencia correcta al grupo. El grupo +dialout+
debería aparecer entre los diferentes IDs.
- En algunas circunstancias, este cambio solo tiene efecto (p.e. en Ubuntu) tras
cerrar sesión y reiniciarla.

Con el nombre de dispositivo apropiado (p.e. +/dev/ttyUSB3+) y con permisos de
escritura para el puerto USB, el interface del ordenador de buceo puede
conectarse y se debería poder importar las inmersiones.


[[S_HowFindBluetoothDeviceName]]
=== Ajustar manualmente dispositivos con bluetooth
[icon="images/icons/bluetooth.jpg"]
[NOTE]
Para ordenadores de buceo que se comunican por bluetooth como el Heinrichs
Weikamp Frog o el Shearwater Predator, Petrel y Nerd hay un procedimiento distinto
para localizar los nombres de dispositivo con los que se comunicará
_Subsurface_. En general consiste en estos pasos:

* *En el ordenador de buceo, tras habilitar Bluetooth, asegurarse que está en
modo Upload*

Para emparejar el ordenador de buceo, consulta la guía de usuario del
fabricante. Si se está usando un Shearwater Predator/Petrel/Nerd, hay que seleccionar
_Dive Log → Upload Log_ y esperar al mensaje _Wait PC_.

 * *Emparejar el PC con _Subsurface_ con el ordenador de buceo.*

==== En Windows:

Probablemente bluetooth ya esté activado. Para emparejar el dispositivo se
selecciona _Panel de Control → Dispositivos Bluetooth → Añadir dispositivo
Inalámbrico_. Esto debería desplegar un diálogo que mostraría tu ordenador de
buceo (en modo bluetooth) y te permitiría emparejarlo. El ordenador de buceo
debería mostrarse en la lista de dispositivos y podrías hacer clic-derecho en él
y seleccionar _Propiedades → Puertos COM_ para identificar el puerto usado por
tu ordenador de buceo. Si se mostraran varios puertos, utiliza el que diga
"Saliente" en vez de "Entrante".

Para descargar a _Subsurface_, la lista desplegable ya debería contener este
puerto COM. Si no, introdúcelo manualmente.

Nota: Si tienes problemas descargando desde tu ordenador de buceo a otro
software después, intenta borrar el emparejamiento y volverlo a hacer.

==== En MacOS:

Clica en el símbolo Bluetooth en la barra de menú y selecciona _Configurar
Dispositivo Bluetooth …_. Asegúrate de que tu ordenador de buceo está en modo
upload; entonces debería mostrar la lista de dispositivos. Selecciónalo y pasa
por el proceso de emparejamiento. Este paso solo debería se necesario una vez
para la configuración inicial.

Una vez que el emparejamiento está completo el dispositivo correcto se mostrará
en el desplegable 'Dispositivo o punto de montaje' del diálogo *Importar* de
_Subsurface_.

==== En Linux
Asegúrate de que tienes activado el ordenador con _Subsurface_. En las
distribuciones más habituales esto debería ser cierto de entrada y el
emparejamiento debería se fácil. Por ejemplo, Gnome3 muestra un icono Bluetooth
a la derecha de la barra de tareas, arriba en la pantalla.
Los usuarios han informado de dificultades con algunos controladores de
Bluetooth. Si tienes un controlador incluido en el PC, prueba primero con
este. Es más fácil si quitas cualquier receptor USB que tengas activado.
Si tienes un receptor USB que viniera con el ordenador de buceo, prueba con
este antes que con cualquier otro.

Configurar una conexión para descargar inmersiones desde tu ordenador de buceo
con capacidad Bluetooth, tal como el _Shearwater Petrel_, todavía no es un
proceso automatizado y requerirá generalmente la línea de comandos.
Se trata esencialmente de un proceso en tres pasos.

 - Activar el controlador Bluetooth y emparejarlo con el ordenador de buceo
 - Establecer una conexión RFCOMM
 - Descargar las inmersiones con _Subsurface_

Asegurarse de que el ordenador de buceo está en modo "upload". En el _Petrel_
y _Petrel 2_ y _Nerd_, navega por el menú, selecciona 'Dive Log', luego 'Upload log'. En
la pantalla se leerá 'Initializing', luego 'Wait PC 3:00' e iniciará una cuenta
atrás. Una vez que la conexión esté establecida, en la pantalla se leerá
'Wait CMD ...' y la cuenta atrás seguirá. Cuando se descargue la inmersión a
_Subsurface_ en la pantalla se leerá 'Sending' y luego 'Sent dive'.

Para establecer la conexión, accede como root vía +sudo+ o +su+.
Se necesitan los permisos  correctos para descargar las inmersiones al PC. En la
mayoría de los sistemas Linux, esto significa hacerse miembro del grupo dialout
(de forma idéntica como con los ordenadores de buceo que utilizan un puerto USB,
como se describía en la sección anterior). En la línea de comando introduce:

+sudo usermod -a -G dialout username+

Luego desconecta el usuario y vuélvelo a conectar para que tenga efecto la
modificación.

===== Activar el controlador Bluetooth y emparejar el ordenador de buceo

Intenta configurar el controlador Bluetooth y emparejar tu ordenador de buceo
utilizando el entorno gráfico del sistema operativo. Tras configurar el
ordenador de buceo en modo "upload", haz clic en el icono Bluetooth en la
barra del sistema y selecciona 'Añadir nuevo dispositivo'. El ordenador de
buceo debería aparecer. Si se pide una contraseña, introduce 0000. Anótate o
copia la dirección MAC de tu ordenador de buceo, que necesitaremos más
adelante, y debería ser de la forma  00:11:22:33:44:55.

Si el método gráfico no funcionó, empareja el dispositivo desde la línea de
comandos. Abre un terminal y usa +hciconfig+ para comprobar el estado del
controlador Bluetooth

      $ hciconfig
      hci0:   Type: BR/EDR  Bus: USB
              BD Address: 01:23:45:67:89:AB  ACL MTU: 310:10  SCO MTU: 64:8
              *DOWN*
              RX bytes:504 acl:0 sco:0 events:22 errors:0
              TX bytes:92 acl:0 sco:0 commands:21 errors:0

Esto indica un controlador Bluetooth con dirección MAC 01:23:45:67:89:AB,
conectado como hci0. Su estado es DOWN, por ejemplo no activado. Otros
controladores adicionales aparecerían como hci1, etc. Si no había un receptor
Bluetooth conectado al PC en el momento del arranque, hci0 es, probablemente,
el receptor interno.
Ahora conectemos el controlador y activemos la autenticación:

       sudo hciconfig hci0 up auth  (enter password when prompted)
       hciconfig
       hci0:  Type: BR/EDR  Bus: USB
               BD Address: 01:23:45:67:89:AB  ACL MTU: 310:10  SCO MTU: 64:8
               *UP RUNNING PSCAN AUTH*
               RX bytes:1026 acl:0 sco:0 events:47 errors:0
               TX bytes:449 acl:0 sco:0 commands:46 errors:0

Comprueba que el estado ahora incluye +'UP', 'RUNNING' y 'AUTH'+.

If se están ejecutando múltiples controladores, lo más simple es desconectar
los no utilizados, por ejemplo, para +hci1+:

       sudo hciconfig hci1 down

El próximo paso es 'trust' y 'pair' el ordenador de buceo. En distribuciones
con Bluez 5, como Fedora 22, se puede utilizar una herramienta llamada
+blutoothctl+, que lanzará su propia linea de comandos.

       bluetoothctl
       [NEW] Controller 01:23:45:67:89:AB localhost.localdomain [default]
       [bluetooth]# agent on
       Agent registered
       [bluetooth]# default-agent
       Default agent request successful
       [bluetooth]# scan on                        <----now set your dive computer to upload mode
       Discovery started
       [CHG] Controller 01:23:45:67:89:AB Discovering: yes
       [NEW] Device 00:11:22:33:44:55 Petrel
       [bluetooth]# trust 00:11:22:33:44:55        <----you can use the tab key to autocomplete the MAC address
       [CHG] Device 00:11:22:33:44:55 Trusted: yes
       Changing 00:11:22:33:44:55 trust succeeded
       [bluetooth]# pair 00:11:22:33:44:55
       Attempting to pair with 00:11:22:33:44:55
       [CHG] Device 00:11:22:33:44:55 Connected: yes
       [CHG] Device 00:11:22:33:44:55 UUIDs: 00001101-0000-1000-8000-0089abc12345
       [CHG] Device 00:11:22:33:44:55 Paired: yes
       Pairing successful
       [CHG] Device 00:11:22:33:44:55 Connected: no

Si se solicita una contraseña, introduce 0000. Está bien aunque la última
línea diga 'Connected: no'. La parte importante es la anterior +Pairing
successful+.

Si el sistema tiene Bluez 4 (p.e. Ubuntu 12.04 a 15.04), probablemente no haya
+bluetoothctl+, sino un script llamado +bluez-simple-agent+.

       hcitool -i hci0 scanning
       Scanning ...
               00:11:22:33:44:55       Petrel
               bluez-simple-agent hci0 00:11:22:33:44:55

Una vez que el ordenador esté emparejado, configura la conexión RFCOMM.

===== Establecer la conexión RFCOMM

El comando para establecer una conexión RFCOMM es:

+sudo rfcomm -i <controller> connect <dev> <bdaddr> [channel]+

- +<controller>+ es el controlador Bluetooth, +hci0+.
- +<dev>+ es el dispositivo RFCOMM, +rfcomm0+
- +<bdaddr>+ es la dirección MAC del ordenador de buceo, +00:11:22:33:44:55
- +[channel]+ es el canal Bluetooth al que nos queremos conectar.

Si se omite el canal, se asume el 1. Basándonos en un número limitado de
informaciones de usuarios el canal apropiado para el ordenador de buceo,
probablemente sea:

- _Shearwater Petrel 1_: channel 1
- _Shearwater Petrel 2_: channel 5
- _Shearwater Nerd_: channel 5
- _Heinrichs-Weikamp OSTC Sport_: channel 1

P.e. para conectar un _Shearwater Petrel 2_, ajusta el ordenador de buceo a
modo "upload" e introduce:

       sudo rfcomm -i hci0 connect rfcomm0 00:11:22:33:44:55 5

(introduce una contraseña, probablemente 0000, cuando se solicite)
Se obtendrá la respuesta:

       Connected /dev/rfcomm0 to 00:11:22:33:44:55 on channel 5
       Press CTRL-C for hangup

Para conectar un +Shearwater Petrel 1+ o +H&W OSTC Sport+, ajusta el ordenador
de buceo a modo "upload" e introduce:

       sudo rfcomm -i hci0 connect rfcomm0 00:11:22:33:44:55   (intruduce el password, probablemente 0000, cuando se solicite)
       Connected /dev/rfcomm0 to 00:11:22:33:44:55 on channel 1
       Press CTRL-C for hangup

Si se desconoce el canal específico de un ordenador de buceo, o el canal de la
lista anterior no funciona, el comando +sdptool records+ debería ayudar a dar
con el canal apropiado, la salida a continuación es para un Petrel 2:

       sdptool -i hci0 records 00:11:22:33:44:55
       Service Name: Serial Port
       Service RecHandle: 0x10000
       Service Class ID List:
               "Serial Port" (0x1101)
               Protocol Descriptor List:
               "L2CAP" (0x0100)
               "RFCOMM" (0x0003)
               Channel: 5

En el caso de ordenadores de buceo Bluetooth que no estén incluidos en la lista
anterior, por favor, informa a los desarrolladores de Subsurface a través del
foro de usuarios o de la lista de correo _subsurface@subsurface-divelog.org_.

===== Descargar las inmersiones con Subsurface
Tras establecer la conexión RFCOMM y mientras esta corriendo la cuenta atrás
del ordenador de buceo, ves a _Subsurface_, selecciona desde el menú principal
_Importar -> Importar del ordenador de buceo_ y selecciona el fabricante
adecuado (p.e. _Shearwater_), el ordenador de buceo (p.e. _Petrel_), el punto
de montaje o dispositivo (p.e. _/dev/rfcomm0_) y pulsa _Descargar_.

[[_appendix_b_dive_computer_specific_information_for_importing_dive_information]]

== APÉNDICE B: Información específica por ordenadores de buceo.

[[S_ImportUemis]]
=== Importar desde un Uemis Zurich

[icon="images/icons/iumis.jpg"]
[NOTE]
_Subsurface_ descarga la información guardada en el SDA (el sistema de archivos
interno del Uemis) incluyendo información sobre puntos de buceo y equipo. La
información sobre el compañero aún no se puede descargar. Se hace de forma muy
similar a un ordenador de buceo con conexión USB (el Uemis es uno de los que se
recargan cuando están conectados al puerto USB). La principal diferencia es que
no se introduce un nombre de dispositivo, sino la ubicación donde se montará el
sistema de ficheros UEMISSDA una vez conectado tu ordenador de buceo. En Windows
este es una letra de disco (a menudo 'E:' o 'F:'), en un Mac este es
'/Volumes/UEMISSDA' y en sistemas Linux varía dependiendo de la distribución
utilizada. En Fedora habitualmente es
'/var/run/media/<nombre_usuario>/UEMISSDA'. En todos los casos _Subsurface_
debería sugerir la ubicación correcta en la lista desplegable.

Tras seleccionar el nombre anterior como nombre de dispositivo, se pueden
descargar las inmersiones del Uemis Zurich. Un problema técnico con la
implementación de descargas en el Uemis Zurich (es una limitación del firmware,
no un problema de _Subsurface_) es que no se pueden descargar más de 40/50
buceos sin quedarse sin memoria en el SDA. Esto, usualmente, solo pasará la
primera vez que se descarguen inmersiones del Uemis Zurich (normalmente, al
descargar al final de un día o incluso de un viaje la capacidad será
suficiente). Si _Subsurface_ muestra el error de que el ordenador de buceo se ha
quedado sin espacio la solución es directa. Desconectar el SDA, apágarlo y
volverlo a encender, y reconectarlo. Ahora se puede reintentar (o iniciar una
nueva sesión de descarga) y continuará donde paró la última vez. Puede que se
tenga que repetir esta operación más de una vez dependiendo de cuantos buceos
haya guardados en el ordenador.

[[S_ImportingGalileo]]
=== Importar buceos desde el Galileo de Uwatec

[icon="images/icons/Galileo.jpg"]
[NOTE]
Los ordenadores de buceo Galileo de Uwatec usan comunicaciones por infrarrojos
(IrDA) entre el dispositivo y _Subsurface_. El hardware de Uwatec utiliza un USB
basado en le protocolo serie/infrarrojo (SIR) y el controlador IrDA MSC7780
fabricado por MosChip y comercializado por Scubapro y algunas compañías de
electrónica. En Linux, el kernel ya proporciona comunicación usando el protocolo
IrDA. Sin embargo, el usuario necesita cargar adicionalmente un driver para el
interface IrDA con el ordenador de buceo. La forma más fácil es cargar el
paquete *irda-tools* del http://irda.sourceforge.net/docs/startirda.html[Linux
IrDA Project]. Tras la instalación de irda-tools, el *usuario root* puede
especificar un nombre de dispositivo desde la consola así:

+irattach irda0+

Después de ejecutar este comando, _Subsurface_ reconocerá el ordenador Galileo y
descargará la información de buceo.

En Windows existe una situación similar. Hay drivers para el MCS7780 disponibles
en algunos sitios de internet p.e.
http://www.drivers-download.com/Drv/MosChip/MCS7780/[www.drivers-download.com].
También se pueden encontrar drivers IrDA basados en Windows, para los
ordenadores Uwatec en el sitio web de ScubaPro, pudiendo encontrarlos en la
página de descargas del software SmarTrak.

Para el Mac de Apple, la comunicación IrDA vía MCS7780 no está disponible para
OSX 10.6 o superior.

[[S_ImportingDR5]]
=== Importar buceos desde Heinrichs Weikamp DR5

[icon="images/icons/HW_DR5.jpg"]
[NOTE]
El H&amp;W DR5 se monta como un disco USB y guarda un fichero UDDF para cada
buceo. Marca todas las inmersiones que quieras abrir o importar. Nota: El DR5 no
parece conservar factores de gradiente ni información de deco, por lo que
_Subsurface_ no puede mostrarla. Ajusta los factores de gradiente en
_Subsurface_ en *Preferencias* para generar una capa de deco en el panel del
*Perfil*. Observa que la deco calculada por _Subsurface_ diferirá, con toda
seguridad, de la calculada por el DR5.

[[S_ImportingXDeep]]
=== Importar desde xDEEP BLACK

[icon="images/icons/HW_xdeepblack.jpg"]
[NOTE]
Cada inmersión se ha de guardar individualmente como archivo UDDF utilizando la
opción "Exportar a UDDF" en el menú del logbook del BLACK. Al montar el BLACK
como disco USB, los archivos UDDF están disponibles en el directorio LOGBOOK.
Nota: El xDEEP BLACK guarda el LND pero no parece guardar factores de gradiente
ni información sobre deco, por lo que _Subsurface_ no puede mostralos. Ajusta
los factores de gradiente en _Gráfico_ en las _Preferencias_ para generar una
capa de deco en el *Perfil deinmersión* de _Subsurface_ pero fíjate que la
deco calculada por _Subsurface_ diferirá con toda probabilidad de la que
mostraría el xDEEP BLACK.

=== Importar del Shearwater Predator/Petrel/Nerd usando Bluetooth

[icon="images/icons/predator.jpg"]
[NOTE]
En la sección anterior, <<S_Bluetooth,_Conectar Subsurface a ordenadores de buceo con Bluetooth_>>
se facilitan instrucciones específicas para descargar inmersiones usando Bluetooth.

[[S_PoseidonMkVI]]
=== Importar desde el Poseidon MKVI Discovery

[icon="images/MkVI.jpeg"]
[NOTE]
La descarga de diarios desde el MKVI se realiza utilizando un adaptador de
comunicaciones personalizado y el _Poseidon PC Configuration Software_, que
se obtiene al adquirir el equipo MKVI. La última es una aplicación de
windows que permite configurar el equipo y guardar los diarios. La comunicación
entre el ordenador de buceo y el PC utiliza el protocolo IrDA de infrarrojos.
Solo se pueden descargar datos de una inmersión cada vez e incluyen tres
archivos:

- Configuración de ajustes para la inmersión y parámetros clave de la misma (es
  el archivo con extensión .txt).
- Detalles del diario (archivo con extensión .csv).
- Diario en formato Redbook (archivo con extensión .cvsr). Es una versión
comprimida del diario utilizando un formato propio.

_Subsurface_ accede a los archivos .txt y .csv para obtener información.

=== Importar desde el CCR APD Inspiration

[icon="images/APDComputer.jpg"]
[NOTE]
Los diarios del ordenador de buceo de un APD Inspiration o similar, se
descargan utilizando un adaptador y el _AP Communicator_, obtenidos al comprar
el equipo. Los diarios se pueden visualizar utilizando el _AP Log Viewer_ desde
Windows o Mac/OS. Sin embargo, los diarios de APD se pueden ver o manejar desde
_Subsurface_ (junto a buceos en los que se haya utilizado otros muchos tipos de
ordenador de buceo). Los diarios de APD Inspiration se importan a _Subsurface_
como sigue:

- Descargar la inmersión usando _AP Communicator_.
- Abrir una inmersión con el _AP Log Viewer_.
- Seleccionar la pestaña llamada _Datos_ (_Data_).
- Con los datos del diario "en crudo" mostrados en pantalla, pulsar en
  _Copiar al portapapeles_.
- Abrir un editor de texto (p.e. Notepad en windows o TextWrangler en Mac).
- Copiar el contenido del portapapeles al editor y guardar el archivo de texto
  con extensión de archivo _.apd_
- Desde Subsurface, seleccionar _Importar -> Importar archivos de registro_
  para abrir el xref:Unified_import[diálogo de importación universal].
- En la lista desplegable de abajo del diálogo (llamada 'Filtro:') seleccionar "APD log viewer".
- En la lista de nombres de archivo, seleccionar el archivo _.apd_ que acabamos
  de crear y se abrirá un diálogo de importación que mostrará los ajustes por
  defecto para los datos en un archivo _.apd_. Si es necesario algún cambio
  hazlo como en xref:S_ImportingCSVDives[CSV imports].

image::images/APD_CSVimportF22.jpg["Figure: APD log viewer import",align="center"]

- El primer desplegable a la izquierda en el panel de importación nos permite
el ordenador de buceo APD del que importar el registro. Por defecto es DC1, el
primero de los dos ordenadores que usa el APD. Es posible importar secuencialmente
los datos de ambos ordenadores, importando primero el DC1 y luego el DC2.
(*Truco*: Los registros de ambos ordenadores se pueden visualizar seleccionando
 _Vista -> Siguiente Ordenador_ desde el menú principal, o situando el cursor
 sobre el perfil y pulsando la flecha derecha/izquierda). Pulsa el botón OK en
la parte de debajo del panel.

El diario de APD aparecerá en _Subsurface_. El techo generado por el ordenador
Inspiration puede visualizarse seleccionando el correspondiente botón de la
izquierda del *Perfil de inmersión*. Los datos de presión de las botellas no
se registran en el equipo APD pero pueden completarse a mano desde la pestaña
*Equipo*.

== APÉNDICE C: Exportar información de diarios desde otros softwares externos.

La importación de datos de diarios de buceos desde softwares externos se
efectúa, habitualmente, utilizando el dialogo que resulta de seleccionar
_Importar_ desde el menú principal y luego Importar archivos de registro. Este
proceso se efectúa en un solo paso y puede obtenerse más información
xref:Unified_import[aquí] . Sin embargo, en algunos casos, puede ser necesario
efectuar dos pasos:

1. Exportar los datos del diario externo a un formato accesible por
   _Subsurface_.
2. Importar el diario accesible a _Subsurface_.

Este apéndice proporciona algo de información sobre como exportar datos de
diarios desde softwares externos. Los procedimientos a continuación se aplican
mayormente en Linux y/o Windows.

[[S_ImportingDivesSuunto]]
=== Exportar desde *Suunto Divemanager (DM3, DM4 o DM5)*
[icon="images/icons/suuntologo.jpg"]
[NOTE]
Divemanager es una aplicación en MS Windows para ordenadores de buceo Suunto.
Divemanager 3 (DM3) es una versión más antigua del software de Suunto. Los
ordenadores de buceo más recientes usan Divemanager 4 o 5 (DM4 o DM5). Las
diferentes versiones de Divemanager usan diferentes métodos y diferentes
nomenclaturas de archivos al exportar datos.

*Divemanager 3 (DM3):*

1. Iniciar 'Suunto Divemanager 3' y registrarse con el nombre que contiene los
   diarios.
2. No iniciar el ayudante de importación para importar inmersiones desde el
   ordenador de buceo.
3. En el árbol de la izquierda de la ventana del programa, seleccionar las
   inmersiones que correspondan.
4. De la lista de buceos, seleccionar las inmersiones que se deseará descargar
   después:
	* Para seleccionar alguna: mantén pulsada la tecla 'ctrl' y haz clic en la
	  inmersión.
	* Para seleccionarlas todas: Selecciona la primera, mantén pulsada la tecla
	  'shift' y haz clic en la última inmersión.
5. Con las inmersiones marcadas se usa el menú _File → Export_
6. Se mostrará el desplegable de exportación. En este desplegable hay un campo
   llamado Export Path.
	* Haz clic en el botón browse junto al campo Export Path
		** Se despliega un navegador de archivos
	* Navega a la carpeta donde quieras que se guarde el archivo Divelog.SDE
                ** Opcionalmente cambia el nombre del archivo a guardar.
                ** Clica 'Save'.
        * De vuelta en el desplegable de exportación, pulsa el botón 'Export'.
7. Las inmersiones han quedado exportadas en el archivo Divelogs.SDE.

*Divemanager 4 (DM4) y Divemanager 5 (DM5):*

DM4 y DM5 utilizan idénticos mecanismos para exportar los diarios.
Para exportar un diario desde Divemanager, se necesita localizar la base de
datos DM4/DM5 donde están guardadas las inmersiones. El usuario puede buscar la
base de datos original o hacer una copia de respaldo. A continuación se
describen ambos métodos.

Localizar la base de datos Suunto DM4 (o DM5):

1. Iniciar Suunto DM4/DM5
2. Seleccionar 'Help → About' (Ayuda → Acerca de)
3. Hacer clic en el botón 'Copy' (Copiar) tras el texto 'Copy log folder path to
   clipboard' (Copiar la ruta a la carpeta del registro al portapapeles)
4. Abrir el explorador de Windows
5. Pegar la ruta en la casilla de direcciones en la parte de arriba del
   explorador
6. La base de datos se llama DM4.db o DM5.db

Hacer una copia de respaldo de la base de datos de Suunto DM4/DM5:

1. Iniciar Suunto DM4/DN5
2. Seleccionar 'File → Create backup' (Archivo → Copia de seguridad)
3. Desde el menú de archivos, seleccionar la carpeta y el nombre para la copia,
aquí usaremos DM4 (o DM5) con la extensión por defecto .bak
4. Clicar 'Save' (Guardar)
5. Los buceos se han exportado al archivo DM4.bak (o DM5.bak)

[[Atomic_Export]]
=== Exportar desde Atomic Logbook

[NOTE]
Atomic Logbook es un software en Windows de Atomics Aquatics. Permite descargar
información de buceo de los ordenadores Cobalt y Cobalt 2. El archivo se guarda
en una base de datos SQlite en C:\ProgramData\AtomicsAquatics\Cobalt-Logbook\Cobalt.db.
Este archivo se puede importar directamente a _Subsurface_.

[[Mares_Export]]
=== Exportar desde Mares Dive Organiser V2.1

[icon="images/icons/mareslogo.jpg"]
[NOTE]
Mares Dive Organiser es una aplicación de Windows. El diario de inmersiones se
guarda en una base de datos Microsoft SQL Compact Edition con una extensión de
nombre de archivo '.sdf'. La base de datos incluye a todos los buceadores
registrados en el Dive Organiser del PC y a todos los ordenadores Mares usados.
La forma más segura de obtener una copia de la base de datos de inmersiones es
exportar la información a otro formato compatible que pueda ser importado a
_Subsurface_.

1. En el Dive Organiser, selecciona _Database → Backup_ en el menú principal y
   haz una copia de seguridad de la base de datos en el escritorio. Esto creará un
   archivo comprimido DiveOrganiserxxxxx.dbf
2. Cambia el nombre del archivo a DiveOrganiserxxxxx.zip. Dentro de una carpeta
   comprimida en el archivo .zip, hay otro archivo llamado _DiveOrganiser.sdf_.
3. Extrae a tu escritorio el archivo _.sdf_ desde la carpeta comprimida.
4. La password para acceder al archivo .zip es _mares_.

[[S_ImportingDivingLog]]
=== Exportar desde *DivingLog 5.0 y 6.0*

[icon="images/icons/divingloglogo.jpg"]
[NOTE]
La mejor manera de traer tus diarios desde DivingLog a _Subsurface_ es
convertir la base de datos completa. Esto se debe a que otros formatos de
exportación no incluyen todos los detalles, y careceríamos, por ejemplo, de
cambios de gas e información acerca de que unidades se utilizan. Al importar
la base de datos, toda esta información esta incluida y disponible.

Para transferir todos los archivos desde DivingLog a _Subsurface_ haz lo
siguiente:

1. En DivingLog abre el menú 'Archivo ->  Exportar ->  SQLite'
2. Selecciona el botón 'Ajustes'
3. Ajusta el 'RTF2Plaintext' a 'true'
4. Cierra el diálogo 'Ajustes'
5. Pulsa el botón 'Exportar' y selecciona el nombre de archivo

Una vez hecho esto, abre con _Subsurface_la base de datos guardada y las
inmersiones se convertirán automáticamente a nuestro formato. El último paso
a efectuar es guardar el diario en _Subsurface_.

[[S_Appendix_D]]
== APÉNDICE D: Exportar una hoja de cálculo a formato CSV

Muchos buceadores mantienen un diario en alguna forma de archivo digital, en
muchos casos en una hoja de cálculo con varios campos de información. Estos
registros se pueden importar con facilidad a _Subsurface_
una vez que la hoja de cálculo se ha convertido a archivo .CSV .
Esta sección explica el procedimiento para convertir un diario de buceo que
se haya conservado en una hoja de cálculo en un archivo .CSV que se pueda,
posteriormente, importar a _Subsurface_.
Crear un .CSV es una tarea sencilla, aunque el procedimiento es algo distinto
según el programa de hojas de cálculo que se utilice.

El primer paso consiste en organizar los datos en la hoja de cálculo, de forma
que la primera fila contenga los nombres (o títulos) de cada columna y que la
información de cada inmersión ocupe una sola fila.
_Subsurface_ soporta muchos tipos de datos (Número, Fecha, Hora, Duración,
Ubicación, GPS, Prof. máxima, Prof. media, Compañero, Notas, Lastre y Etiquetas).
El usuario puede organizar los datos siguiendo unas sencillas reglas:

1. Fecha: Usar uno de los siguientes formatos: aaaa-mm-dd, dd.mm.aaaa o
   mm/dd/aaaa
2. Duración:  El formato debería ser minutos:segundos
3. Sistema de unidades: Solo debe usarse un sistema. Evitar la mezcla sistemas.
4. Etiquetas y compañeros: los valores deben separarse usando una coma.
5. Posición GPS: Se deben utilizar grados decimales, p.e. 30.22496 30.821798

=== _LibreOffice Calc_ y _OpenOffice Calc_

Son aplicaciones de hojas de cálculo de código abierto que forman parte de
suits mayores que, a su vez, también son código abierto. La interacción del
usuario con _LibreOffice Calc_ y _OpenOffice Calc_es muy similar.

En LibreOffice Calc el formato de tiempo debe ajustarse a minutos:segundos -
[mm]:ss y las fechas se deben ajustar a  aaaa-mm-dd, dd.mm.aaaa o mm/dd/aaaa.
Un diario típico codría parecerse a esto:

image::images/LOffice_spreadsheetdata.jpg["FIGURA: Datos de una hoja de cálculo",align="center"]

Para exportar los datos en archivo .CSV, desde LibreOffice clicar _Archivo ->
 Guardar como_. En el diálogo que se desplegará, seleccionar _Texto CSV (.csv)_
como tipo de archivo y seleccionar la opción _Editar ajustes de filtros_.

image::images/LOffice_save_as_options.jpg["FIGURA: Opciones de Guardar como",align="center"]

Tras seleccionar _Guardar_, seleccionar el delimitador de campos apropiado
(selecciona _TABULADOR_ para evitar conflictos con las comas cuando estas se
usen como coma decimal), luego seleccionar _OK_.

image::images/LOffice_field_options.jpg["FIGURA: Opciones de campos",align="center"]

Se puede verificar el archivo .CSV abriéndolo con un editor de textos y luego
se importaría como se explicó en xref:S_ImportingCSVDives[Importar inmersiones desde archivos _CSV_ manuales].

=== Microsoft _Excel_

El delimitador de campos (llamado "separador de listas" en los manuales de
Microsoft) no está accesible desde _Excel_ y debe ajustarse desde el _Panel de
Control_. Tras cambiar el carácter separador todo el software del ordenador con
Windows usará el nuevo carácter como separador.
Se puede volver a cambiar el carácter al inicial siguiendo el mismo sistema.

- En Microsoft Windows, pulsar el botón *Inicio* y seleccionar el _Panel de
  Control_ de la lista de la izquierda.
- Abrir el diálogo _Opciones de región y lenguaje_.
- Hacer una de las dos siguientes acciones:
  ** En Windows 7, clicar la pestaña _Formatos_ y luego _Personalizar este
     formato_
  ** En Windows XP, clicar la pestaña _Opciones de región_ y luego _Personalizar_.
- Teclear un nuevo separador en el _Separador de listas_. Para utilizar un
  tabulador teclea  "TAB" en la casilla de texto.
- Pulsar _OK_ dos veces.

A continuación, una imagen del _Panel de Control_:

image::images/Win_SaveCSV2.jpg["FIGURA: Separador de listas en Win",align="center"]

Para exportar el archivo en formato CSV:

Con el diario abierto en _Excel_, seleccionar el botón redondo de Windows de
arriba a la izquierda, luego _Guardar como_.

image::images/Win_SaveCSV1.jpg["FIGURA: Opción Guardar como en Excel",align="center"]

Clicar en la parte izquierda de la opción _Guardar como_, *NO* sobre la flecha
de la derecha. Esto desplegará un diálogo para guardar la hoja de cálculo en un
formato alternativo. De la lista desplegable abajo en el diálogo, seleccionar
_CSV(delimitado por comas) (*.CSV)_. Asegurarse de que se ha seleccionado la
carpeta correcta para guardar el archivo.

image::images/Win_SaveCSV3.jpg["FIGURE: Excel save _CSV_ dialogue",align="center"]

Seleccionar el botón _Guardar_. El archivo formateado en _CSV_ se guardará en la
carpeta que se hubiera seleccionado. Se puede verificar el archivo creado con
un editor de textos y luego importar los datos de buceo como se explicó en
xref:S_ImportingCSVDives[Importar inmersiones desde archivos _CSV_ manuales].

[[S_APPENDIX_E]]
== APÉNDICE E: Escribir una plantilla de impresión a medida

_Subsurface_ proporciona un mecanismo para crear o modificar plantillas que
permite producir impresiones a medida de los divelogs.  Las plantillas escritas
en HTML, y también como sencillo conjunto de instrucciones de Grantlee, se
interpretan y envian a la impresora por _Subsurface_.

Se accede a las plantillas utilizando el diálogo de impresión (imagen *B* a
continuación)

image::images/Print1_f22.jpg["FIGURA: Diálogo de impresión",align="center"]

Los botones en la parte de abajo de diálogo permiten _Editar_, _Borrar_,
_Importar_ y _Exportar_ plantillas (ver imagen *A* anterior). Las plantillas,
nuevas o modificadas, se guardan como archivos HTML en la misma carpeta en la
que está el divelog que se está procesando. Para crear o modificar una plantilla,
selecciona la plantilla _Custom_ de la lista desplegable (imagen *B* anterior) y
pulsa _Editar_.

El panel de edición incluye tres pestañas:

image::images/Template1_f22.jpg["FIGURA: Diálogo de edición de plantillas",align="center"]

1) La pestaña _Estilo_ (imagen *A* anterior) controla la fuente, el espaciado de
   lineas y la plantilla de colores utilizada para imprimir. Los atributos de estilo
   son editables. Elige una de las cuatro paletas.

2) La pestaña _Colores_ (imagen *B* anterior) permite editar los colores que se
   usarán para imprimir el registro. Los colores se pueden modificar: el botón
   _Editar_ de la pestaña _Colores_ permite elegir colores arbitrarios para los
   diferentes componentes de la impresión.

3) La pestaña _Plantilla_ del panel de edición (imagen a continuación) permite crear
   una plantilla usando HTML y sentencias de Grantlee. Grantlee proporciona la
   habilidad de crear y formatear código HTML de forma muy simple pero muy eficiente
   (ver a continuación). El HTML de la plantilla puede editarse y guardarse. La
   plantilla salvada se guarda en la carpeta en la que está el divelog con el que
   se está trabajando. Por defecto, una plantilla _a medida_ es un esqueleto sin
   instrucciones de impresión. La información a imprimir necesita ser especificada
   y formateada reemplazando la sección "<!-- Template must be filled -->".
   Escribir código HtMl con Grantlee da una libertad ilimitada para elegir lo que
   se imprime y como se va a visualizar.

image::images/Template2_f22.jpg["FIGURE:Template tab",align="center"]

El usuario también puede adaptar las plantillas existentes y guardarlas en la
carpeta donde se halle el divelog (por ejemplo One Dive, Six Dives, Table, etc).

Para escribir una plantilla a medida, deben existir los siguientes elementos
para que puedan ser manejadas e interpretadas:

=== Bucle principal
_Subsurface_ pasa una lista de inmersiones llamada (*dives*) al sistema _Grantlee_.
Se puede iterar sobre la lista de la siguiente manera:

.template.html
....
       {% for dive in dives %}
               <h1> {{ dive.number }} </h1>
       {% endfor %}
....

.output.html
....
       <h1> 1 </h1>
       <h1> 2 </h1>
       <h1> 3 </h1>
....

Se puede encontrar información sobre _Grantlee_ http://www.grantlee.org/apidox/for_themers.html[aquí]

=== Variables pasadas a Grantlee
Solo se pasa un subconjunto de los datos de una inmersión:
|====================
|*Nombre*|*Descripción*
|number| (*int*) número de la inmersión
|id| (*int*) diveID único, se usará para descargar el perfil
|date| (*string*) fecha de la inmersión
|time| (*string*) hora de la inmersión
|location| (*string*) ubicación del buceo
|duration| (*string*) duración del buceo
|depth| (*string*) profundidad de la inmersión
|divemaster| (*string*) datos del divemaster
|buddy| (*string*) datos del compañero
|airTemp| (*string*) temperatura del aire
|waterTemp| (*string*) temperatura del agua
|notes| (*string*) notas de la inmersión
|rating| (*int*) calificación del buceo, varía entre 0 y 5
|sac| (*string*) valor del CAS
|tags| (*string*) todas las etiquetas de la inmersión empalmadas
|gas| (*string*) datos de la botella
|rating| (*int*) calificación de la inmersión, varía entre 0 y 5
|sac| (*string*) valor del SAC para la inmersión
|tags| (*string*) lista de etiquetas para la inmersión
|gas| (*string*) lista de gases usados en la inmersión
|suit| (*string*) traje usado para la inmersión
|cylinders| (*string*) información completa de las botellas usadas
|cylinder0-7| (*string*) información sobre una botella concreta
|weights| (*string*) información completa de todo el sistema de lastre
|weight0-5| (*string*) información de una pieza concreta de lastre
|maxcns| (*string*) valor del máximo CNS de la inmersión
|otu| (*string*) valor del OTU de la inmersión
|sumWeight| (*string*) suma del lastre de la inmersión
|startPressure| (*string*) la presión inicial
|endPressure| (*string*) la presión final
|firstGas| (*string*) primer gas utilizado
|=====================

_Subsurface_ también pasa datos de la plantilla *template_options*. Estos datos
deben usarse como valores _CSS_ para proporcionar una plantilla editable de
forma dinámica. Los datos exportados se muestran en la tabla a continuación:
|====================
|*Nombre*|*Descripción*
|font| (*string*) familia de la fuente
|borderwidth| (*int*) valor de la anchura del borde, calculado dinámicamente
como 0.1% de la anchura de la página con un valor mínimo de 1px
|font_size| (*double*) tamaño de la fuente en vw, varía entre 1.0 y 2.0
|line_spacing| (*double*) distancia entre líneas de texto, varía entre 1.0 y 3.0
|color1| (*string*) color del fondo
|color2| (*string*) color primario de las celdas de la tabla
|color3| (*string*) color secundario de las celdas de la tabla
|color4| (*string*) color primario del texto
|color5| (*string*) color secundario del texto
|color6| (*string*) colores de los bordes
|=====================

.template.html
....
       border-width: {{ template_options.borderwidth }}px;
....

.output.html
....
       border-width: 3px;
....

Otra variable que pasa _Subsurface_ es *print_options*. Esta variable solo
contiene un único valor:
|=====================
|*Nombre*|*Descripción*
|grayscale | Utiliza filtros _CSS_ para convertir la página a escala de grises
(debe añadirse al estilo del cuerpo para activar la impresión en blanco y negro)
|=====================


.template.html
....
       body {
               {{ print_options.grayscale }};
       }
....

.output.html
....
       body {
               -webkit-filter: grayscale(100%);
       }
....

=== Selectores CSS definidos

Como el perfil se coloca después del renderizado, _Subsurface_ usa unos selectores
_CSS_ especiales para ejecutar algunas búsquedas en la salida HTML. Deben añadirse
los selectores de la siguiente tabla:

|====================
|*Selector*|*Tipo*|*Descripción*
|dive_{{ dive.id }} | id | se utiliza para descargar el perfil de inmersión
correspondiente
|diveProfile | class | cada div que contendrá un perfil de inmersión debe tener
este selector de clase añadido al selector divee_{{ dive.id }}
|dontbreak | class | evita que el div que tenga esta clase se divida en dos
páginas
|=====================

IMPORTANTE: Renderizar perfiles de inmersión no está soportado en plantillas
de distribución de flujo (cuando datos-número de buceos = 0).

=== Atributos especiales

Hay dos formas de renderizar: bien renderizar un número concreto de buceos por
página, bien hacer que _Subsurface_ intente introducir tantas inmersiones como
sea posible en una sola página.

El atributo de datos *data-numberofdives* se añade a la etiqueta body para
fijar el modo de renderizado.

- Renderizar 6 inmersiones por página:

....
       <body data-numberofdives = 6>
....

- Renderizar tantas inmersiones como sea posible:

....
       <body data-numberofdives = 0>
....

IMPORTANTE: Todas las unidades CSS deben estar en longitudes relativas para
imprimir en cualquier tamaño de página.

[[S_APPENDIX_F]]
== APÉNDICE F: Preguntas Frecuentes

=== _Subsurface_ parece calcular mal el consumo de gas y el CAS
[[SAC_CALCULATION]]
'Pregunta': Buceé con una botella de 12,2 l empezando con 220 bar y terminando
con 100 bar y yo calculo un CAS distinto al que calcula _Subsurface_ ¿Está
calculándolo mal _Subsurface_?

'Respuesta': En realidad no. Lo que sucede es que _Subsurface_ calcula el
consumo de gas de forma diferente (y mejor) de lo que esperas. En particular,
tiene en cuenta la incompresibilidad de los gases.
Tradicionalmente para calcular el consumo y el CAS se usaba

+consumo = tamaño_de_botella x (presión_inicial - presión_final)+

y es cierto para un gas ideal y es lo que se enseña en la teoría del buceo. Pero
actualmente no existe un "gas ideal" y los gases reales no se comprimen
linealmente con la presión. Además, estás olvidando el hecho de que una
atmósfera de presión no es un bar. Así pues, el cálculo *real* es

+consumo = (cantidad_de_aire_al_inicio - cantidad_de_aire_al_final)+

donde la cantidad de aire *no* es simplemente "tamaño_de_botella x
presión_en_bares". Es una combinación de "tener en cuenta la compresibilidad de
los gases" (que es bastante poco a 220 bar pero se nota mucho más a 300 bar) y
"convertir los bares en atmósferas" (que es la mayor parte de la discrepancia).
Recuerda: una atm es ~1.013 bar, por tanto sin compresibilidad, tu uso de gas es
:

+12.2*((220-100)/1.013)+

que es aproximadamente 1445, no 1464. Así pues había 19 litros de más en tu
cálculo que ignoraba la diferencia entre bar y atm. La compresibilidad aparece
por encima de 200 bar y reduce los 1445 en unos 8 litros más por lo que
realmente usaste unos 1437 litros al nivel del mar.

Por lo tanto, alégrate: tu CAS es mejor de lo que tus cálculos indicaban. O
entristécete: tu botella contiene menos aire de lo que pensabas. Y como
mencionábamos el "contiene menos aire de lo que pensabas" se hace más notorio a
altas presiones. A 400 bar realmente no contiene el doble de aire que a 200 bar.
A presiones más bajas, el aire se comporta bastante como un gas ideal.

=== Algunos perfiles de inmersión tienen discrepancias de tiempos con las muestras que toma mi ordenador de buceo …

_Subsurface_ termina por ignorar el tiempo en superficie por varios motivos
(profundidad media, tiempo de inmersión, CAS, etc).

'Pregunta': ¿Por qué las duraciones de los buceos en mi ordenador difieren de
los proporcionados por _Subsurface_?

'Respuesta': Por ejemplo, si al terminar haces una prueba de lastre
(suficientemente profunda para iniciar el ordenador de buceo) y luego subes y
esperas 5 minutos a tus compañeros, tu ordenador puede decir que has hecho una
inmersión de 50 minutos, pero _Subsurface_ dirá que es de 45 minutos (porque
realmente has estado buceando 45 minutos). Es mucho más notable si haces cosas
como actuar de instructor en inmersiones de curso, donde puedes estar en el agua
mucho rato pero pasar la mayor parte del tiempo en superficie. En este caso no
querrás que te cuente como algún tipo de inmersión larga.

=== Se han perdido algunos perfiles en la descarga

[[DC_HISTORY]]
'Pregunta': No consigo descargar todas mis inmersiones, solo las más recientes,
incluso aunque el manual de mi ordenador de buceo afirma que guarda el historial
de, por ejemplo, 999 buceos.

'Respuesta': El historial de buceo es diferente de los perfiles de inmersión del
registro. El historial solo conserva rastro del total de inmersiones y el tiempo
total pasado bajo el agua. Los registros, por otra parte, conservan el perfil de
inmersión, pero disponen de una cantidad limitada de memoria para hacerlo. La
cantidad exacta de perfiles que pueden guardarse en un dispositivo dependen del
intervalo de las muestras y de la duración de los buceos. Una vez que la memoria
se ha llenado se sobre escriben las inmersiones más antiguas con nuevas. De
esta forma, solo podemos descargar las últimas 13, 30 o 199 inmersiones.

Si has descargado tus inmersiones a otro divelog antes de que se sobrescribieran,
hay muchas posibilidades de que Subsurface pueda importarlas. Sin embargo, si los
registros estaban solo en el ordenador de buceo, no pueden recuperarse tras haber
sido sobrescritos.