*********************************************************************
BLU-ICES

Converts Blueprint '86 to ICES

Problems occur for very long stations and error message appears. Necessary
to juggle with Dimension statement

***************************************************************************
CD-ICES

Converts NODC CDROM to ICES Format
***************************************************************************
CSV-SUR

Selects parameters from a .csv file (prepared by ices-csv), and are
suitable for input to Surfer, and similar package

Default separator is space, but can be changed in command line

***********************************************************************
ENTICE

Enter Station data using this utility. It produces output in the
ICES Blueprint '86 format (for programming convenience only). This
may be converted to ICES format using BLU-ICES. A file with
extension .DAT is also produced which may be re-read by ENTICE to
facilitate later editting of the data. The user may also use this file
to port to his own software.


What keys to use and hints

  
  F1    - Master record
  F2    - Data cycles 1 to 22 - first 11 parameters
  sh-F2 - Data cycles 1-22 - last 4 parameters (depth for info only)
  F3    - Data cycles 22 to 44 - first 11 parameters
  sh-F3 - Data cycles 22 to 44 - last 4 parameters (depth for info only)
  sh-F4 - Doubtful data quality marker - point to field before pressing
  F10   - Saves data into Blueprint file and file readable by ENTICE
  Esc      - Press two (or three) times to abort without save
  Cursors  - Use cursor keys to navigate to fields
  Tab      - Press to move to beginning of next column
  Ctrl-D   - Delete entry and shuffle fields up.
  Ctrl-E   - Expand; ie create a space and shuffle fields down
  Others   - All numeric keys plus delete, < , . , and - are permissible
             (assuming permitted by the data entry checks)
  Hints    - Once a field is filled, the cursor moves to the next field
             Alternatively, if you do not want to use all available
             decimal positions in a field, terminate the entry
             by pressing <Enter>.
  

             Type '.' to avoid typing leading zeros (eg 7. gives  07)
  Beeps    - Your computer will beep if you enter a number that is not
             within the allowed range. The greatest control occurs in 
             in the depth field - these must be entered before any other
             parameter - and must be increasing.
********************************************************************************
EXTRACT

Extracts from selected parameters a subset of an ICES file

If Index file available (.IND) then extraction only on indexed quantities
(year, area, section). If not co/sh, month, day also available.

If run from Directory G:\index, and given filename is MASTER.SEL then
multi file search is initiated. Prepare MASTER.SEL as follows

dir *.ind>dir.lst
edit dir.lst to remove none file lines
sort <dir.lst >master.sel
edit master.sel to remove index files not required.

Command Line options:

 '-' 	disables index file even though present

***************************************************************************
FISUM    	

Summarise contents of an ICES data file

***************************************************************************
ICE-EDT  	

1.     ICE-EDT edits ICES data records without the need of an editor.
2.     To operate you need to know the record number.  This can be obtained
       either from running TSLOOK (data records) or STASUM (master records) or
       ICESQC. Both TSLOOK and ICESQC have an ability to create a file with
       marked errors - By placing a '?' at the record number prompt, this
       program will point directly to the flagged record from where it can
       be changed
3.     Files of any size, to the limit of your disk space, are accommodated
       Program will abort if record type is not recognized.
4.     When making corrections to master records, corresponding corrections
       to data records are made automatically
5.     If value you wish to enter to a field is larger than the field, this
       requires an 'overpunch' which is generated by a entering a '+' instead 
       of the first number. For example 1232 in a field with a width of 3 will
       be entered +232 K32 will appear.  Note that if the + replaces anything
       but the number 1 then the value is too big for the field - R99 should be
       entered.
6.     Records may be stepped through one at a time by pressing ENTER at
       the record no. prompt.  Press `r' to reverse direction.

******************************************************************************
ICELIST  	

Prepares an Formatted list of ICES data files
******************************************************************************
ICES-CSV

Converts ICES files to (comma) separated files - hydrography
or hydrography and chemistry. File can be read by sel-csv

Default separator is a comma. (Change in command line).
It is recommended that any ICES data file which the user wishes to
convert should first be passed through this program, as the data file
structure is complex (and not well documented).

*************************************************************************
ICE-EXT

This is exactly the same as EXTRACT, except that it can be used in
conjunction with .zip files. Files are uncompacted whenever a hit
is found (if searching via index file)
***************************************************************************

ICE-NODC

Converts ICES files into NODC format (Surplus parametes stored in .sup
file.

       Information about the NODC and ICES Oceanographic Station Formats

       Almost all Oceanographic Station data are presently held in either
       the ICES or NODC formats - the current data sets go back to 1902,
       the date of the establishment of the Standard Seawater Service

       The formats were devised in the early 1960s.  At that time US needs
       and ICES needs differed slightly, and as a result, although 
       structurally similar, the formats differ in both concept and
       parameters.  The ICES format contains a number of chemical parameters
       additional to those in the NODC format - whenever this utility
       encounters such parameters, it stores them in a file (.sup extension)
       These parameters are identified by the 4-digit GF3 code.

       It is intended that this utility be used in conjunction with the 
       sister utility <nodc-ice>, which, as its name suggests, converts data
       files from NODC's format to ICES format.  This will allow the user
       to take advantage of various PC-based oceanographic data display
       products, eg ATLAST, and at the same take advantage of the wide
       range of interactive data management software provided by ICES, but
       which supports only the ICES format.
**************************************************************************
ICESORT  	

Performs hierarchical sort on ICES data file (Year, country, ship,
date, time, station number). Station files up to 15,000 in number
can be handled (irrespective of station size)
************************************************************************
ICESQC   	

Command line function:
<D> - suppresses decreasing depth flag

Quality Control of ICES formatted hydrochemistry files

Quality Control at ICES includes several procedures ranging
from the validation of records to a full scientific evaluation of data.

On receipt of data, and following conversion to the ICES format (which may
also create its own errors, the following rooutine steps are followed:


1. Validation of consistent record and station structure:

This is undertaken using utility ICESQC, and checks for the following:

a) illegal record types

b) illegal record lengths (must be 80)

c) values >=60 in all minutes fields

d) Ship speed checks - announces negative speed, suspect speeds (>20<40
knots), and gross speed error (>40 knots). This check requires that the
data set be time sorted by ship (using ICESORT). For this consistent
station numbering in a data set is encouraged as a redundant checking
parameter). THis procedure often reveals points on land, but is
double-checked using the STAPLOT, which produces a track chart.

e) decreasing depth of observations - often a sympton of the supplier
merging several stations under the one header, common if export from a
data base table.

f) Sounding < deepest observation depth. Assumes units are metres and
decibars respectively.

g) density instability (yet to be implemented). Other checks, such as
unrealistic oxygen saturation or also being considered

ICESQC produces an output file (.err) which is compatible with ICE-EDT.
Thus records failing the tests can be pointed to directly from ICESQC, and
the original data file (which is limited in size only by the available
disk space, can be corrected or flagged as necessary.

*************************************************************************
INDEX    	

Prepares index file of ICES data record. Use to speed up EXTRACT.

************************************************************************
NODC-ICE

Converts NODC formatted data files, to ICES format

   Almost all Oceanographic Station data are presently held in either
   the ICES or NODC formats - the current data sets go back to 1902,
   the date of the establishment of the Standard Seawater Service.

   The formats were devised in the early 1960s.  At that time US needs
   and ICES needs differed slightly, and as a result, although 
   structurally similar, the formats differ in both concept and
   parameters.

   It is intended that this utility be used in conjunction with the 
   sister utility <ICE-NODC>, which, as its name suggests, converts data
   files from ICES format to NODC's format.  This will allow the user
   to take advantage of various PC-based oceanographic data display
   products, eg ATLAST, and at the same take advantage of the wide
   range of interactive data management software provided by ICES, but
   which supports only the ICES format.
******************************************************************************
RECEXT   	

Extracts specified records from ICES data file, (Use information from
FISUM or STASUM

***************************************************************************
ROSIN    

      Welcome to ROSIN, the 'ROSCOP' form entry program. Your completed
      form will be stored in file(s) on your current directory one of
      which serves as input to ROSEARCH which is a retrieval program for ROSCOP.
      If you don't have a copy, ICES will be happy to send you one.
                          Some hints on how to use this program
      1......Start by looking at the various pages. These are accessible by
             pressing the function keys listed on the bottom line of each page
             Try the 4 cursor, and the home & end keys.
      2......Once you start entering information into a field you must complete
             your entry by pressing RETURN/ENTER. Until you do this you will find
             that the cursor and function keys (not F10) respond only with a BEEP!
      3......Corrections to your entries may be done using text editor facilities
             available from F5. Text strings of max length 79 may be entered.
             Use the editor if you wish to exceed the designated field length.
      4......When you have entered the cruise information you should make
             a backup of your file(s) and send a copy on diskette either directly
             to ICES or through your national data centre. If you send directly
             to ICES a hard copy of the information will be passed to your data
             centre and ICES will return your diskette with the latest ROSCOP 
             information.

*****************************************************************************
STAPLOT  

Plots station positions from ICES formatted file. You have to state
coordinate limits, and no warning given about points lying outside
Coastlines (see below) are produced by pressing space on completion
of station plotting, otherwise press <Esc> to leave program

Command line options:

? - information
<file> - give file name of a SURFER compatible coastline file.
(if no file name given, the file atlant.sur is assumed, and will
be utilised if present in the current directory.

***********************************************************************
STASUM 

Produces 2nd level inventory of ICES stations, and optionally
cruise summary and ROSEARCH readable file of cruise

Command line options

? - more info
0 - suppress ROSCOP summaries
number>0 - specifies inter-cruise gap (7 days assumed if not given)

***************************************************************************
TSLOOK

TSLOOK functions only on station data files in the ICES format
This must be available in your current directory
The following screen types are supported CGA/EGA/MCGA/VGA
If you have a HERCULES card, press 'H' on leaving this screen
You may also implement the Hercules option by returning to DOS
and typing TSLOOK H - be warned though, the Hercules option
has not yet been fully tested - contact ICES if you wish
a functional version to be developed

When running the program, you will notice that progress through
the data file is continuous. To stop on each station press the space
bar; press any other key to return to the default mode. 

The program produces three plots - x/y; pressure/x; and pressure/y
where x and y are a hydrochemistry pair eg t or S or PO4 or SIO3 etc

OPTIONS
Three options to running this program are available

1:The default option provides a view facility only. On start up just
locate,5:type TSLOOK (or leave this page by pressing 'any other key'.

2:When you start up by typing TSLOOK E (or leave this page by pressing 'E')
then, when plotting is completed, and <Esc> is pressed, a '+' appears on
on the left hand x/y picture.  This enables you, by means of the cursor
keys, to locate the actual record and station pertaining to any particular
plotted '.'  By pressing return, the record will then be stored in a file
with a .SUS extension. Pressing TAB stores the whole station

3:When you start up by typing TSLOOK S (or leave this page by pressing 'S')
the x,y page is immediately re-drawn. This enables you to re-examine the 
the plotted '.'s as in option 2.  To run this option requires a .STO file
produced by option 2.

NOTE!!

When exercising options 2 or 3 (TSLOOK E or TSLOOK S) memory limitations
dictate that the vertical resolution is reduced (to that of CGA).
.... Sorry, but good luck.  We hope you enjoy using this program

******************************************************************************
