@database DigitalAlmanac.guide

@$VER: DigitalAlmanac.guide 39.9

@node "main"
@title "Digital Almanac V39.9"

         @{u}@{b}@{i}Welcome to Digital Almanac V39.9@{uu}@{ub}@{ui}

Please read the chapters marked with an asterisk, because they contain
important information to ensure a safe working on your Amiga !!


              @{"   Copyright   " link "Copyright"}

              @{" Registration  " link "Registrierung"}

              @{" Requirements  " link "Vorraussetzungen"} **

              @{" Introduction  " link "Einführung"}

              @{" Installation  " link "Installation"} **

              @{" Start program " link "Programmstart"} **

              @{"  Description  " link "Beschreibung"}

              @{"Picture support" link "Picturesupport"}

              @{"    History    " link "Geschichte"}

              @{"Known problems " link "Probleme"} **

              @{"      FAQ      " link "FAQ"}

              @{"     Future    " link "Zukunft"}

              @{"   Thanks to   " link "Danke"}

              @{"     Author    " link "Autor"}

              @{"   Internet    " link "Internet"}
@endnode

@node "Copyright"
@title "Copyright"

@{b}Digital Almanac V39.9  © 1997 by Achim Stegemann@{ub}

* Digital Almanac is shareware.

* Digital Almanac consists of two archives,
  the main archive DAlmanac_Exe.lha und the data archive DAlmanac_Data.lha.
  These archives may be freely copied and spread.
  No file may be changed or left !
  No costs may be raised except costs for materials like disks or CD's !!

* If you like to use the program, please register.

* Every comment, critics, suggestion, bug report o.a. is welcome !
  This helps me, to correct and to improve the program in the future. :-)

* The program uses @{"MUI" link "Copyright-MUI"}.

* All other trademarks named are copyrighted by the corresponding owner.

* @{b}THE AUTHOR OF DIGITAL ALMANAC IS NOT RESPONSIBLE FOR ANY EVENT THAT IS
  CAUSED DIRECTLY OR INDIRECTLY BY USING THIS PROGRAM !!
@endnode

@node "Copyright-MUI"
@title"Copyright MUI"

                        MUI - MagicUserInterface

                (c) Copyright 1993/94 by Stefan Stuntz


MUI is a system to generate and maintain graphical user interfaces. With
the  aid  of  a  preferences program, the user of an application has the
ability to customize the outfit according to his personal taste.

MUI is distributed as shareware. To obtain a complete package containing
lots of examples and more information about registration please look for
a  file  called  "muiXXusr.lha"  (XX means the latest version number) on
your local bulletin boards or on public domain disks.

          If you want to register directly, feel free to send


                         DM 30.-  or  US$ 20.-

                                  to

                             Stefan Stuntz
                        Eduard-Spranger-Straße 7
                             80935 München
                                GERMANY
@endnode

@node "Registrierung" 
@title "Registration"

If you like the program and want to continue using it, you can register at
@{"me" link "Autor"}.

The shareware fee is DM 30.- or US$ 20.- (cash or remittance).

When you have remitted the fee, you will receive a keyfile, which disables all the
restrictions. This keyfile is valid for all following versions (no updates needed !!).

Don't forget to specify your name, address (and phone number) on the remittance !!.


@{b}@{u}Restrictions of the unregistered version:@{ub}@{uu}
* All saving functions are disabled.
* No hardcopy.
* No changing site to a different planet, only Earth enabled.
* No detailed course of eclipses.
* No picture galery.
* Plotting stars only to 6m.
* Plotting other objects only to 15m.
* No changing of pixelsize.
* No events in the calendar.
* The program will terminate after ca. 20 min and all 5 min a requester will appear.
@endnode

@node "Vorraussetzungen"
@title "Requirements"

@{b}@{u}Minimum system configuration:@{ub}@{uu}

* OS 3.0 (V39) + AGA
* MC68020/68881
* 2 MB ChipRAM, 8 MB FastRAM
* Harddrive (11 MB free diskspace)
* MUI 3.6


@{b}@{u}Recommended system configuration:@{ub}@{uu}

* OS 3.1 (V40)
* MC68040 or MC68060
* 16 MB FastRAM
* CyberGraphX V2.25+ (=V40.113) or V3.x
* MUI 3.8


@{b}The main program requires the unpacked data archive 'DAlmanac_Data.lha'
of version 39.5@{ub}
@endnode

@node "Einführung"
@title "Introduction"

Digital Almanac is an astronomy program which offers lots of possibilities.
The program is permanantly improved, so that new versions are at your disposal.

@{b}Digital Almanac offers{ub}

* Complete SAO star catalog (258998 stars).
* Complete Messier and NGC-Catalog (ca. 8000 deep-sky objects).
* IC-Catalog (ca. 5000 objects).
* Other 2000 deep-sky objects from different catalogs.
* About 35000 minor planets and asteroids as well as the
  Comets Halley, Hyakutake and Hale-Bopp.
* Highly accurate calculation of Moon and planets with JPL's
  integration tables (DE404).
  (Accuracy partly <0.1'' over a period of some thound years !!).
* Textures for five planets.
* Moons of Jupiter and Saturn.
* Milky way structure.
* View the sky from any solar system object.
* Animation mode (also saving in IFF-ANIM format !!).
* Loading and saving of configuration files.
* Highly optimized algorithms for maximum speed, mostly written in assembler.
* Lots of configuration possibilities.
* Online and menu help with HELP-key and MUI's bubblehelp.
* Printing of ephemeris tables.
* CyberGfx High- and Truecolor mode support.
* Picture galery creation.
* User editable database with orbital elements.
@endnode

@node "Installation"
@title "Installation"

Start the installer script and follow the instructions.

@{b}Important:
To run Digital Almanac, you require the main and the data archive !!@{ub}

Digital Almanac also requires asyncio.library V39.0, which is included
in the archive as V39.2.
If you have an older (or no) version, the library will automatically be copied
to you SYS:Libs drawer.

To have the correct font in some requesters, please follow these steps:
* Start Digital Almanac.
* Click the corresponding MUI gadget or menu item for the local MUI settings
  for Digital Almanac from any window.
  Do not start MUI preferences manually !!
* Select "Windows" in the MUI preferences.
* Type "Astro/11" in Fonts/Normal.
* Save these prefs.

Digital Almanac will now use the Astro font in some error requesters.
The global MUI prefs will not be affected !
MUI preferences will create the file in the "ENVARC:MUI/DIGITALALMANAC.prefs".

@{b}@{u}VERY IMPORTANT:@{uu}
It is absolutely necessary to set the flag "Windows/Refresh" in the MUI preferences
to "Smart". Otherwise it is possible, that Digital Almanac refuses to work with your
selected menuitems. On the other hand you avoid timeconsuming window refreshing
whenever mui feels to update the windows !!
@endnode

@node "Programmstart"
@title "Start program"

From @{b}CLI@{ub}:

@{i}Template:@{ui} DigitalAlmanac FILE,HOMENAME=HN/K,HOMECOORDS=HC/K,
          ACACHE=AC/K/N,SCACHE=SC/K/N,XPK/K,
          NOASTEROIDS=NA/S,NOOBJECTS=NO/S,NOTEXTURES=NT/S,NOINTRO=NI/S,
          SCREENMODEREQUESTER=SMR/S,LIKEWB/S


From @{b}Workbench@{ub}:

@{i}Tooltypes:@{ui}
* HOMENAME=Name of City
* HOMECOORDS=Latt. Long. Alt.
* ACACHE=#Number of asteroids
* SCACHE=#Number of stars
* XPK=Xpk-PackerID
* NOASTEROIDS
* NOOBJECTS
* NOTEXTURES
* NOINTRO
* LIKEWB
* SCREENMODEREQUESTER


@{b}FILE:@{ub} (CLI only)
Name of a config file to be loaded at program startup.

@{b}HOMENAME:@{ub}
Enter the name of observing point.
Example: New York

@{b}HOMECOORDS:@{ub}
Enter the lattitude, longitude in degrees and your altitude in metre.
Example: 34.5 -64.2 123
@{b}If you start the program from CLI, set the input string in quotes !@{ub}

@{b}ACACHE:@{ub}
Set the size of cache memory for the asteroids catalog.
This size should be between 1000 and 35066. Values outside these ranges will
be adapted.
The default size are 3000 asteroids.
If you have enough memory, you can set the cache size to 35066
(max. number of asteroids). The whole catalog will be loaded into memory and all
further disk activities will be avoided.
Each cache entry needs 56 bytes !

@{b}SCACHE:@{ub}
Set the size of cache memory for the SAO catalog.
This size should be between 1000 and 258998. Values outside these ranges will
be adapted.
The default size are 10000 stars.
If you have enough memory, you can set the cache size to 258998
(max. number of stars). The whole catalog will be loaded into memory and all
further disk activities will be avoided.
Each cache entry needs 16 bytes !

@{b}XPK:@{ub}
To save a picture in the IFF-RGFX format with Xpk compression, you need the ID of
an Xpk-Sublibrary. This gives you the default setting.
Default is NUKE.

@{b}NOASTEROIDS:@{ub}
Avoid loading of the asteroid data files. Saves about 1 MB of memory.

@{b}NOOBJECTS:@{ub}
Avoid loading of the deep-sky object data files. Saves about 1 MB of memory.

@{b}NOTEXTURES:@{ub}
Avoid loading of the textures. Saves about 1 MB of memory.

@{b}NOINTRO:@{ub}
Do not display intro picture during startup.

@{b}SCREENMODEREQUESTER:@{ub}
Opens a requester where you can select the screen mode at startup.
This flag overrides LIKEWB !

@{b}LIKEWB:@{ub}
Opens a screen for Digital Almanac with the Workbench's screen mode.
If this flag is deactivated, it tries to open an 800x600 or 640x480 screen.
@endnode

@node "Beschreibung"
@title "Description"

The program is mostly self explaining. If you have used some other astronomy
software in the past, you should have no difficulties using this program.

Lots of gadgets have bubblehelp.

Online and menu help is available !

@{b}Important:@{ub}
This guide is not ment to be an astronomical encyclopedia. It is designed to give
you brief description of how to use Digital Almanac. If you have difficulties to
understand some specific expressions, you should look them up in a book !


            @{b}@{u}Menus@{ub}@{uu}

            @{"   Project   " link "Menü-Projekt"}
            @{"Configuration" link "Menü-Konfiguration"}
            @{"     Map     " link "Menü-Karte"}


            @{b}@{u}Project@{ub}@{uu}

            @{"Colors" link "Projekt-Farben"}
            @{"Export" link "Projekt-Export"}


            @{b}@{u}Windows@{ub}@{uu}

            @{"  Preferences   " link "Fenster-Einstellungen"}
            @{"  Coordinates   " link "Fenster-Koordinaten"}
            @{"   Telescope    " link "Fenster-Teleskop"}
            @{"   Animation    " link "Fenster-Animation"}
            @{"  Solar system  " link "Fenster-SMP"}
            @{"   Asteroids    " link "Fenster-Asteroide"}
            @{"     Stars      " link "Fenster-Sterne"}
            @{"    Objects     " link "Fenster-Objekte"}
            @{"Orbital elements" link "Fenster-Orbit"}


            @{b}@{u}Extras@{ub}@{uu}

            @{"  Calendar   " link "Extras-Kalender"}
            @{"Solar eclipse" link "Extras-Sonnenfinsternis"}
            @{"Lunar eclipse" link "Extras-Mondfinsternis"}
@endnode

@node "Menü-Projekt"
@title "Menu/Project"

@{b}@{u}MUI-Settings@{ub}@{uu}

Opens the MUI-Prefs program to adjust the local MUI-Settings of Digital Almanac.


@{b}@{u}Colors@{ub}@{uu}

Opens a window where you can adjust the most important system colors.


@{b}@{u}Save map as@{ub}@{uu}

* @{b}ILBM:@{ub} Saves the main window as an IFF-ILBM file.
  If the icon "ENV:Sys/def_ILBM.info" exists, it will be added to the picture.

* @{b}RGFX:@{ub} Saves the main window as an IFF-RGFX file.
  If the icon "ENV:Sys/def_RGFX.info" exists, it will be added to the picture.
  @{b}Important:@{ub} To use the Xpk support of the new IFF-RGFX format, you
  require the xpkmaster.library V2 or better.
  You can find a datatype for this new format in Aminet:util/dtype/RGFX_DT.lha
  More information in Aminet:dev/misc/IFF-RGFX.lha

* @{b}JPEG:@{ub} Saves the main window as a JPEG file, if you have opened a true- or
  highcolor screen. However, this is not recommended.
  If the icon "ENV:Sys/def_JPEG.info" exists, it will be added to the picture.
  @{b}Important:@{ub} To save a JPEG file, you require the installed Tower-System
  by Christoph Feck, which is available on the Aminet.


@{b}@{u}Hardcopy@{ub}@{uu}

Here you can print the contents of the main window !

@{b}There are some restrictions caused by bad programming of the printer.device !@{ub}

* CyberGfx screens cannot be printed, because the printer.device does not
  support neither High- nor Truecolor modes, and Bitmaps lying in Fast-RAM
  also cannot be printed.

* The picture will always be printed negative, centered and with full size and
  maximum density for highest resolution.

* To avoid loosing darker pixels, it is recommended, to set all colors to white
  and to set the darkest pen to 0

* You should deactivate textures and the milky way.

A support for TurboPrint V3 or higher is planned for the future.

@{b}Remember: At the moment only AGA screens can be printed !!@{ub}
@endnode

@node "Menü-Karte"
@title "Menu/Map"

@{b}@{u}Planetarium@{ub}@{uu}

Draws the map in the RA/Dec system.


@{b}@{u}Local sky@{ub}@{uu}

Draws the map in the Aziuth/Altitude system.


@{b}@{u}Redraw@{ub}@{uu}

Redraws the map after in the current mode.


@{b}@{u}System time@{ub}@{uu}

Updates time to current system time and redraws the map.


@{b}@{u}Direction@{ub}@{uu}

Move the telescope to a direction.
@endnode

@node "Menü-Konfiguration"
@title "Menu/Configuration"

@{b}@{u}Load@{ub}@{uu}

Loads a configuration file.


@{b}@{u}Save as@{ub}@{uu}

Saves the current configuration.
The icon "Icons/Project.info" will be saved with the configuration !
You can replace this icon by a differnt icon of your choice.
@endnode

@node "Projekt-Farben"
@title "Project/Colors"

Change the colors of some drawing modes.
@endnode

@node "Projekt-Export"
@title "Project/Export"

In this window you find all parameters you need to create an ephemeris table.

* Select your starting parameter (place, time) in the window 'Coordinates' and the
  calculation parameters in the window 'Preferences/Accuracy'.
* Choose an object you want an ephemeris table from the top cycle gadget.
* Choose the output mode (printer or file).
* Select the stepsize and the number of outputs.
* Open the corresponding window for the object of your choice.
* Drag the object with the mouse to the text field of the export window.


With the help of the two lists, you tell the program, what datas you want to be calculated.

Choose an item in the left list and drag it with the mouse to a position of your choice
to the right list.
Multiselection is supported.
Double inputs will be ignored !

To swap an item within the right list, just drag it to a different position.
Only the active item is swapped.

To delete an item from the right list, drag it back to the left list.
Multiselection is supported.


Press the 'Start' button to begin calculation.
The datas will be printed according the order in the right list !
If calculation does not start, check your inputs (empty list, missing filename etc. ?).


@{b}Important:@{ub}

1. To get a formated printer output, you must set a nonproportional font on your printer !

2. At the moment all outputs refer to Earth as observing site !!
@endnode

@node "Fenster-Einstellungen"
@title "Window/Preferences"

In this window you can change the most important options of Digital Almanac.


The window is divided into three pages:

1. @{"Display and details" link "Einstellungen-AD"}

2. @{"Objects" link "Einstellungen-Obj"}

3. @{"Magnitudes" link "Einstellungen-Hell"}
@endnode

@node "Einstellungen-AD"
@title "Prefs/Display and details"

@{b}@{u}1.1 Objekts@{ub}@{uu}

(De-)Activate one of the different categories of objects.


@{b}@{u}1.2 Accuracy@{ub}@{uu}

Select the accuracy of calculation.

@{i}Geocentric parallax:@{ui}
Difference between a geocentric (in the centre of the Earth) and a topocentric
(on the Earth's surface) observer.
Important for Moon (up to 0.5° difference) and near planets.

@{i}Refraction:@{ui}
Effect caused by the atmosphere at lower heights.
Important for calculation of rises and sets (some minutes difference !).

@{i}Precession:@{ui}
Difference of coordinates caused by the Earth axis.
If this option is disabled, all calculations are referred to the equinox J2000.0.
Important for comparison of tables of eohemeris or star maps.

@{i}Nutation:@{ui}
Second effect caused by the Earth axis.
Small effect (some arcseconds).

@{i}Proper motion:@{ui}
Consideration of proper motion of the stars.
Very small effect. Use only during long time periods.

@{i}Planetary aberration:@{ui}
Difference of the position of a planet caused by the time travelling
from a planet to Earth.
Important during calculations of eclipses or observing details on a
planet's surface (deviation of some arcminutes).

@{i}Stellar aberration:@{ui}
Deviation caused by Earth orbiting around the Sun.
Small effect (max. 20").

@{i}Daily aberration:@{ui}
Deviation caused by the rotation of the Earth.
Very small effect (max. 0.3").

@{b}Remark:@{ub}
These options have no influence on the calculation in the calendar or eclipse mode !!
They also don't make sense, when you have selected a site outside Earth. All coordinates
are then calculated for the equinox J2000.0.


@{b}@{u}1.3 Display@{ub}@{uu}

@{i}Map:@{ui}
Choose between planetarium and local sky.

@{i}Projection:@{ui}
The map will be either displayed as on an area or on a sphere.

@{i}Magnitude:@{ui}
In the mode 'Graylevel' all objects will be displayed in different graylevels.
In the mode 'Dotsize', bright objects will be additionally enlarged (like in many star maps).

@{i}Date:@{ui}
Put the date, local, universal und sidereal time in the upper left corner.

@{i}Night palette@{ui}:
Switch between normal and night colors.
@{b}Important:@{ub} The restoring of the colors to the normal mode is bit buggy !


@{b}@{u}1.4 Grid@{ub}@{uu}

@{i}Kind:@{ui}
Choice of some different coordinte grids.

@{i}Draw as:@{ui}
Display either as dots or as a line.

@{i}Distance:@{ui}
Distance between grid lines in degree,

@{i}Step:@{ui}
Increment in degree.
1 = slow, but accurate  ->  90 = very fast, but inaccurate
@endnode

@node "Einstellungen-Obj"
@title "Prefs/Objects"

@{b}@{u}2.1 Solar system@{ub}@{uu}

@{i}Planetname / Asteroidname:@{ui}
Kind of name.

@{i}Show phase:@{ui}
Draw phase of moons and planets.

@{i}Show grid:@{ui}
Draw a planetographic coordinate grid.

@{i}Texture:@{ui}
Show planets with a surface texture.

@{i}Autozoom:@{ui}
Enlarge a selected object when centering.


@{b}@{u}2.2 Constellations@{ub}@{uu}

@{i}Lines:@{ui}
Draw constellation figures.

@{i}Limits:@{ui}
Draw constellation borders.

@{i}Names:@{ui}
Choice of language.


@{b}@{u}2.3 Stars@{ub}@{uu}

@{i}Names:@{ui}
Draw names of stars.

@{i}Symbol:@{ui}
Draw greek letter of stars.

@{i}Flamsteed:@{ui}
Draw Flamsteed number of stars.


@{b}@{u}2.4 Deep-Sky Objectnames@{ub}@{uu}

@{i}Messier / NGC /IC / Other:@{ui}
Draw objectnames from the catalogs.

@{i}Mark:@{ui}
Simple:  The object will be marked with a little cross and its size in the sky will
         be displayed.
Picture: Since V39.9 you can fill the sky area of an object with its picture from your
         galery. When using an 8-bit screen, areas are displayed only grey-leveled.
@endnode

@node "Einstellungen-Hell"
@title "Prefs/Magnitutes"

@{i}Min. mag. stars:@{ui}
Minimum magnitude for the SAO catalog.

@{i}Min. mag. Objects:@{ui}
Minimum magnitude for planets, asteroids and deep-sky object catalogs.

@{i}Darkest pen:@{ui}
Darkest colors that is used during drawing.
Serves to make dark object more visible.

@{i}Dotsize factor:@{ui}
Only influences the option 'Dotsize' !
The larger the factor, the brighter a star must be to be displayed as a little disk.

Note: When zooming at an object, the brighter the object will be !
@endnode

@node "Fenster-Koordinaten"
@title "Window/Coordinates"

Input of place, time and environmental parameters of the observer.


@{b}How to change my observing site ?@{ub}

* Open one of the windows @{"Solar system" link "Fenster-SMP"}, @{"Asteroids" link "Fenster-Asteoide"} or @{"Orbital elements" link "Fenster-Orbit"}
  and drag an object to the text field.


@{b}How to handle different places ?@{ub}

* Enter your geogr. lattitude, longitude etc. in the left column.
* Press the 'Add' button.
  The paramters from the left side will be added to the list.
* To save the list, press the 'Save' button.
  The list will be saved as 'Data/place.data'.
* To delete an entry from the list, press the 'Del' button.
  The currently activated entry will be deleted.
* The list is always sorted in alphabetical order.
@endnode

@node "Fenster-Teleskop"
@title "Window/Telescope"

Moving of the telescope.
Shows the coordinates of the screen's center nd the angle of the field of view.

@{b}Note:@{ub}
The modes 'Planetarium' und 'Local sky' have their own telescope !
Changing from one mode to the other won't transform the centering coordinates !

If you haven't chosen Earth as observing site, the output will only be made in the
R.A./Decl. system !
@endnode

@node "Fenster-Animation"
@title "Window/Animation"

Adjust the parameter of an animation.

An animation will only be saved as an IFF-ANIM file, when the Option 'Save' is activated.

@{i}Follow telescope:@{ui}
The telescope will stay at the selected coordinates during the whole animation.

@{i}Follow object:@{ui}
The telescope centers chosen object during the while animation.
The field of view has to be adjusted first.
With this option you can, for example, watch a planet rotating or trace eclipses !
Simply drag an object from the window @{"Solar system" link "Fenster-SMP"}, @{"Asteroids" link "Fenster-Asteroide"} or @{"Orbital elements" link "Fenster-Orbit"}
in the text field.

It is recommended to reduce the screen resolution if you want to save an animation.
Use for example DblPAL-Hires-NoFlicker or CyberGfx 640x480.

If the icon "ENV:Sys/def_anim.info" exists, it will be added to the animation !

@{b}Restriction:@{ub}
The IFF-ANIM-Format does not support High- und Truecolor modes.
If you run a screen with more than 8 bit depth, saving of an animation is disabled !

@{b}IMPORTANT:
* TO STOP AN ANIMATION, ACTIVATE THE MAIN WINDOW AND PRESS THE ESC-KEY !!
@endnode

@node "Fenster-SMP"
@title "Window/Solar system"

In this window you can choose several actions that refer to objects of the solar system.

The objects in the list are draggable.
See also @{"Export" link "Projekt-Export"} ,@{"Coordinates" link "Fenster-Koordinaten} and @{"Animation" link "Fenster-Animation"}.

Actions are: Look for, Center and Ephemeris.
@endnode

@node "Fenster-Asteroide"
@title "Window/Asteroids"

In this window you can choose several actions that refer to minor planets and asteroids.

The objects in the list are draggable.
See also @{"Export" link "Projekt-Export"} ,@{"Coordinates" link "Fenster-Koordinaten}, @{"Animation" link "Fenster-Animation"} and @"Orbital elements" link "Fenster-Orbit"}.

Actions are: Look for, Center and Ephemeris.
@endnode

@node "Fenster-Sterne"
@title "Window/Stars"

In this window you can choose several actions that refer to stars

The objects in the list "Complete" and the string gadget "SAO (click aat the frame !!)
are draggable.
See also @{"Export" link "Projekt-Export"} and @{"Animation" link "Fenster-Animation"}.

Actions are: Look for, Center and Ephemeris.
@endnode

@node "Fenster-Objekte"
@title "Window/Deep-Sky Objects"

In this window you can choose several actions that refer to objects outside the solar system.

The objects of all lists are draggable.
See also @{"Export" link "Projekt-Export"} and @{"Animation" link "Fenster-Animation"}.

Actions are: Look for, Center and Ephemeris.
@endnode

@node "Fenster-Orbit",
@title "Window/Orbital elements"

Here you can create your own database of solar system bodies, as long as you have the
orbital elements.

@{i}Name@{ui}:
Name of the object. If the object is a comet, please type a 'KM' in front of the name.

@{i}JD Epoche@{ui}:
Julian date of the epoche of the orbital elements.

@{i}Mean anomaly@{ui}:
Mean anomaly at upper time.
For comets you often have the perihelion time. Then the mean anomaly is 0 !

@{i}Mag. Parameter H@{ui}:
Describes the absolute magnitude of the object.
Is often called V(1,0).

@{i}Mag. Parameter G@{ui}:
This is a phase-depending parameter of the magnitude.
Is currently not used !

The objects of the list are draggable.
See also @{"Export" link "Projekt-Export"} ,@{"Coordinates" link "Fenster-Koordinaten} and @{"Animation" link "Fenster-Animation"}.

Actions are: Look for, Center and Ephemeris.

All other gadgets are self-explaining.

A special features is making a copy of an asteroid's elements.
Simply drag an object from the asteroid window to the list here. All parameters are
copied into the list. For example you now can alter these parameters.
@endnode

@node "Extras-Kalender"
@title "Extras/Calendar"

In this window you can inform yourself of some different events at a certain
day or month.

@{b}Events of the day:@{ub}
Select a day of the month.
The apparent positions of Sun and Moon at 0h GMT and their time of rise and set
will be displayed.
Special events of the Sun or the Moon will be also shown.

@{b}Events of the month:@{ub}
Press the button 'Events'.
The program will calculate for each day of the month special events of Sun, Moon,
planets and asteroids (if activated !) and displays them.
Depending on your hardware, this may take some time !!
@endnode

@node "Extras-Sonnenfinsternis"
@title "Extras/Solar eclipse"

If you know the date of a solar eclipse, for example with the help of the calendar,
you can trace the course of the eclipse.

1. Input the date of the solar eclipse.
   Input a time two to three hours before the center of the eclipse.

2. Input the number of steps and the step size in the window 'Solar eclipse' and
   start calculation.

In the listview below you can see the course of the solar eclipse:

- Local time of the observer
- Geographic lattitude and longitude of the main shadow
- Duration and phase of the eclipse

The drawer 'Projects' contains an example file 'SolarEclipse1999', which contains the
parameter of the total solar eclipse at 11-Aug-1999 over Middle Europe.
You can immediatly watch an animation of this eclipse.


Currently only a minor graphical output the course is supplied.
Only when there is a total solar eclipse, the course of the umbra will be diplayed
as a black line.
The area of the penumbra will currently not be diplayed.
@endnode

@node "Extras-Mondfinsternis"
@title "Extras/Lunar eclipse"

If you know the date of a lunar eclipse, for example with the help of the calendar,
you can trace the course of the eclipse.

1. Input the date of the lunar eclipse.
   Input a time two to three hours before the center of the eclipse.

2. Input the number of steps and the step size in the window 'Lunar eclipse' and
   start calculation.

In the listview below you can see the course of the lunar eclipse:

- Local time of the observer
- Phase of the eclipse

The drawer 'Projects' contains an example file 'LunarEclipse1997', which contains the
parameter of the total lunar eclipse at 16-Sep-1997 over Middle Europe.
You can immediatly watch an animation of this eclipse.
@endnode

@node "Picturesupport"
@title "Picture support"

Create your own picture galery !
To view a picture simply select the name of the picture in the listview from the new
menu item "Extras/Pictures" or from the ephemeris window.
The program loads the pictures via datatypes.

The picture.datatype V43 is supported !


@{b}Installation of a picture for the galery@{ub}:

Digital Almanac distinguishes between three different names of a picture:
1. The filename itself.
2. The name that appears in the list.
3. The internal name of the object.

2 and 3 are stored in the filecomment, seperated by the character '&'.


@{b}Rules:@{ub}

* If you don't specify a filecomment, the filename must equal to the internal name.
  It will also appear with this name in the list.

* If you specify a single filecomment (without '&'), then the filename must be equal
  to the internal name too, but the filecomment will appear in the list.

* If you specify two names in the filecomment (with '&') the the first part is the list
  name and the second part MUST be the internal name.


@{b}Examples:@{ub}
You have a picture for the object Messier 42 (The Great Orion Nebula).
Its internal name is "M42".

@{b}Example 1:@{ub}
Your picture is called "M42", and you want it to appear as "M42" in the list.
In this case you don't need to specify a filecomment.

@{b}Example 2:@{ub}
Your picture is called "M42", and you want it to appear as "Orion" in the list.
The filecomment is "Orion"

@{b}Example 3:@{ub}
Your picture is called "M42.jpg", and you want it to appear as "Orion Nebula" in the list.
The filecomment is "Orion Nebula&M42"

@{b}Example 4:@{ub}
Your picture is called "M42.jpg", and you want it to appear as "M42" in the list.
The filecomment is "M42&M42"

You see: Whenever the filename is different to the internal name, you MUST supply a file
comment with '&', otherwise the program can't find the picture !


@{b}Important:@{ub}
If you use CGX V2 on your system, you must have cybergraphics.library V40.113
or higher installed, otherwise pictures on true- or highcolor screens won't be scaled !
If you use CGX V2 in True/Highcolor mode, it may happen, that non-24-bit pictures
are displayed corrupt ! When using CGX V3, there are no problems.
@endnode

@node "Geschichte"
@title "History"

01-Aug-97  V39.0
	* Internal release.

20-Aug-97  V39.1
   * First public release.
   * VSOP87 tables replaced by DE404 tables.
   * Shortened catalogs.

21-Aug-97  V39.2
   * Minor change in planetary calculations, should be a little bit faster now.
   * Added string input for HR, GC and YBS number.
   * Added listview with different cities.
   * Big fix in the installer script. Now MINUSER=EXPERT
   * Bug fix in MUI's string gadgets. Input of angles no more blocked.
   * Some bug fixes in the docs, specially installation.
   * Added new tooltypes.
   * Added possibility to break drawing of map.
   * Rewrote timer part. Should work on American NTSC Amigas.

02-Sep-97  V39.3
   * Archive now contains asyncio.library 39.2.
   * Default value in "Minimum magnitude for objects" now 15m.
   * Added Saturn rings.
   * Added French catalog and Installer script.
     Thanks to SillyCat and Jürgen Schröder.
   * Added textures for Jupiter and Venus
   * Added tooltype NOTEXTURES.
   * Added Milky way structure.
     Thanks to Peter Knight.
   * Made some corrections in the catalogs.
   * Fixed a bug in star's proper motion calculation.
   * Better clipping when using Area-commands.
   * Fixed a serious bug in drawing textures.
     Jupiter now will be drawn correctly.
   * Color config can be saved.
   * Added Jovian (I-IV) and Saturnian (I-VIII) moons.

20-Sep-97  V39.4
   * Improved documentation.
   * New asteroid data base.
   * Fixed a bug in calculating Sun with planetary abberation.
   * Correct display of a planet's position angle in local sky mode.
   * Fixed a bug in calculating Saturn's magnitude.
   * Fixed a bug in calculating Jovian moons.
     Moons were orbiting Jupiter in the wrong direction.
   * Fixed a serious bug in the location's listview.
     Altitude and longitude were shown correct, but were internally wrong.
   * Fixed a serious bug in parsing CLI parameters.
     The star cache was always set to maximum.
   * Added Earth's shadow.
   * Added Rings of Jupiter, Uranus and Neptun.
   * All screen resolutions higher than 640x480 are supported,
     including CyberGfx High- and Truecolor modes.
   * Added tooltypes LIKEWB and ACACHE.
     CACHE replaced by SCACHE.
   * View the solar system now from any planet.
   * Added texture for Earth.
   * Added Picture support. Create your own picture galery.
   * Slightly improved texture and phase drawing.
   * Changed menu structure for faster access.
   * Added string gadget for limiting the number of asteroids to be drawn.
   * Calculation of Sun and Moon related events up to factor 10 faster using
     Chebyshev approximation.
   * More magnitude grey levels.
   * "Prefs" drawer name changed to "Projects". "Init" is now obsolete.
   * Project icons are supported.
   * Saving an animation is a bit faster now.
   * Added an intro picture.
   * Improved color allocation.
     Should look well even on systems with very strange Workbench colors.
   * The archive is now split into two parts.

13-Oct-97  V39.5
   * Fixed a serious bug in the tooltype LIKEWB.
     DA seemed to crash on some Amigas when LIKEWB was set.
     Workbench screens with a resolution lower than 640x480 are now supported.
   * Spelling of tooltype HOMECOORDS in the DA's icon was wrong.
     Location will now be set correctly at startup.
   * Fixed a serious bug in ASCII->Float functions.
     Some negative inputs were converted to positiv.
   * Oops ! The archive contained asyncio.library V39.1, not V39.2.
   * Julian date <-> calendar date rewritten and now bug free.
     You now can enter negative julian dates.
   * Fixed a bug when starting DA with a project.
     Colors were corrupt.
   * Fixed a bug when drawing earth shadow.
   * Fixed some minor bugs in the calendar.
     Calculations were not refering to Earth, when site was not Earth.
   * Added tooltypes NOINTRO and SCREENMODEREQUESTER.
   * Sidereal time (ST) will be displayed when in Local sky mode and Earth as site.
   * Added Hardcopy function.
   * Added calculation of lunar eclipses.

21-Oct-97  V39.6
   * Fixed a bug in calculating Neptune's magnitude.
     Neptune was most time invisible.
   * Under CGX V3 (15/16/24 bit) some stars were plotted in a wrong color.
     This has been fixed.
   * Added menu item "Center/Direction".
   * Added NewIcons.
   * Added JPEG support.

01-Nov-97  V39.7
	* New GUI !!
     Support of MUI's Drag&Drop ability.
   * Updated docs.
   * Added printing of ephemeris tables.
   * Added online and menu help with HELP-key.

10-Nov-97  V39.8
   * Fixed a bug with Earth shadow.
     The flag "Earth shadow" was not recognized.
   * Fixed a heavy bug in calculating Earth's axis.
     RA/Decl. angles were useless for dates in the far past or future.
   * Fixed a bug in calculating milky way and constellation borders.
     Precession matrix was used in wrong way.
   * Added window "Orbital elements".
   * Added night palette.
   * Data archive updated to V39.5.
   * Improved Jupiter texture.
   * Calculation of star and deep-sky object positions is a little bit faster now.
   * Converted some functions to assembler.
   * Put more constant datas into the data archive.
   * The keyfile will now be read from the S:-directory

02-Dec-97  V39.9
   * Fixed a bug made in V39.8 when drawing constellation lines in
     high/truecolor screens.
   * Fixed bugs in the file "ngcnames.data".
     Some names were referenced to wrong objects.
   * Fixed a bug that appeared again.
     Color palette was corrupt when starting with a project.
   * Support of the new graphic file format IFF-RGFX by Andreas Kleinert.
   * Added tooltype XPK.
   * Added Xpk packer selection window for IFF-RGFX.
     Includes public MUI-Subclass Xpk.mcc.
   * You now can watch the picture of an object directly from the ephemeris window.
     The handling of the filecomment has changed with it too !
   * Deep-Sky objects can now be marked as a picture !
@endnode

@node "Probleme"
@title "Known problems"

This program is designed to work on all those different Amigas that fulfill the
hard- and software requirements.
However, it is possible, that on some systems the program crashes or shows an
unexpected behaviour.

@{b}This is not a mistake of Digital Almanac !!@{ub}

Because of those many different hardware configurations and background patches
being installed, it can happen, that Digital Almanac does not work correctly.
In this case, you should check your system configuration. Degrade your system
(deactivate all those utilities you do not need) and restart Digital Almanac.
This will work in most cases.


@{b}Known problems:@{ub}

* Digital Almanac shows some problems when running under CyberGfx with the
  PLANES2FAST flag disabled. Because if an internal bug of CGX the animation mode
  showed some strange behaviour of the system. It even sometimes cased a guru.
  @{b}To avoid these problems, it is absoultely recommended to set the PLANES2FAST
  flag to TRUE (1) !!@{ub}

* It seems that sometimes the menu freezes for a little time.
  This behaviour can be caused by some menu patches (Magic Menu etc).
  I myself have installed Magic Menu V2.19 with no problems at all.

* If Digital Almanac shows no rection when a menu item has been selected,
  you must set the flag "Windows/Refresh" of the MUI preferences to "Smart".
  See also the chapter @{"Installation" link "Installation"}.

* The program may crash on some systems that use Blitter<->CPU patches.


@{b}Restrictions:@{ub}

* Saving an animation is only possible with lots of ChipRAM (or FastRAM under CyberGfx)
  To save a 640x512 animation, you need additional 1.3 MB (Chip-)RAM !!
  Note this, if you only have 1 MB ChipRAM !!

* If you have replaced the Floattext.mui class by the new MUI class NList,
  there may be some output errors !

If you should detect any bug, strange behaviour etc., please report this to
@{"me" link "Autor"} with a detailed description of your system
(hardware, background patches etc.).
@endnode

@node "FAQ"
@title "FAQ"

@{b}Q:@{ub} When I try to start DA, I only get the message "Couldn't find catalog.".

@{b}A:@{ub} Your Local prefs does not support one of DA's languages.
   Simply start your SYS:Prefs/Locale and select one of DA's languages as an
   alternative language. Save this configuration and restart DA.


@{b}Q:@{ub} DA won't start. Either the system crashes, or I receive a memory error.

@{b}A:@{ub} Does your machine has got the minimum hardware configuration ?
   Well, if yes, DA is very memory consuming. You need a minimum of 8 MB RAM.
   To run all features you need at least 12 MB, but 16 MB are recommended.
   If you have low memory, just set the tooltype NOASTEROIDS and NOOBJECTS
   and set the caches to a low value (for ex. 2000).
   You also can deactivate textures (NOTEXTURES) to save some more memory.


@{b}Q:@{ub} Why are the ephemeris of DA different compared to others programs ?

@{b}A:@{ub} DA uses planetary theories and algorithms that may be different than
   to other programs. It is usual that coordinates with the same input may differ
   up to several arcseconds or arcminutes compared to other programs.
@endnode

@node "Zukunft"
@title "Future"

* TurboPrint V3 support.

* And maybe many more things !!
@endnode

@node "Danke"
@title "Thanks to"

Special thanks to following people:

@{b}Mark Fuller@{ub}: Detecting dozens of bugs.

@{b}Peter Knight@{ub}: Mathematical advices and lots of other useful things.

@{b}Jürgen Barthmann@{ub}: Hardware support.

@{b}Stefan Leideck@{ub}: TurboPrint support.

@{b}Andreas Kleinert@{ub}: His new IFF-RGFX graphics format.

@{b}Christine Mench@{ub}: Psychological support.
@endnode

@node "Autor"
@title "Author"

@{b}@{u}Address:@{ub}@{uu}

@{b}S-Mail:@{ub}
Achim Stegemann
Kirschgartenstr. 69
69126 Heidelberg
Germany
Tel.: +49-6221-315360

@{b}E-Mail:@{ub}
astegema@ix.urz.uni-heidelberg.de


@{b}@{u}Bank account@{ub}@{uu}

Badische Beamtenbank Heidelberg (Germany)
BLZ 66090800
Accountnr. 2740605


@{b}Important:@{ub}
Cheques in foreign currency will not be accepted !!
@endnode

@node "Internet"
@title "Internet"

If you have access to the Internet, please visit my homepage.

@{b}http://www.rzuser.uni-heidelberg.de/~astegema@{ub}

Here you can get the latest news about Digital Almanac and other projects.
@endnode