Author Topic: Guide  (Read 146 times)

Randi

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 13171
    • View Profile
Guide
« on: May 29, 2017, 11:37:29 pm »
Thanks to everyone for advice and especially to Caro for getting this started and editing it ;)





OW:Next

To take part, you need to download and install LibreOffice.

The latest versions of LibreOffice are available here: https://www.libreoffice.org/download/download/
You have a choice of:
Fresh 211 MB
Still 213 MB
Some LibreOffice users find the 'still' version to be more stable (or 'mature', like a lot of us here).
Although LibreOffice versions are available for MacOS and Linux, the current version of the spreadsheet only works on Microsoft Windows.

Bob's detailed instructions for downloading and installing LibreOffice and setting up the spreadsheet:



Downloading and opening a log page

On the Log Page tab:

Click in cell B1 and type the number of the image you have chosen to transcribe (from the Tracker).
Press Enter or Return on your keyboard. This is important.

Click the 'Browser Download' button.
In the dialog box that opens on a new tab, choose Save File, and OK.
You will not get a dialog if you have the Always Ask option turned off in your browser settings.
Check that the download has taken place, then return to the spreadsheet. You can close the blank tab of course.
 
Click the 'Open Local File' button.
The image of the log page will be loaded into the spreadsheet.



Alignment

Occasionally, you will see a page that is slanted.



In this case, use the 'Adjust Angle' arrows to rotate the image (clockwise or counterclockwise) so that the red grid lines are parallel to the printed grid lines.



Hint: Do this before adjusting the horizontal and vertical position of the grid on the page (below).


You will rarely see size problems with the red grid, but sometimes it is offset from the printed grid.



This can easily be fixed by dragging the spreadsheet column separator between columns B and C to move the red grid to the correct horizontal alignment and/or by dragging the spreadsheet column separator between rows 4 and 5 to move the red grid to the correct vertical alignment.
The cursor will change to a left-right arrow ↔ when your cursor is in the right place to do this.



You can also drag the spreadsheet column and row separators (A, B, C ... 1, 2, 3 etc at the top and left-hand side) to fine tune positions of individual red grid lines.



Transcribing

Please note that ONLY data entered in a marked box will be saved. The marked boxes are:
  • red for Weather records
  • magenta for Location (the Position of Record) and Date
  • green for Events

You can open a simple image of the log page(s) by clicking the 'Open In Browser' button. This will open the JPG image in your default browser.
You may find this handy for reference.

You will notice that the transcribing box becomes opaque when you begin to type.
This is a feature of the spreadsheet that we just have to live with.
If you find you have forgotten what you were typing half way through, press 'Enter', check the information again, then double click the box to open it and complete your entry.
Double click any completed cell to open it for correction.

An XML file is generated when the 'Write Data' button is clicked on completion of transcribing a page.
Use a program like WordPad or NotePad to open the file if you want to check whether the data you entered has been saved.



Weather records

Enter the weather records in the red grid.



The hours, 1am-12noon and 1pm-12midnight, have been filled for you.

You should transcribe any information that appears in a red box.
Simply click in the box, note the value in the box, because it will disappear as soon as you start to type, and then type in the value.
In this example you should transcribe:
- Wind: Direction
- Wind: Force
- Barometer: Height in Inches
- Temperature: Air Dry Bulb
- Temperature: Air Wet Bulb
- Temperature: Water at Surface
- State of the Weather by Symbols
- Clouds: Forms of by Symbols
- Clouds: Amount Scale 0 to 10

There are no red boxes for Reading of Patent Log, Distance Knots and Tenths, or Courses Steered by Standard Compass, so there is no need to transcribe them.
Data transcribed in these columns will not be saved.



You can enter the data by rows (press the Tab key after entering the data) or by columns (press the Enter key after entering the data).
You can enter the data in random order if you really want to do so.

Although previous Old Weather interfaces used row-based order, many transcribers requested column-based order.
Column-based order is very convenient for cut and paste and mapurves has created macros to duplicate the entry one (CopyDown 1 ) or two (CopyDown2) lines above the cursor.
To use these two macros, you will need to assign shortcut keys to them.
Open the Tools drop-down menu and select Customize.
Go to the Keyboard tab and in the Category box, select LibreOfficeMacros | Bear*.ods | Standard | Extensions.
Then in the Functions box select CopyDown1.
Select an entry from the Shortcut Keys box, for example Alt+1, and then click Modify.
Select CopyDown2 in the Functions box and repeat the shortcut key assignment.

Randi

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 13171
    • View Profile
Re: Guide
« Reply #1 on: May 29, 2017, 11:39:13 pm »
Location

In the logs we are currently using, the noon, 8am and 8pm locations can usually be found in the section below the weather data on the left hand page.
Other locations may be given in the events section on the right hand page.

  • The system of location entry described here is probably not final but please follow it until further notice.
  • Except when sea ice is mentioned, only one location is required. In this document the location is referred to as the "Position of Record".
    Normally it will be the noon (observed) location.
    If there is no noon (observed) location it is up to the transcriber to decide what location to use: noon (dead reckoning), 8am, 8pm, an entry from the events, or even the transcriber's best guess.
    The science team has requested that we include as much location information for mentions of sea ice as possible.
  • One big change from previous OW interfaces is that we are now encouraged to do more processing of the location information.
    Strict TWYS is still acceptable, but you are now asked where possible to convert a place name or a place name with bearings into latitude and longitude.
    Decimal latitude and longitude are preferred to the degree-minute-second format typically entered in the log.
    This will be explained in more detail below.
  • Not Specified can be used for a lat/long when you do not know if it is Obs or DR.
  • Place is now used both when there is only a name and when there is a name and a bearing. Port is no longer used.


Position of Record

If the noon location or other location being used is a latitude and longitude, this can be entered using the Location Wizard (Obs).
Right click to select a cell within the green box near the position you are transcribing.
A black-bordered box appears on the page together with a menu, from which you should select Location Wizard (Obs).



Enter the latitude and longitude values including the hemisphere (N/S, E/W), the time and whether the reading is DR, Observed or Not Specified.
The lat/long will be automatically converted to the decimal form.



Click Save.
The Location X in A15 will change to solid green and the lat/long data will appear in the magenta boxes on the right hand page (Loc Tag, Loc Data, Loc Time).



The black-bordered box will preserve the original lat/long data:
<time>Noon</time><type>Location</type><subtype>Obs</subtype><text>40 03 00 N 124 21 00 W</text>

If the noon location or other location being used is a place (with or without bearings), there are two ways to enter it.
The simplest is to follow the existing TWYS policy.
Left click in the magenta Loc Tag box, then on the attached arrow button to the right, and then select Place from the list.
Next, left click in the magenta Loc Data box and type in the place name and any bearings as they appear in the log.
Finally, left click in the magenta Loc Time box and type in the time of the observation.



If you feel more ambitious, you can look up the lat/long of the place (Geographical Help will help).
If the location information includes bearings, you may find OW Bearing in OW Tools - by Mapurves & Propriome useful.
Since the location is based on the observation of a place, Obs should be selected from the list for the magenta Loc Tag box.
Enter the lat/long you have determined in the magenta Loc Data box, and enter the time of the observation in the magenta Loc Time box.



As a safety precaution, please enter the place text as well.
Right click to select a cell within the green box near the position you are transcribing.
A black-bordered box appears on the page together with a menu, from which you should select Event Input Wizard.
The time can be selected from the Time drop-down menu or entered manually.
Select Location from the Type drop-down menu, and select Place from the Subtype drop-down menu.
Enter the text from the log into the Event Text box and click Done. The black-bordered box will preserve the log data:
<time>Noon</time><type>Location</type><subtype>Place</subtype><text>Nome, Alaska</text>

Note: Do not use the Location Wizard (Obs) for positions other than the Position of Record. A new position will overwrite an existing position.

Other Positions

You can enter as many other positions as you want.
Right click near the position making sure that you are within one of the green Event Boxes.
Select the Event Input Wizard from the menu that appears.
The time can be selected from the Time drop-down menu or entered manually.
Select Location from the Type drop-down menu, and select the appropriate entry from the Subtype drop-down menu.
Enter the text from the log into the Event Text box and click Done. The black-bordered box will show what you entered.
If the position is a degree-minute-second latitude and longitude, you can enter it as degree-minute-second or convert it to decimal.
If the position is a place name or a place name with bearings, you can add a second entry showing the position as a decimal latitude and longitude.



Date

The date should always be transcribed, even when there is nothing of interest to you on the page or when, because of inserts, there are multiple pages with the same date.

In the logs we are currently using, the date can usually be found at the top of the right hand page.
You will see a magenta box. It will probably not cover the date completely, but that does not matter.
Click inside the magenta box and enter the date in YYYY-MM-DD format.
For example, May 6, 1914 would be entered as 1914-05-06.
Please be sure to use the minus character '-' rather than the slash character '/'.
You may depart from the TWYS rule and add or correct the date.
If you do so, it would be helpful if you added a Transcriber Comment with a Subtype of Date and a brief explanation.

When the date has been entered, the Date X in A14 changes to solid green.
« Last Edit: May 30, 2017, 04:19:02 pm by Caro »

Randi

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 13171
    • View Profile
Re: Guide
« Reply #2 on: May 29, 2017, 11:40:22 pm »
Events

For the logs we are currently using, there are two green events boxes.
One is below the weather grid and the other covers the miscellaneous events on the right hand page.

Remember that if you transcribe data outside the green events boxes, the red weather grid or the magenta date and location boxes, the transcription will not be saved.
So if, for example, you want to transcribe the location text at the top of the weather page, you need to right click within one of the green events boxes.
Unlike OW3, the transcriptions are not tagged with the location on the page.
This means it makes no significant difference in the information passed to the science team whether you transcribe events from the first watch at the bottom of the right hand green events box and events from the last watch at the top of the left hand green events box.
However, you will probably find it less confusing if you select a box as close as possible to the event you are transcribing.

Right click to select a cell within the one of the green boxes.
A black-bordered box appears on the page together with a menu, from which you should select Event Input Wizard.

Time, Type, and Subtype all have drop-down menus, but they also allow you to enter text.

Time can be the watch in which the event occurs (e.g., Mid to 4AM) or the time associated with the event (e.g., 2:25).
Leave this section blank if there is no time that applies (e.g., for the sick list).

If you wish to record only the time and location from a log entry such as this:
Quote
Mid - 4AM

... 2:30 stopped off King Island Village; found it deserted, all Eskimos having
gone to Nome, Alaska, for the summer.
 
This is the preferred method; a slight deviation from the TWYS rule:
Time: 2:30AM (typed in)
Type: Location
Sub-type: Place   
King Island Village


Type categories are: All, Animals, Location, Other, People, Refueling, Sea Ice, Ships, and Transcriber Comment.
The items that should be entered in these categories are explained below.
Any mentions of Sea Ice should be transcribed.
Transcribing any of the other types of events is optional.

If there is a Type that you think should be added, please post a note in the forum.
It is possible to enter a new Type, but keep in mind that doing so might make things harder to find, rather than easier.
If you do enter a new Type, please post a note in the forum.

The Subtypes available depend on the Type selected.
There are a few Types that do not (currently) have Subtypes.

As with Types, if there is a Subtype that you think should be added, please post a note in the forum.
If you enter a new Subtype, please post a note in the forum.

  • All
    Use this to indicate that you are transcribing all the events on the page, either as a single entry or split into watches (the latter is easier to check and correct!).
    To help the science team, please create separate Sea Ice events for each mention of sea ice.

  • Animals
    • Fishing/Hunting
    • Sighted
    • Transported
    • Pet
  • Location
    For lat/longs, place names, landmarks etc other than the Position of Record (the noon lat/long where available).
    • Obs
    • DR
    • Place
      This can be a place name or a place name with bearings (or, the least helpful, from place name to place name)
    • Not Specified
      Use this when the log does not specify whether latitude and longitude are observed or dead reckoning.
  • Other
    • Native Interaction
      Please do not use this. Any mentions of natives, by name or otherwise, can now be included under People which has been expanded to include unnamed people such as governor, judge, and native
    • Instruments
      Include here comments about weather instruments (e.g., dry bulb thermometer found to be reading one degree too high).
    • Astronomical
    • Aurorae
      Mentions of aurorae are used by the Solar Stormwatch researchers to study historical solar activity.
    • Ocean/Seaweed/Plankton
      Include here mentions of rough seas, sightings of kelp and other seaweed, and discolored or luminescent patches of sea.
    • Weather
      This is for text descriptions of the weather.
      Such text descriptions will not be needed in the near future, so it is probably not worth transcribing ordinary watch entries (e.g., Light westerly airs, mostly cloudy).
      However, it may be worth transcribing unusual or extreme weather.
    • Volcanic
      Several groups are using our observations to update their records of historic volcanic activity.
  • People
    One or more people (and ships), named or unnamed, may be included in a single entry for the watch in which they appear.
    If there are multiple names separated by text that you don't wish to include, put the names on separate lines.
    • Ship
      Use this subtype to indicate that one or more ships are mentioned in the transcription (e.g., Philip Wood, Lds, and Kevin Brohan, Sea, were transferred to the USS "Enterprise")
      In this case a Type of Ships with a Subtype of People could also be used. It depends whether you want to emphasize the people or the ships.
  • Refueling
    • Coal
    • Oil
    • Other
  • Sea Ice
  • Ships
    One or more ships (and people), named or unnamed, may be included in a single entry for the watch in which they appear.
    If there are multiple names separated by text that you don't wish to include, put the names on separate lines.
    • People
      Use this subtype to indicate that one or more people are mentioned in the transcription (e.g., Philip Wood, Lds, and Kevin Brohan, Sea, were transferred to the USS "Enterprise")
      In this case a Type of People with a Subtype of Ships could also be used. It depends whether you want to emphasize the people or the ships.
  • Transcriber Comment
    At long last we have a way to add our comments to log pages!
    • Bad Scan
      It is probably best to report bad scans in the forum too.
    • Date
      If you have a problem or question with the date, you can explain it here.
    • Inserts
    • Location
      If you have a problem or question with the location (perhaps the noon location is given as Tolstoi Point instead of Cape Tolstoi), you can explain it here.
    • Weather Record
      If you have a problem or question with the weather data, you can explain it here.
« Last Edit: June 01, 2017, 05:02:13 am by Randi »

Randi

  • Global Moderator
  • Hero Member
  • *****
  • Posts: 13171
    • View Profile
Re: Guide
« Reply #3 on: May 29, 2017, 11:40:33 pm »
Special cases

Nothing to transcribe

Some log pages have nothing to transcribe (e.g., Directions for keeping the ship's log) or may have nothing that you are interested in transcribing (List of officers).
Every image needs to have a data file associated with it to avoid ambiguity between pages which contain nothing to transcribe and skipped pages.
In cases like this, please create an event with the Type Transcriber Comment (Subtype can be left blank) and Event Text such as 'Not transcribed', 'Directions for log', 'List of officers', 'Blank', etc.

Remember that if there is a date it should be transcribed even if you don't transcribe anything else.
Because the date is something, the above comments don't apply. ;)

Inserts

Inserts in a logbook generally require multiple page scans.
Except for the date, duplicate data normally does not need to be transcribed.

For side-attached inserts:
On the first page transcribe: all weather records, location(s), the date, and anything of interest on the insert (e.g., the person on the sick list).
On the second page transcribe: anything of interest on the back of the insert (in this case it is blank), the date, and anything of interest on the log page.

For top-attached inserts:
On the first page transcribe: all weather records, location(s), the date, and anything of interest on the insert.
On the second page skip the weather records and location, and transcribe: the date and anything of interest on the log page.
If the date is not visible, as is the case here, and you are able to determine the date, add a Transcriber Comment with Subtype Date with the date in the Event Text field using the format YYYY-MM-DD.

For all pages with inserts, please add a Transcriber Comment with Subtype Inserts. It is not necessary to enter any Event Text.



Custom configuration

If you find that the spreadsheet's white grid lines obstruct your view when transcribing, you can switch them off (and on again) by clicking View/Grid Lines for Sheet.
The red grid will not be affected.

It is possible to change your entry text's font size and color, and the position of the entry within the box.
It is also possible to change the color and thickness of the cell's outlines. You may find these changes make transcribing easier.
Select a cell by left clicking in it or select a block of cells by left clicking and dragging.
Then either right click in the cell(s) and select Format Cells... from the pop-up menu or click on the Format drop-down menu at the top of the screen and pick Cells...
From the pop-up window you can select the Font tab to adjust the font size, the Font Effects tab to change the font color (the default is Automatic), the Alignment tab and the Vertical menu under Text Alignment to change the position, or the Borders tab to change the cell outline.