STARMAHP v1.22		COPYRIGHT 1999 D. STRALEY

Do yourself a favor. Print this with WORDPAD instead of NOTEPAD. Margins .5 inches.

1. STANDARD COPYRIGHT AND DISCLAIMER

This program is provided FREE to all, provided you also provide it free to all, ie if you make any money from this please send it to me. I cannot be responsible for any damage resulting from the use of, or inability to use, this program, either directly (it causes your calculator to explode) or indirectly (you get so frustrated trying to figure it out you spill coffee on it). This program is provided as is, without any warranty of any kind. This program is not affiliated with any commercial program(s), so don't get them confused. Thank you.

2. OVERVIEW

This program was conceived as a fun way to get a feel for what the sky will look like tonight, next week, last year, or whatever, for beginning astronomers. My goal was to provide a version that would fit on a 48G, and be accurate enough for visual identification of objects. There are over 650 stars stored, from all 88 constellations in the sky. It can also locate and plot the sun, moon, and the 5 closest planets, along with providing the right ascension and declination to within .5 degrees for these objects, which is sufficient for you to be able to zero in on them with field glasses or a low power telescope. It takes over 2 minutes to plot a map of the evening sky, however it automatically saves the last map so you can load it quickly for review later. It also features a handy constellation finder feature, so you can "blink" a constellation of interest on and off. Learning to recognize these patterns on StarMaHP will help you identify them easier in the sky, hopefully! The moon is also plotted with a reasonable approximation of its phases, so you can get an idea of how much it will interfere with your view. Unless of course, you want to see the moon that night instead of the stars! This is a "lite" version of a more complete package I am working on, maybe rise and set of sun, and moon, etc. Any other suggestions?

2.1 

CHANGES IN VERSION 1.22

a. Bug fixes: Further clock problems eliminated. Adjusted planet grob settings to a more accurate plot location. Corrected moon phase problem that occurred near the spring equinox.

b. Added right ascension, declination, azimuth and elevation to map display.


CHANGES IN VERSION 1.21
a. Update information screen so clock doesn't "turn back on" after user input.

b. Document new ZODIAC plot feature.


CHANGES IN VERSION 1.2
a. By popular request, added altitude and azimuth variables

b. Former global variables that could cause your HP to crash if executed from the stack are now temporary variables. There is a trade off in speed here, as there is now much more garbage collections time, but it does mean that the curious will have fewer warm-starts (I wonder what will happen if I press THIS button...)

c. Added pretty print for the output variables to clarify between HMS and decimal format.

d. A couple minor changes to algorithms to give slightly better accuracy. The moon can still be off by nearly a degree however, largely due to no parallax correction.

CHANGES IN VERSION 1.1
a. Added 22 additional constellations. Now you southerners don't have to worry about that "hole" in the sky around the South Pole.

b. Minor changes to some variable names for compatibility and better labeling.

c. "Truth in advertising". The original documentation claimed over 1000 stars. OOPS. That should have said coordinates. There were only half that number of stars. But that's still a lot!

d. Added % of visible moon disk label to plot.


3. INSTALLATION

I suggest downloading with KERMIT, the program will then install itself in its own folder appropriately labeled "STARMAHP". There are about 410 packets in this version. You can install with XMODEM if you want for greater speed. Once it is on the stack, label it 'STARMAHP' and save. If you give it another name, the checksum will be different than listed here. Your 48G will need to have no other programs before you can install it, and you must have at least 4K left over to run it, so if you want many other things on your 48G, you may want to modify it as noted under OTHER INFORMATION.

CHECKSUM
# 14963d
24120	bytes

4. OPERATION

To start StarMaHP, enter the directory and press RUN. The plot information is listed in both Universal Time and local time. The first time you use the program you will need to enter your local latitude, longitude, and time zone (its under LOCAL INFO, see menus below). No great accuracy is required here if you just want an idea of what things look like, you can look at a globe or map of your state and get within a couple of degrees. Also enter the number of hours you differ from UT. For convenience:

PST = 8
MST = 7
CST = 6
EST = 5

If you are in North America all numbers will be positive.

Now you are ready to plot! You navigate the menus using the soft keys. The menu tree looks like this:



RUN- DATE/TIME CONTROL-	AUTO DATE/TIME SET
				ENTER NEW DATE
				ENTER NEW TIME
	
	PLOT STARS--	START NEW PLOT
				VIEW LAST PLOT
				PLOT: (WHOLE SKY/ZODIAC ONLY)

	LOCAL INFO--	LATITUDE
				LONGITUDE
				TIME ZONE
				DST (ON/OFF)

Further menus available only from the plot view:

PLOT- PLAN-			MERC
				VENU
				MARS
				JUPI
				SATU
	
	SUN+ -		SUN
				MOON
				ECL

	CONS-			(3 LETTER DESIGNATION FOR CURRENT CONSTELLATION)
				ON
				OFF

RUN MENUS:

DATE/TIME:

AUTO DATE/TIME: Will set the current plot setting to your local date and time based on the time reported by your calculator (when was the last time you checked the time to make sure it was right?) 

ENTER NEW DATE: Set plot date.

ENTER NEW TIME:	Set plot time.

PLOT:

START NEW PLOT: Starts a new sky map based on current plot settings. If you press this by mistake, you have a 2 minute wait! You can choose which constellations to plot by modifying the 'CLST' variable. Optionally, you can save memory by deleting unwanted constellations, provided you modify it. See more detailed instructions below.

VIEW LAST PLOT:	Shows the last plot. You can update the plot settings, then go to this map to use the plot view menus. The stars in the background will be incorrect, but if you are just interested in positions of the planets, sun, and moon you can do it quickly this way. Also, you can use the single constellation setting to see where a constellation moved "from" by blinking its new position on and off (its neat to see how far it moves in 1 hour, say, but useless for 6 months unless you change the time, can you figure out why?)

WHOLE SKY/ZODIAC ONLY: If you are interested only in the position of the sun, moon or planets, the constellations of the zodiac are sufficient to locate them. Plotting only these 12 takes only 30 seconds, and so if you are interested in these objects it is quite a timesaver. The zodiac plot merely looks for the global variable ZLST, so you can modify it if you want an additional custum list of constellations similar to the instructions for modifying CLST below.

LOCAL INFO:

LATITUDE/LONGITUDE/TIME ZONE: Enter your local settings by pressing these keys. If you don't want to change anything on any of the input screens, just press the ON key twice and you will be back to the previous menu. This is typical of all the input screens.

DST: Shows current daylight savings time setting. It toggles on and off and automatically adjusts the UT time plus or minus one hour. So you don't have to try to remember (do I add, or subtract..?).

PLOT MENUS:

PLAN:

MERC/VENU/MARS/JUPI/SATU: Pressing this menu key plots the planet's symbol. If you hear a beep, it means the planet is not visible. If you don't see the planet when you press the key, and don't hear the beep, you probably have your calc set in silent mode (you can change it from the MODE menu).

Once a planet button is pressed, the right ascension and declination calculated are saved into the RA and DECL variables. Only the last calculated object is saved, but the plot screen does not need to be current for the calculations to work. The right ascension, declination, altitude and azimuth of each 

SUN+:

SUN/MOON: The present position of the sun or moon. A beep means it is not visible. The moon is shown with the approximate phase (StarMaHP rounds it to the nearest quarter). The "dark" area is the moons bright limb. This points in the right direction, so if the moon is lit up from the east, you know it's in the last quarter, and vice versa. A new moon is shown as an unfilled circle, the sun and the full moon as a black circle. The RA and DECL variables work here as well. Additionally, the percentage of the illuminated disk of the moon is displayed in the lower right hand corner so you can get a better idea of when the actual full and half moons occur.

ECL: This plots the line of the ecliptic, which is the path the sun, moon and planets appear to follow. There is about a 15 second delay before plotting begins, with the plot taking 30-45 seconds.

CONS:

VUL: This is the default single constellation. If you change CLST, the menu label will be the first item in your custom list. If you press it, the single constellation input screen comes up. You must enter one of the 3 letter constellations from the CLST variable list, which is just a list of all the constellations on your calc. These are the abbreviations used in many star guides (with exceptions in parenthesis, since these are HP reserved words!) The ones that come with the program are:








ADR Andromeda(55S AND)		CRU Crux (35S)		OPH Ophiuchus *
ANT Antlia	(60N)			CYG Cygnus (55S)		ORI Orion *
APS Apus (20N)			DEL Delphinus (70S)	PAV Pavo (30N)
AQR Aquarius (90N)		DOR Dorado (35N)		PEG Pegasus (70S)
AQL Aquila *			DRA Draco (35S)		PER Perseus (50S)
ARA Ara (35N)			EQU Equuleus (80S)	PHE Phoenix (45N)
ARI Aries (65S)			ERI Eridanus (80N)	PIC Pictor (35N)
AUR Auriga (55S)			FRN Fornax(55N FOR)	PSC Pisces (80S)
BOO Bootes	(70S)			GEM Gemini (70S)		PSA Piscis Austrinus (60N)
CAE Caelum  (50N)			GRU Grus (50N)		PUP Puppis (60N)
CAM Camelopardalis(20S)		HER Hercules (65S)	PYX Pyxis (60N) 
CNC Cancer (60S)			HOR Horologium(45N)	RET Reticulum (25S)
CVN Canes Venatici (55S)	HYA Hydra *			SGE Sagitta (70S)
CMA Canis Major (70N)		HYI Hydrus (25N)		SGR Sagittarius (70N)
CMI Canis Minor (85S)		IND Indus (35N)		SCO Scorpius (75N)
CAP Capricornus (70N)		LAC Lacerta (50S)		SCL Sculptor (60N)
CAR Carina (35N)			LEO Leo (75S)		SCT Scutum (80N)  
CAS Cassiopeia (30S)		LMI Leo Minor(50S)	SER Serpens *
								 (sometimes S. Cauda and S. Caput)
CEN Centaurus (50N)		LEP Lepus (70N)		SEX Sextans (85N)
CEP Cepheus	(25S)			LIB Libra (75N)		TAU Taurus (70S)
CET Cetus * 			LUP Lupus (50N)		TEL Telescopium (40N)
CHA Chamaeleon (20N)		LYN Lynx (50S)		TRI Triangulum (55S)
CIR Circinus (40N)		LYR Lyra (50S)		TRA Triangulum Australe (35N)
COL Columba	(50N)			MEN Mensa (20N)		TUC Tucana (25N)
COM Coma Berenices (60S)	MIC Microscopium(55N)	UMA Ursa Major (35S)(Big Dipper)
CRA Corona Australis(50N)	MON Monoceros *		UMI Ursa Minor (10S)(Little Dipper)
CRB Corona Borealis(60S)	MUS Musca (25N)		VEL Vela (45N)
CRV Corvus (70S)			NOR Norma (40N)		VIR Virgo (85N)
CRT Crater (75N)			OTN Octans (5N OCT)	VOL Volans (20N)
									VUL Vulpecula (60S)

So you can decide which constellations are of interest, I have included a number that indicates the latitude at which no more than 5 degrees of the constellation is no longer visible. For example, (40N) means that at 40 degrees north latitude you can see at least 5 degrees of the constellation peeking above the horizon. You can delete constellations with horizons of latitude smaller than yours (ignore numbers in the opposite hemisphere!). An asterisk (*) indicates at least some of the constellation is visible from all latitudes.

ON/OFF: Turns the constellation of interest on and off. It doesn't beep when you can't see it, but it's usually pretty obvious, unless most of it is below the horizon, in which case you can't see it, so who cares?

While the stars plot, the 3 letter designation is displayed in the corner of the window, so you can get an idea of where they are (if you can read fast!). From the view map, once the plot is finished, you can scroll around with the arrow keys to see the rest of the map. The date and time of plot are in the upper left hand corner of the plot for future reference, in case you view the next day, or week, and can't remember. The latitude and longitude are in the lower left corner.

5. OTHER INFORMATION

The scale of the sky on your HP is necessarily reduced! Each pixel represents about 1.5 degrees of sky. By comparison, the sun and moon are only about .5 degrees in diameter. So the size of the GROB for these objects are about 15 times their actual size. So when you see the planet "right on top" of another object, it ain't necessarily so! But at least you know the area to look in. The planets are normally very bright and easy to spot. In a telescope, they will have a distinct disk as opposed to the points of light from a star. Learning to use the RA and DECL variables can help, especially if you have a telescope with these markings on them. Future versions may include a zoom feature, so you could get a better idea of how they really look. 

If you want to save some memory, you can delete any of the constellations you are not interested in, some of the minor ones in particular. You will need to update the CLST variable. It is simply a list of all the constellations you have on your calculator. Once you have deleted all the constellations you want, make a new list by pressing <left-shift> <+>, then press VAR and NXT until you see the 3 letter constellations you wish to include. Press the softkey corresponding to each constellation you want to include. When you are done, press enter, and store it in the CLST variable. That's it! More room for games...


If you have questions, comments, suggestions, criticisms, or loose change, you can contact me at:

dst12345@aol.com

Dennis Straley

Special thanks to my wife Michelle, who previously had no inclination to learn about Declination, but now can tell her Right from her left Ascension, and who helped dictate star positions for many hours. Also, for being supportive of the many hours I spent at this silly machine typing stuff.

Many of the formulae used in this program were adapted from "Astronomical Formulae for Calculators" by Jean Meeus. Star positions are from "Starlist 2000" by Richard Dibon-Smith.
