Offset	Chan 2	Chan 4	Chan 6	Chan 7
ro=-10	R=0.00	R=0.00	R=10.00	R=1.00
go=-20	R=0.00	R=10.00	R=0.00	R=0.00
bo=-30	R=10.00	R=0.00	R=0.00	R=0.00

	Offset	K2	K5	K6
red	-30	0.00	0.00	0.30
green	-30	0.00	0.30	0.00
blue	-30	0.30	0.00	0.00

	K1	K2	K7	K9
red	-1.00	1.00	0.00	0.00
green	0.00	0.00	-1.80	4.50
blue	0.00	0.00	1.40	-2.00

channel	wavelength [nm]
1	402-422
2	433-453	blue=435
3	480-500
4	500-520
5	545-565	green=546
6	660-680	red=700
7	745-785
8	845-885

Time	Recording starts:
10	10 hour, today
10:10	10 hour 10 min today
10:10:10	10 hour 10 min 10 sec today
10:10:10 10	10 hour 10 min 10 sec 10th day of current month
10:10:10 10-10	10 hour 10 min 10 sec 10th day of october, current year
10:10 10-10-2001	10 hour 10 min 10th day of october, in year 2001
10:10 11:10	starttijd is 10:10 vandaag, stoptijd is 11:10 zelfde dag
10:10 10-10 11:10	starttime is 10:10 at oktober 10, stoptime is 11:10 at oktober 10
10:10 11:10 10-10	starttime is 10:10 today, stoptime is 11:10 oktober 10
10:10 10-10 11:10 11-10	starttime is 10:10 at oktober 10, stoptime is 11:10 at oktober 11

Manual HRPT version 2001.08.

Summary.

hrpt is the program which can be used, together with the hrpt-decoder, to receive and show the pictures It contains some features specific for weather satellite pictures, like linearize and computing/drawing longitude/lattitude lines.

Data is put into a database (10 bits per pixel for hrpt), which also contains things like record time, Kepler-data etc.

The program can translate pictures into the standard formats GIF and SUN, so other programs may be used to postprocess/view the pictures.

HRPT derivatives CHRPT and Seastar (if unencrypted) are also supported, but NOT the encrypted Seastar.

PDUS-data can also be recorded and manipulated. The program name is, therefore, maybe a bit misleading.

This manual gives a short overview of all functions. The first level menu (shown at the top) and second level menus do "work", that is, by clicking on items the related part in the manual is shown.

Installation.

There are up to 3 files to install:

hrpt.exe: The program

hrptpref.ini: preferences. This file is generated the first time that settings are changed/saved; see menu Edit -> Preferences.
SVGA-driver (e.g. svga256.bgi): Driver for SVGA mode. Best is to use the Borland driver which comes (hopely) with the graphical card. If this file is not available the file 'svga256.bgi', which comes with the hrpt.exe program, can be used. In most cases this driver works fine in combination with most cards, if the lowest resolution (640x480, 256 colors) is used.
This driver is not needed if VGA or VESA-mode is used.

In case of a new version just hrpt.exe has to be replaced.

Location installation.

hrpt.exe
Best is in a special directory which already contains other programs and to which a path is defined.
hrptpref.ini
Program location, or in c:\inithrpt.
SVGA-driver (e.g.. svga256.bgi)
Same.

If hrpt is started the hrptpref.ini is searched in:

. (current directory) If this location doesn't contain a hrptpref.ini then:
c:\inithrpt or
program location.

If no hrptpref.ini is found the default settings are used.

Location and name of the SVGA driver can be defined in hrptpref.ini. If hrptpref.ini is not found the program searches in the following locations for the driver svga256.bgi:

Program location.

Start-options.

From a DOS-window start with:
hrpt
Or:
hrpt file_name here is file_name is an existing file in format supported by the programma (eg. GIF); the picture is shown immediately.
Options:

-rec 245h

start program in HRPT record-mode. First incoming signal will be recorded; at the end record stops and programma is aborted. Channels 2, 4, 5 and H will be recorded. (This may be any combination of channels.)

-rec_c 279h

Same, but chrpt. Channels 2, 7, 9 and H will be recorded. (Note that with CHRPT only pairs of channels can be choosen for record; so specifying channel 2 means that also channel 1 will be recorded; specifying channel 9 means that also channel 10 will be recorded, etc.)

-rec_s

Same, for Seastar. (No channel selection possible.)

-rec_p

Same, for PDUS. (No channel selection possible.)

time-out

-f [filter]

Gives overview of all readable HRPT files in current dir. A filter may be specified (e.g. *.dat). If a filename is specified (e.g. "hrpt -f hrpt1.dat") then a more detailled overview is given for this file.

-t

Show all specified recordtimes.(See also Record modes.)

-i

Change "preferences" file. (See also Edit->Preferences.)

-h

help

-v

print version

Mouse keys:

Key	Action	Comment
left	select
right	abort
middle	activate	If submenu is active; alternative: Press return
middle	Coordinates	If submenu is NOT active; alternative: Press: TAB

This is the main menu:

Menu: File.

Open.

Open a file. Pre-selection by means of wild cards is possible.

Type after Select filename, directory and/or drive, e.g.:

Content of drive E: is shown.

WEDER\

Content of directory WEDER is shown.

hrpt1.dat

This file will be opened.

Or:

Click on the desired filename or (in red) directory
Scrol by clicking on the arrows right.
Pre-selection is possible:
- Click on 'Auto' -> only files with recognized format will be shown. The letter behind each name shows the file type:
  h = hrpt
  z = Seawifs
  p = pdus
  g = GIF
  s = SUN
  Enter a filter, e.g.:
  Filter: hrpt*.dat
  shows all files starting with 'hrpt' and extension '.dat'.

Click on 'Accept', or click with middle mousekey, to show the selected file. The first recorded channel will be shown.

Choose in the main menu the desired channel. The numbers of not-recorded channels are shown in grey (not selectable).

File mngr

To do a few simple file-manipulations:

Delete:
- Type filename, or click on 'list' and select file.
- Click on 'delete'.
Rename:
- Type filename, or click on 'list' and select file.
- Type new filenaam in after 'Rename to:.
- Click on 'Rename'.

Save as...

Pictures can be translated in severable formats, complete or zoomed. If button "Datamap" is activated the luminance as defined at Grmap->Data-map will be taken into account. The picture will look like the picture on screen. If Datamap is not activated the brightness and contrast of the translated picture will not be the same as the original, but after manipulation it should be possible to get the same picture. The part of the picture shown on the screen will be saved, but the resolution of the screen doesn't influence the copy (this is not a screendump!
Supported formats are:

10B:
PDUS
GIF
SUN

Best is to leave HRPT-pictures in the 10B-format; translate to GIF only if you want to use it with another program.

Settings are default:

Translate to the same format
Save only the channel selected in the main menu
Translate from 10 bits to 8 bits in such a way that the grey tints as shown on the screen will be translated in the most optimum way.

How to use:

Enter filename.
Select the desired format.
Select channel. If you translate to 10B-format you can select several channels. Best is to select also always the frame-header (H) (containing all transmitted non-picture data); the filesize will increase max. ca. 45% (1 channel saved) and minimum 8.5% (5 channels saved).

Translating from 10B to GIF or SUN-format means that you have to choose which 8 of the 10 databits will be saved. (Note: In the documentation of the HRPT format bits are numbered 1 to 10; bit 1 is MSB and bit 10 LSB. This definition is also used here.)
The following 2 figures determine the translation:

MSB: 1, 2 or 3
Lmin: Minimal luminance, >= 0

All luminances outside the range will be mapped to minimal or maximum luminance.
E.g.: MSB=2, Lmin=64 means the range 511 ... 64 (448 values) will be mapped to 255 ... 0.
All values smaller than 64 will be translated to 0.
All values larger than 512 will be translated to 255.
Following table shows some examples:

MSB	Lmin	Used range original	"resolution"
1	0	0 ... 1023	4 -> 1
1	768	768 ... 1023	1 -> 1
2	0	0 ... 512	2 -> 1
2	256	256 ... 512	1 -> 1
3	0	0 ... 256	1 -> 1

As said the 2 numbers are calculated from the result on the screen (see: Grmap). If needed you can change them before saving. Hint: To save as much info as possible, try to get the range width to 256, so:

MSB=1 / Lmin=768 or
MSB=2 / Lmin=256 or
MSB=3 / Lmin=0

Screendump

To get a real screendump in GIF, SUN or TIF format. Everything on the screen, except the main menu, is saved, so also drawn longitudes/lattitudes.
GIF and SUN are 8 bits formats; TIF is 24-bits per pixel format (true color).
The result is saved in file scrndmp#.gif, scrndmp#.sun or scrndmp#.tif resp. Existing files are not overwritten; '#' is a number which is choosen such that the file to generate doesn't exist.
Note that the resolutiuon now depends on the graphical resolution!

Quit

Exit the program.

Menu: Edit.

Save/Load header info.

To read/write certain header-information.

10B-format:
- Satellite direction may be changed. First select the right direction in the main menu (so the picture is not upside-down) (plotmode). Now click on: 'Sat direction N->S'. (If selected direction is already saved then the button shows 'Sat direction ok', and is inactive.)
- Save d_afb: Data-mapping (as defined with Grmap -> Data-map) may be saved and reloaded, separately for each channel.
- Save rgb: RGB settings as selected in Plotmode->Algorithm" may be saved and reloaded.
- Sat name: Change satellite name.
Now click on 'Save selected items'.
GIF and SUN:
- Save or reload palette.

Change Kepler time.

To calculate the longitude/latitude the record starttime is needed. Following times can be used:

The satellitetime, present in the transmitted HRPT-data (only if the frame-header is also recorded)
The computertime, if the frame-header not is recorded.
Choose the desired source by clicking in the rectangle left of Time sat : or Time comp:.

Satellite time:: For each new record the time has to be extracted 1 time. Choose: 'Search time->'
If the shown time looks unreliable (data error), click again to search again, lateron in the file. The extracted time will be translated to the actual starting time.

NOTE: NOAA doesn't transmit the year. Therefore, the computer-clock will be used to get the year! This fails if the 'computer-year' is not equal to the UTC-year at the moment recording starts (e.g. 1 januar, between midnight and 1 o'clock, if computertime is MET!)
At: 'Offset lon=' a longitude-correction can be entered. This shifts the raster in east<->west direction.
Computertime:: Use only if the satellitetime is not available. For longitude/lattitude calculation UTC time is needed; if computertime is on MET Offset GMT= should be:
-1 (wintertime) of
-2 (day-light saving time).

A small correction can be entered at: Offset sec= (maximum: +127/-128 secondes = +2 min 7 sec/- 2 min 8 sec.)
A larger correction can be established in the rectangle containing the total time; here, the saved computertime can be changed directly. Write down the original time before changing, so you can restore it if needed!
How to change this time:

Click in the rectangle, now an arrow is shown up under the time.
Move the arrow till it is under the number to be altered, by means of the cursor keys '</>'.
Increment/decrement the number by means of the cursokeys '^/v'.

Choose: "Save" to save extracted time, corrections and the choice 'computertime' versus 'satellitetime' into the HRPT-file.
Note: Results of changes can be shown, before doing the actual 'Save', by redrawing the picture (Plot).

Change Kepler data.

To calculate longitudes/latitudes Kepler-data is needed. The program can read directly the wel-known 'NASA 2-line' format.

Choose the Kepler-file:
- Change if necessary the directory at: Kepler-dir
- Type filename in at: Kepler-file
- Or: click on List and select the file with the mouse.
Choose satellite:
- Type satellietname at: Sat-name.
- Or: Click on List and select the satellite.
- Read the Kepler-data:
- Click on Use kepler-data to test the new data without saving.
- Click on Save kepler-data to save the new data into the (C)HRPT-file.

Before reading in the new data first the difference between time of Kepler-data and recordtime is shown. Also the difference between time of current Kepler-data present in de file and recordtime is shown, so you can see which kepler-data is better before doing a save.

Note:

The transmitted data contains a code showing which NOAA was recorded. If the frame-header (H) was also recorded, and if the code is recognized by the program, the right NOAA name is already filled in at "Sat-name". But:
The satellitename must exactly match the name in the Kepler-file, including spaces and case.
Use at List the filter to reduce the amount of shown satellites, e.g..: NOAA* to show only the satellites with names starting with NOAA.

NOAA->SeaWifs.

If a Seastar satellite is recorded in NOAA-format or vice versa you can correct this afterwards. The effect of a wrong recorded file is vertical bars in the picture.
This change will be saved at Save/Load header info.

Preferences.

All kinds of settings can be saved in a preference file, like graphical mode. The name of this file is hrptpref.ini.
How to use: Select left a item, change right.

Graphics
More settings:
- File names.
  - File names are deterimined automatic:
    - for HRPT: hrpt1.dat, hrpt2.dat etc.
    - for PDUS: pdus1.dat, pdus2.dat etc.
    - for Seawif: seaw1.dat, seaw2.dat etc.
    Existing files will never be overwritten. If needed you can change the filename afterwards (see:
    File manager, or just in DOS using 'rename').
  - Save directly to right file: click on 'Auto'; dit becomes: 'Manual'.
    Fill in after: 'File:' the filename.
  - Dont't save, only show picture on screen: Click on: 'Save in file'. Dit turns into: 'Don't save'.
    (Make sure that 'Plot during rec' is active, otherwise you will not see any result.)

Menu: Plotmode.

Satellite direction.
- Choose: Plotmode -> From south->From north
- or : Plotmode -> From north->From south to define the satellite direction (that is, to correct if the picture is upside down).
linearise X-direction.
- Choose: Plotmode -> linearise
The resolution of the picture is higher in the middle, lower at the edges, resulting in a stredged picture in the middle. This is corrected by means of 'Linearise'.
Smooth: remove rectangle blocks.
- Choose: Plotmode -> Middle
If you zoom in far (dx/dy > 1) the picture shows 'blocks'. This effect is removed by means of interpolation.
Despicle.
- Choose: Plotmode -> Despicle
Spicles caused by bit-errors are removed.
Correct faulty lines.
- Choose: Plotmode -> Correct
If during record the decoder is out-sync for a short while the picture shows horizontal lines. This function replaces the faulty lines by correct neighbours. (Only works on the screen, the original is not changed). This is possible because the in-syncstate of the decoder is also recorded, for each frame.
Detect contours.
- Choose: Plotmode -> Edge
Edges between land and sea will be drawn. Play with the valuses in Grmap to get bright edges. You can define a threshold with 'L edge'; the data value of one of the sides of the edge has to be under this value to make the edge vissible a that point. In this way "noise" can be suppresed, so nearly only land-sea contours will remain.
Saving contours to a file.
Only with 10B-files; Kepler-data have to be available.
- Choose: Plotmode -> Make map...
- Change filename if needed.
- Click on Activ.
The Contour-mode will be activated. make sure that contours are as bright as possible. Click now somewwhere on the contour. The contour will now be followed and colored; the longitude and lattitudes of all points are saved. Click at points not colored yet. Now choose:
- Plotmode -> Make map...
- Click again on Activ to deactivate this mode.
Note: This works only if the edges are much brighter than the surrounding. A cloud against the contour to be saved will give problems.
Overlay of contours in a picture.
Only with 10B-files; Kepler-data must be available.
- Choose: Plotmode -> Draw map...
- Change filename if needed.
- Click on Activ.
Now, contours as saved by means of Make map (generated with another picture) will be drawn. In this way land-sea boundaries can be made vissible in a picture with heavy clouds. See appendix for the format of this file.
Adding grid (land countours) (PDUS only).
- Choose: Plotmode -> Grid
The land contours are transmitted together with PDUS.
Draw Longitude/lattitude lines.
- Choose: Plotmode -> Raster
Only with 10B-files. If Keplerdata is available a lon/lat raster will be drawn. Depending on how far is zoomed in lines will be drawn every 5 degrees, every 2 degrees or at each degree.

Menu: Plot.

Keyboard equivalent: s

Menu: 1, 2 ...

Choose a channel to show.

Appendix. Format contourfile.

NEW
{lon 1} {lat 1}
{lon 2} {lat 2}
...
NEW
{lon 1} {lat 1}
{lon 2} {lat 2}
...

Lines will be drawn between successive lon/lat pairs. After 'NEW' a new line is In this way you can make the contourfile by hand (this is a lot of work!). Or you can make corrections in a automatic generated contourfile.
Note: Everything after # of -- is comment.
Example:

#England
-5.5	50
1.5	51.2
1.8	52.7
0.5	53.1
-2.8	56.3
-1.8	57.7
-4	57.7
-3	58.6
-5	58.7
-7	56
-3	53.5
-4.8	53.5
-5.5	50
NEW
# Spain
-5.5	36	-- street of gibraltar
-6.5	37
-9	37
-8.8	38.5
-9.5	38.7
-8.7	41
-9.1	43
-8	43.6
-1.8	43.2	-- pyreneen, west
# France
-1	46
-4.8	48
-4.9	48.6
-3	48.8
-1.5	48.7
-2	49.7
0	49.5	-- le havre
1.2	50
1.5	50.8
2.5	51
# Belgium
3.2	51.2
# the Netherlands
4.1	52
4.7	52.9
5	53.2
6	53.5

*Direct (Now).*	Record starts immediately after clicking Start. Hit an arbitrary key to stop recording.
*One picture (Next).*	After Start the program waits until the first non-encrypted picture; this will be recorded.
*All pictures (All).*	All non-encrypted pictures are recorded. Hit an arbitrary key to stop this endless loop.
*On certain times (Time).*	Record times are specified in a file. This file is read after clicking on Start and the first record time will be catched. Now the program waits until this time; after that, the first non-encrypted picture is recorded. (So, actual recordtime could be (much) later than specified time!) Now the file is read again and the next time is catched. This procedure stops if there are no times in de future anymore.

Manual HRPT version 2001.08.

Summary.

Installation.

Location installation.

hrpt.exe

hrptpref.ini

SVGA-driver (e.g.. svga256.bgi)

Start-options.

Menu: File.

Open.

File mngr

Save as...

Screendump

Quit

Menu: Edit.

Save/Load header info.

Change Kepler time.

Change Kepler data.

NOAA->SeaWifs.

Preferences.

Menu: Grmap.

Luminance: Data-map...

Screen-map... (palet)

Linear combination of several channels: Algorithm...

Inverting the luminance: Normal -> Invert

Load standard palet

Map to total palet.

Zoomen.

Menu: Zoom.

Zoom in... (z)

Zoom out

Zoom pre.

dy=dx (c)

dx=dy (C)

Zoom val...

Menu: Record.

Record modes.

File with record times.

Menu: Plotmode.

Menu: Plot.

Menu: 1, 2 ...

Appendix. Format contourfile.