The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
This is the examples directory. It contains the following files:

README - this file

almanac - A simple almanac program, displaying sun and moon rise and
	set for the given day (defaulting to today), and the quarters of
	the moon, solstices and equinoxes for the next 30 days after the
	given day.

es.pm - A very, very rough Spanish localization. This is intended as a
	user-specific localization, though it could be installed as a
	system-wide localization by uncommenting the 'package'
	statement. The main thing wrong with it is that it has not been
	edited by someone who actually is fluent in Spanish.

flare_vcalendar - A source file, to be executed by, for example,
	satpass2> source eg/flare_vcalendar
	This makes Iridium flare calculations for any satellites that
	have been loaded, and displays the results in vCalendar format.

	CAVEAT: My ancient Palm desktop software appears not to properly
	handle the switch between normal and daylight-saving  time
	(a.k.a. summer time), in that predictions made before the switch
	for events after the switch get assigned the wrong time, even
	though the UT event time is correct in the emitted file. I have
	not changed the event times to local times in eg/flare_vcalendar
	because the vcalendar standard specifies UT.

My/Macros.pm - A module that implements the following code macros
	* angle - Given the names or OIDs of two objects (either
		satellites or background bodies like the Moon or Sun)
		computes the angle between them at the time specified by
		the third argument, which defaults to the current time.
		Options specify radians or degrees, and the number of
		decimal places.
	* hi - A 'hello world' macro. It takes one argument, which
		defaults to 'world'.
	* test - A macro that issues a command (or not) based on whether
		or not specified conditions are met.
	* dumper - A diagnostic macro, which displays the class of its
		first argument, and all other arguments as a YAML dump.

	To use this, it must be placed in directory My/ somewhere in
	@INC, remembering that the lib/ directory in your configuration
	directory is added to @INC before your module is loaded.

pass_vcalendar - A source file, to be executed by, for example,
	satpass2> source eg/pass_vcalendar
	This makes pass calculations for any satellites that have been
	loaded, and displays the results in vCalendar format.

	CAVEAT: The same as for flare_vcalendar.

quarters_vcalendar - A source file, to be executed by, for example,
        satpass2> source eg/quarters_vcalendar
	This makes quarters calculations, and displays the results in
	vCalendar format.

	CAVEAT: The same as for flare_vcalendar.

tle_celestia.tt - A Template-Toolkit file to display TLE data in the
	format needed for the Celestia planetarium software. You would
	use this by loading the orbital elements you want, and then
	issuing the command
	    satpass2> formatter format eg/tle_celestia.tt
	All options to the tle command work here (e.g. -choose).

	CAVEAT: The file generated by this template is in the correct
	format, but is known (or at least strongly suspected) NOT to put
	the satellite in the correct position.

tle_json.tt - A Template-Toolkit file to display TLE data in JSON
	format, the keys being compatible with the ones returned by the
	Space Track REST interface. You would use this by loading the
	orbital elements you want, and then issuing the command
	    satpass2> formatter format eg/tle_celestia.tt
	All options to the tle command work here (e.g. -choose).

tle_stellarium.tt - A Template-Toolkit file to display TLE data in the
	format needed for Stellarium planetarium software. You would use
	this from Astro::App::Satpass2 by loading the orbital elements
	you want, and then issuing the command
	    satpass2> formatter format eg/tle_stellarium.tt
	All options to the tle command work here (e.g. -choose).

# ex: set tw=72 ai :