mirror of
https://github.com/subsurface/subsurface.git
synced 2025-01-31 20:43:24 +00:00
User manual update
This adds text to the following sections: 1) Dive planner (Open circuit planning) 2) Dive Planner (Recreational OC planning) 3) Use of hashes to move images between directories 4) Undo/Redo feature of dive list manipulations One image in planner text is modified. Signed-off-by: willem ferguson <willemferguson@zoology.up.ac.za> Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
This commit is contained in:
parent
b846915f43
commit
2894ee0759
2 changed files with 90 additions and 20 deletions
Binary file not shown.
Before Width: | Height: | Size: 79 KiB After Width: | Height: | Size: 68 KiB |
|
@ -1643,6 +1643,54 @@ program only shows a small white dot where each photo should be on the dive prof
|
|||
In addition the _Photos_ tab only shows the file names of the photos. This is normal behaviour.
|
||||
If, later, the external drive with the photos is connected again, the photos can be seen in the normal way.
|
||||
|
||||
[[Moving_images]]
|
||||
==== Moving photographs among directories, hard disks or computers
|
||||
|
||||
After a photograph has been loaded into _Subsurface_ and associated with a specific dive, the directory
|
||||
where the photo lies is stored, allowing _Subsurface_ to find the photograph when the dive is
|
||||
opened again. If the photo or the whole photo collection is moved to another drive or to a different
|
||||
machine, it is unlikely that the directory structure will remain identical to that of the original uploaded
|
||||
photo. When this happens, _Subsurface_ looks for the photos at their original location before they were moved,
|
||||
cannot find them and therefore cannot display them. Because, after moving photos, large numbers of photos
|
||||
may need to be deleted and re-imported from the new location, _Subsurface_ has a mechanism that eases the
|
||||
process of updating the directory information for each photo: automatic updates using fingerprints.
|
||||
|
||||
When a photo is loaded into _Subsurface_, a fingerprint for the image is calculated and stored with the
|
||||
other reference information for that photo. After moving a photo collection (that has already been loaded
|
||||
into _Subsurface_) to a different directory, disk or computer, _Subsurface_ can perform the
|
||||
following steps:
|
||||
|
||||
- look through a particular directory (and all its subdirectories recursively) where photos have been moved
|
||||
to,
|
||||
|
||||
- calculate fingerprints for all photos in this directory, and
|
||||
|
||||
- if there is a match between a calculated fingerprint and the one originally calculated when a photo was
|
||||
loaded into _Subsurface_ (even if the original file name has changed), to automatically update the
|
||||
directory information so that _Subsurface_ can find the photo in the new moved directory.
|
||||
|
||||
This is achieved by selecting from the Main Menu: _File -> Find moved images_. This brings up a window within
|
||||
which the NEW directory of the photos needs to be specified. Select the appropriate directory and click
|
||||
the _Scan_ button towards the bottom right of the panel. The process may require several minutes to
|
||||
complete, after which _subsurface_ will show the appropriate photographs when a particular dive is opened.
|
||||
|
||||
|
||||
[[Image_fingerprint_upgrade]]
|
||||
****
|
||||
*Upgrading existing photo collections without fingerprints*
|
||||
[icon="images/icons/important.png"]
|
||||
[IMPORTANT]
|
||||
|
||||
Software for the automated update of existing photo collections is under developement. Currently single
|
||||
dives must be upgraded one at a time. Select the toolbar button on the *Dive profile* panel that enables
|
||||
the display of images. The thumbnails of images are shown on the dive profile. Then open the dive and
|
||||
change anything in the *Notes* panel that brings up the blue edit bar at the top of the notes panel
|
||||
to save the edits. For instance, add a space character at the end of the _Notes_ text box and immediately
|
||||
delete that space character. Select the optio _Apply changes_ in the blue edit bar to save the dive information.
|
||||
Fingerprints are calculated while saving this specific dive.
|
||||
|
||||
****
|
||||
|
||||
|
||||
=== Logging special types of dives
|
||||
|
||||
|
@ -2406,6 +2454,14 @@ below shows the depth profile of two such dives that were merged:
|
|||
|
||||
image::images/MergedDive.png["Example: Merged dive",align="center"]
|
||||
|
||||
==== Undo dive manipulations
|
||||
|
||||
Important actions on dives or trips, described above, can be undone or redone.
|
||||
This includes: _delete dives_, _merge dives_, _renumber dives_ and _shift dive times_.
|
||||
To do this after performing any of these actions, from the *Main Menu* select
|
||||
_Edit_. This brings up the possibility to _Undo_ or _Redo_ an action.
|
||||
|
||||
|
||||
[[S_Filter]]
|
||||
=== Filtering the dive list
|
||||
|
||||
|
@ -2914,17 +2970,18 @@ any warning messages about the dive plan are printed.
|
|||
image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window",align="center"]
|
||||
|
||||
|
||||
=== Open circuit dives as an example of dive planning
|
||||
=== Open circuit dives
|
||||
|
||||
- Towards the left bottom of the planner (circled in blue in the image below) is a dropbox with three options. Select the appropriate one of these:
|
||||
- Towards the centre bottom of the planner (circled in blue in the image above) is a dropbox with three options. Select the appropriate one of these:
|
||||
** Open Circuit (the default)
|
||||
** CCR
|
||||
** pSCR
|
||||
|
||||
- Choose the Open Circuit option.
|
||||
- In the top left-hand area of the planning screen, ensure that the constant dive parameters are
|
||||
appropriate. These are: Start date and time of the dive, Atmospheric Pressure and Altitude
|
||||
appropriate. These are: Start date and time of the intended dive, Atmospheric Pressure and Altitude
|
||||
above sea level of the dive site. The atmospheric pressure can also be entered as an altitude
|
||||
in metres, assuming an atmospheric pressure of 1.013 bar.
|
||||
in metres, assuming a sea-level atmospheric pressure of 1.013 bar.
|
||||
|
||||
- In the table labeled _Available Gases_, add the information of the cylinders to be used
|
||||
as well as the gas composition within that cylinder. This is done in a similar way as for
|
||||
|
@ -2935,8 +2992,20 @@ image::images/PlannerWindow1_f20.jpg["FIGURE: Dive planner startup window",align
|
|||
concentration in the boxes provided in this dialogue. Add additional cylinders by using the
|
||||
"+" icon to the top righthand of the dialogue.
|
||||
|
||||
- The dialogue indicating _Dive Planner Points_ is usually not used at this stage of the dive
|
||||
planning.
|
||||
- The profile of the planned dive can be created in two ways:
|
||||
* Drag the waypoints
|
||||
(the small white circles) on the existing dive profile in a way to represent the dive. Additional
|
||||
waypoints can be created by double-clicking the existing dive profile. Waypoints can be deleted
|
||||
by right-clicking a particular waypoint and selecting the _delete_ item from the resulting
|
||||
context menu.
|
||||
* The most efficient way to create a dive profile is to enter the appropriate values into the table
|
||||
marked _Dive planner points_. The first line of the table represents the duration and the final
|
||||
depth of the descent from the surface. Subsequent segments describe the bottom phase of the dive.
|
||||
The _CC set point_ column is only relevant for closed circuit divers.
|
||||
The ascent is usually not specified because this is what the planner is supposed to calculate.
|
||||
Add additional segments to the profile by selecting the "+" icon at the top right hand of the
|
||||
table. Segments entered into the _Dive planner points_ table automatically appear in the *Dive
|
||||
Profile* diagram.
|
||||
|
||||
==== Recreational dives
|
||||
|
||||
|
@ -2960,8 +3029,8 @@ defined.
|
|||
- Ensure that the date and time is set to that of the intended dive. This allows calculation of
|
||||
the nitrogen load incurred during previous dives.
|
||||
|
||||
- Immediately under the heading _Planning_ are two checkboxes _Recreational_ and _Safety Stop_. For
|
||||
planning recreational dives, check these two checkboxes.
|
||||
- Immediately under the heading _Planning_ are two checkboxes _Recreational_ and _Safety Stop_.
|
||||
Check these two boxes.
|
||||
|
||||
- Then define the cylinder size,
|
||||
the gas mixture (air or % oxygen) and the starting cylinder pressure in the top left-hand
|
||||
|
@ -2972,11 +3041,12 @@ the planned dive. In order for this to be realistic, under _Gas options_, specif
|
|||
surface air consumption (SAC) rate for _Bottom SAC_. Suitable values are between 15 l/min and 30 l/min,
|
||||
with novice divers or difficult dives requiring SAC rates closer to 30l/min.
|
||||
|
||||
- Define the amount of gas in the cylinder at the end of the bottom section of the dive just before ascent. A
|
||||
value of 50 bar is often used.
|
||||
- Define the amount of gas that the cylinder must have at the end of the bottom section of the
|
||||
dive just before ascent. A value of 50 bar is often used.
|
||||
|
||||
- Define the depth of the dive by dragging the waypoints (white dots) on the dive profile or
|
||||
(even better) defining the appropriate depth using the table under _Dive planner points_. If
|
||||
(even better) defining the appropriate depths using the table under _Dive planner points_ as
|
||||
desribed under the previous heading. If
|
||||
this is a multilevel dive, set the appropriate dive depths to represent the dive plan by adding
|
||||
waypoints to the dive profile or by adding appropriate dive planner points to the _Dive Planner Points_
|
||||
table.
|
||||
|
|
Loading…
Add table
Reference in a new issue