event

cgi-bin/event.pl documentation

Sun elevation, Moon elevation, Twilight, Polar day/night Sun, Polar day/night Moon, Apparent Solar/Lunar time, Moon Orbit, Moon Equinoxes, Solar eclipse, Lunar eclipse, Earth orbit, Mercury orbit, Venus orbit, Mars orbit, Jupiter orbit, Saturn orbit, Transit Mercury/Venus, Moon/Sun state, Solar system state

---

cgi-bin/event.pl interface

All times are in UTC. Coordinates are given with east and north as positive values.

A cgi-bin/event.pl? URL-request has the following parameters:

• eventStart: start time given as "YYYY-MM-DDTHH:MI:SSZ";
• eventSearch: event search code; -1:previous, +1:next, 0: both, +2:until eventStop;
• eventStop: report all events until eventStop given as "YYYY-MM-DDTHH:MI:SSZ", must only be present if eventSearch=+2;
• eventId: requested event id (SEE TABLES BELOW);
• eventVal<N>: input data (SEE TABLES BELOW) array, where <N> is the array index. Too high array indexes are ignored;
• debug: report CPU-usage: 1, no hints: '-1';

Several event-requests can be processed in the same URL by assigning a sequence number immediately after event in the parameter name, for instance event3Id or event3Val1. If sequence numbers are used, parameters without sequence numbers indicate default values and are not processed as a separate request. An event is processed when the sequence number changes, so default values should appear before the sequence number changes. The length of the URL query_string is limited to 1000 characters.

The XML output contains a list of the events found, with attributes referring to the input URL parameters:

• Seq : sequence number;
• Id : same as eventId;
• Start : same as eventStart time;
• Stop : same as eventStop time;
• Search : same as eventSearch;
• Val1 : same as eventVal1;
• Val2 : same as eventVal2;
• Val3 : same as eventVal3;
• Val4 : same as eventVal4;
• Val5 : same as eventVal5;
• reports : number of reports in the event;
• cost : CPU cost in milliseconds, if debug-mode is active;

Each event contains reports with data attributes:

• no : report number, unique to the event;
• time : time of the event as "YYYY-MM-DDTHH:MI:SSZ";
• repId : report identification, SEE TABLES BELOW for details;
• repVal : report value;
• hint : a redundant description of the report;

---

Note that a new type of report, with a new repId, may be added to an event without further notice. It is therefore recommended that you always check the repId to make sure it is the type you need, even if there is currently only one type of report present for that event.

Note also that the elevations given are relative to the body center and are not corrected for refraction. The Sun elevation at set/rise is defined as the time when the upper limb is visible on the horizon, i.e. when the elevation of the upper limb equals -refraction (-34/60 [degrees]). The elevation of the upper limb relative to the center is given by (radius/range)(180/Pi) [degrees]. The elevation of the Sun center at set/rise is therefore not zero, but given by -(34/60 -(radius/range)(180/Pi) [degrees]. The Sun radius is 682500 km, making the elevation of the Sun center at set/rise about -1 degree.

---

astro-api versions at the demo-, test- and production- servers

The astro demo server (astro.met.no) runs the latest stable version of astro-api. The latest stable version of astro-api is also deployed to the production servers in coordination with the yr-production team. The astro test server (astro-test.met.no) runs the version of astro-api that is being developed. The test-server may be corrupt or offline in periods.

cgi-bin/event.pl example

This is an example of a cgi-bin/event.pl? request: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;event1Id=600;event3Id=610; (astro-test) with the resulting XML output:

<?xml version="1.0" encoding="utf-8"?>
 <astrodata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://astro.met.no" xsi:schemaLocation="http://astro.met.no/astro event.xsd">
 <meta licenseurl="1"/>
  <Event Seq="1" Start="2014-10-10T10:10:10Z" Search="1" reports="3" Id="600" cost="1ms" Val1="60" Val2="0" Val3="0">
   <Report no="2" time="2014-10-11T06:29:11Z" repId="600" repVal="102.656930789" hint="2014/10/11 06:29:11 LOCAL DIURNAL SUN RISE (Solar azimuth)"/>
   <Report no="3" time="2014-10-11T06:29:11Z" repId="601" repVal="149351863.289869844" hint="2014/10/11 06:29:11 LOCAL DIURNAL SUN RISE (Solar range)"/>
  </Event>
  <Event Seq="3" Start="2014-10-10T10:10:10Z" Search="1" reports="3" Id="610" cost="1ms" Val1="60" Val2="0" Val3="0">
   <Report no="2" time="2014-10-10T17:06:04Z" repId="610" repVal="257.770941159" hint="2014/10/10 17:06:04 LOCAL DIURNAL SUN SET (Solar azimuth)"/>
   <Report no="3" time="2014-10-10T17:06:04Z" repId="611" repVal="149375450.740624845" hint="2014/10/10 17:06:04 LOCAL DIURNAL SUN SET (Solar range)"/>
  </Event>
 </astrodata>

---

80 - REPORT LOCAL VISIBLE MOON IN PERIOD

URL arguments:

• eventid=80;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=80 : repVal = <Hours visible moon in period>;
• repId=81 : repVal = <Moon rise * Lunar azimuth (deg)>;
• repId=82 : repVal = <Moon rise * Lunar range (km)>;
• repId=83 : repVal = <Moon rise * Lunar illumination (%)>;
• repId=84 : repVal = <Moon set * Lunar azimuth (deg)>;
• repId=85 : repVal = <Moon set * Lunar range (km)>;
• repId=86 : repVal = <Moon set * Lunar illumination (%)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;event1Id=80; (astro-test).

---

100 - REPORT LOCAL INITIAL MOON STATE

URL arguments:

• eventid=100;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML report output:

• repId=100 : repVal = <Lunar elevation (deg)>;
• repId=101 : repVal = <Lunar azimuth (deg)>;
• repId=102 : repVal = <Lunar range (km)>;
• repId=103 : repVal = <Moon diurnal state>

  repVal >= 1: "moon is above horizon";
  repVal <=-1: "moon is below horizon";

• repId=104 : repVal = <Moon polar state>

  repVal >= 1: "lunar polar day";
  repVal ==0: "no lunar polar effect";
  repVal <=-1: "lunar polar night";

• repId=105 : repVal = <Shadow incidence angle (deg)>

  repVal =-90:"100% shadow";
  repVal =0:"50% shadow";
  repVal =90:"0% shadow";

• repId=106 : repVal = <Shadow clock angle (deg)>

  repVal =0:"sun up";
  repVal =90:"sun right";
  repVal =180:"sun down";
  repVal =270:"sun left";

• repId=107 : repVal = <Moon phase>

  0<=repVal<25: "waxing crescent";
  25<=repVal<50: "waxing gibbous";
  50<=repVal<75: "waning gibbous";
  75<=repVal<100: "waning crescent";

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;event1Id=100; (astro-test).

---

110 - REPORT LOCAL TC EF MOON POSITION AT TIME INCREMENT

URL arguments:

• eventid=110;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Time increment (days)>;

XML output:

• repId=110 : repVal = <Moon elevation (deg)>;
• repId=111 : repVal = <Moon azimuth (deg)>;
• repId=112 : repVal = <Moon range (km)>;
• repId=113 : repVal = <Shadow incidence angle (deg)>;

  repVal =-90:"100% shadow";
  repVal =0:"50% shadow";
  repVal =90:"0% shadow";

• repId=114 : repVal = <Shadow clock angle (deg)>;

  repVal =0:"sun up";
  repVal =90:"sun right";
  repVal =180:"sun down";
  repVal =270:"sun left";

• repId=115 : repVal = <Moon phase>

  0<=repVal<25: "waxing crescent";
  25<=repVal<50: "waxing gibbous";
  50<=repVal<75: "waning gibbous";
  75<=repVal<100: "waning crescent";

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=2;eventStop=2014-10-11T10:10:10Z;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventVal4=0.1;eventId=110; (astro-test).

---

120 - REPORT LOCAL INITIAL SUN STATE

URL arguments:

• eventid=120;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=120 : repVal = <Sun elevation (deg)>;
• repId=121 : repVal = <Sun azimuth (deg)>;
• repId=122 : repVal = <Sun range (km)>;
• repId=123 : repVal = <Sun diurnal state>

  repVal >= 1: "sun is above horizon";
  repVal <=-1: "sun is below horizon";

• repId=124 : repVal = <Sun polar state>

  repVal >= 1: "polar day";
  repVal ==0: "no polar effect";
  repVal <=-1: "polar night";

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;event1Id=120; (astro-test).

130 - REPORT LOCAL TC EF SUN POSITION AT TIME INCREMENT

URL arguments:

• eventid=130;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Time increment (days)>;

XML output:

• repId=130 : repVal = <Sun elevation (deg)>;
• repId=131 : repVal = <Sun azimuth (deg)>;
• repId=132 : repVal = <Sun range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=2;eventStop=2014-10-11T10:10:10Z;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventVal4=0.1;eventId=130; (astro-test).

---

140 - REPORT LOCAL VISIBLE SUN IN PERIOD

URL arguments:

• eventid=140;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=140 : repVal = <Hours visible sun in period>;
• repId=141 : repVal = <Sun rise * Solar azimuth (deg)>;
• repId=142 : repVal = <Sun rise * Solar range (km)>;
• repId=143 : repVal = <Sun set * Solar azimuth (deg)>;
• repId=144 : repVal = <Sun set * Solar range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;event1Id=140; (astro-test).

---

150 - DETECT NORTHERN SOLSTICE

URL arguments:

• eventid=150;

XML output:

• repId=150 : Event found;

160 - DETECT ASCENDING SOLAR EQUINOX

URL arguments:

• eventid=160;

XML output:

• repId=160 : Event found;

170 - DETECT SOUTHERN SOLSTICE

URL arguments:

• eventid=170;

XML output:

• repId=170 : Event found;

180 - DETECT DESCENDING SOLAR EQUINOX

URL arguments:

• eventid=180;

XML output:

• repId=180 : Event found;

190 - DETECT EARTH IN PERIHELION

URL arguments:

• eventid=190;

XML output:

• repId=190 : repVal = <Sun range (km)>;

195 - DETECT EARTH IN APHELION

URL arguments:

• eventid=195;

XML output:

• repId=195 : repVal = <Sun range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=150;event2Id=160;event3Id=170;event4Id=180;event5Id=190;event6Id=195; (astro-test).

---

200 - DETECT MOON IN PERIGEE

URL arguments:

• eventid=200;

XML output:

• repId=200 : repVal = <Moon range (km)>;

205 - DETECT MOON IN APOGEE

URL arguments:

• eventid=205;

XML output:

• repId=205 : repVal = <Moon range (km)>;

210 - DETECT NEW MOON (PHASE=0/100)

URL arguments:

• eventid=210;

XML output:

• repId=210 : Event found;

220 - DETECT FIRST QUARTER MOON (PHASE=25)

URL arguments:

• eventid=220;

XML output:

• repId=220 : Event found;

230 - DETECT FULL MOON (PHASE=50)

URL arguments:

• eventid=230;

XML output:

• repId=230 : Event found;

240 - DETECT LAST QUARTER MOON (PHASE=75)

URL arguments:

• eventid=240;

XML output:

• repId=240 : Event found;

250 - DETECT MOON PHASE (0 TO 100)

URL arguments:

• eventid=250;
• eventVal1=<Target moon phase>;

XML output:

• repId=250 : Event found;

260 - DETECT MOON ILLUMINATION MINIMUM

URL arguments:

• eventid=260;

XML output:

• repId=260 : Event found;

270 - DETECT MOON ILLUMINATION MAXIMUM

URL arguments:

• eventid=270;

XML output:

• repId=270 : Event found;

280 - DETECT MOON ILLUMINATION (0 TO 100)

URL arguments:

• eventid=280;
• eventVal1=<Target moon illumination>;

XML output:

• repId=280 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=210;event2Id=220;event3Id=230;event4Id=240;event5Id=250;event5Val1=54.321;event6Id=260;event7Id=270;event8Id=280;event8Val1=12.345;event9Id=200;event10Id=205; (astro-test).

---

290 - DETECT NORTHERN LUNASTICE

URL arguments:

• eventid=290;

XML output:

• repId=290 : Event found;

292 - DETECT ASCENDING LUNAR EQUINOX

URL arguments:

• eventid=292;

XML output:

• repId=292 : Event found;

294 - DETECT SOUTHERN LUNASTICE

URL arguments:

• eventid=294;

XML output:

• repId=294 : Event found;

296 - DETECT DESCENDING LUNAR EQUINOX

URL arguments:

• eventid=296;

XML output:

• repId=296 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=290;event2Id=292;event3Id=294;event4Id=296;event5Id=200;event6Id=205; (astro-test).

---

300 - DETECT MERCURY INFERIOR CONJUNCTION

URL arguments:

• eventid=300;

XML output:

• repId=300 : Event found;

310 - DETECT MERCURY SUPERIOR CONJUNCTION

URL arguments:

• eventid=310;

XML output:

• repId=310 : Event found;

320 - DETECT MERCURY GREATEST WESTERN ELONGATION

URL arguments:

• eventid=320;

XML output:

• repId=320 : Event found;

330 - DETECT MERCURY GREATEST EASTERN ELONGATION

URL arguments:

• eventid=330;

XML output:

• repId=330 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=300;event2Id=310;event3Id=320;event4Id=330; (astro-test).

---

340 - DETECT VENUS INFERIOR CONJUNCTION

URL arguments:

• eventid=340;

XML output:

• repId=340 : Event found;

350 - DETECT VENUS GREATEST WESTERN ELONGATION

URL arguments:

• eventid=350;

XML output:

• repId=350 : Event found;

360 - DETECT VENUS SUPERIOR CONJUNCTION

URL arguments:

• eventid=360;

XML output:

• repId=360 : Event found;

370 - DETECT VENUS GREATEST EASTERN ELONGATION

URL arguments:

• eventid=370;

XML output:

• repId=370 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=340;event2Id=350;event3Id=360;event4Id=370; (astro-test).

---

380 - DETECT MARS CONJUNCTION

URL arguments:

• eventid=380;

XML output:

• repId=380 : Event found;

390 - DETECT MARS WESTERN QUADRATURE

URL arguments:

• eventid=390;

XML output:

• repId=390 : Event found;

400 - DETECT MARS OPPOSITION

URL arguments:

• eventid=400;

XML output:

• repId=400 : Event found;

410 - DETECT MARS EASTERN QUADRATURE

URL arguments:

• eventid=410;

XML output:

• repId=410 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=380;event2Id=390;event3Id=400;event4Id=410; (astro-test).

---

420 - DETECT JUPITER CONJUNCTION

URL arguments:

• eventid=420;

XML output:

• repId=420 : Event found;

430 - DETECT JUPITER WESTERN QUADRATURE

URL arguments:

• eventid=430;

XML output:

• repId=430 : Event found;

440 - DETECT JUPITER OPPOSITION

URL arguments:

• eventid=440;

XML output:

• repId=440 : Event found;

450 - DETECT JUPITER EASTERN QUADRATURE

URL arguments:

• eventid=450;

XML output:

• repId=450 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=420;event2Id=430;event3Id=440;event4Id=450; (astro-test).

---

460 - DETECT SATURN CONJUNCTION

URL arguments:

• eventid=460;

XML output:

• repId=460 : Event found;

470 - DETECT SATURN WESTERN QUADRATURE

URL arguments:

• eventid=470;

XML output:

• repId=470 : Event found;

480 - DETECT SATURN OPPOSITION

URL arguments:

• eventid=480;

XML output:

• repId=480 : Event found;

490 - DETECT SATURN EASTERN QUADRATURE

URL arguments:

• eventid=490;

XML output:

• repId=490 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=460;event2Id=470;event3Id=480;event4Id=490; (astro-test).

---

500 - DETECT MERCURY TRANSIT (ANYWHERE ON EARTH)

URL arguments:

• eventid=500;

XML output:

• repId=500 : transit starts;
• repId=501 : transit ends;

520 - DETECT VENUS TRANSIT (ANYWHERE ON EARTH)

URL arguments:

• eventid=520;

XML output:

• repId=520 : Transit starts;
• repId=521 : Transit ends;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=500;event2Id=520; (astro-test).

---

550 - DETECT LUNAR ECLIPSE (MINOCC MAXOCC)

URL arguments:

• eventid=550;
• eventVal1=<Minimum occultation (0 to 100)>;
• eventVal2=<Maximum occultation (0 to 100)>;

XML output:

• repId=550 : Penumbra contact starts (P1);
• repId=551 : Umbra contact starts (U1);
• repId=552 : Total eclipse starts (U2);
• repId=553 : repVal = <Maximum occultation>;
• repId=554 : Total eclipse stops (U3);
• repId=555 : Umbra contact stops (U4);
• repId=556 : Penumbra contact stops (P2);

560 - DETECT LUNAR ECLIPSE

URL arguments:

• eventid=560;

XML output:

• repId=560 : Penumbra contact starts (P1);
• repId=561 : Umbra contact starts (U1);
• repId=562 : Total eclipse starts (U2);
• repId=563 : repVal = <Maximum occultation>;
• repId=564 : Total eclipse stops (U3);
• repId=565 : Umbra contact stops (U4);
• repId=566 : Penumbra contact stops (P2);

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=550;event1Val1=10.0;event1Val2=100.0;event2Id=560; (astro-test).

---

600 - DETECT LOCAL DIURNAL SUN RISE

URL arguments:

• eventid=600;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=600 : repVal = <Solar azimuth (deg)>;
• repId=601 : repVal = <Solar range (km)>;

610 - DETECT LOCAL DIURNAL SUN SET

URL arguments:

• eventid=610;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=610 : repVal = <Solar azimuth (deg)>;
• repId=611 : repVal = <Solar range (km)>;

620 - DETECT LOCAL DIURNAL MAXIMUM SOLAR ELEVATION

URL arguments:

• eventid=620;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=620 : repVal = <Maximum solar elevation (deg)>;
• repId=621 : repVal = <Solar azimuth (deg)>;
• repId=622 : repVal = <Solar range (km)>;

630 - DETECT LOCAL DIURNAL MINIMUM SOLAR ELEVATION

URL arguments:

• eventid=630;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=630 : repVal = <Minimum solar elevation (deg)>;
• repId=631 : repVal = <Solar azimuth (deg)>;
• repId=632 : repVal = <Solar range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=600;event2Id=610;event3Id=620;event4Id=630; (astro-test).

---

640 - DETECT LOCAL DIURNAL CIVIL TWILIGHT START

URL arguments:

• eventid=640;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=640 : repVal = <Solar azimuth (deg)>;
• repId=641 : repVal = <Solar range (km)>;

650 - DETECT LOCAL DIURNAL CIVIL TWILIGHT STOP

URL arguments:

• eventid=650;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=650 : repVal = <Solar azimuth (deg)>;
• repId=651 : repVal = <Solar range (km)>;

660 - DETECT LOCAL DIURNAL NAUTICAL TWILIGHT START

URL arguments:

• eventid=660;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=660 : repVal = <Solar azimuth (deg)>;
• repId=661 : repVal = <Solar range (km)>;

670 - DETECT LOCAL DIURNAL NAUTICAL TWILIGHT STOP

URL arguments:

• eventid=670;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=670 : repVal = <Solar azimuth (deg)>;
• repId=671 : repVal = <Solar range (km)>;

680 - DETECT LOCAL DIURNAL ASTRONOMICAL TWILIGHT START

URL arguments:

• eventid=680;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=680 : repVal = <Solar azimuth (deg)>;
• repId=681 : repVal = <Solar range (km)>;

690 - DETECT LOCAL DIURNAL ASTRONOMICAL TWILIGHT STOP

URL arguments:

• eventid=690;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=690 : repVal = <Solar azimuth (deg)>;
• repId=691 : repVal = <Solar range (km)>;

700 - DETECT LOCAL DIURNAL NIGHT START

URL arguments:

• eventid=700;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=700 : repVal = <Solar azimuth (deg)>;
• repId=701 : repVal = <Solar range (km)>;

710 - DETECT LOCAL DIURNAL NIGHT STOP

URL arguments:

• eventid=710;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=710 : repVal = <Solar azimuth (deg)>;
• repId=711 : repVal = <Solar range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=640;event2Id=650;event3Id=660;event4Id=670;event5Id=680;event6Id=690;event7Id=700;event8Id=710; (astro-test).

---

750 - DETECT LOCAL DIURNAL SUN AZIMUTH (0=NORTH, 90=EAST)

URL arguments:

• eventid=750;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Sun azimuth (deg)>;

XML output:

• repId=750 : Event found;

760 - DETECT LOCAL DIURNAL APPARENT SOLAR TIME

URL arguments:

• eventid=760;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Apparent solar time (0 to 24)>;

XML output:

• repId=760 : Event found;

770 - DETECT LOCAL DIURNAL APPARENT LUNAR TIME

URL arguments:

• eventid=770;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Apparent lunar time (0 to 24)>;

XML output:

• repId=770 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventVal4=12.0;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=750;event2Val4=11.1;event2Id=760;event3Val4=12.0;event3Id=770; (astro-test).

---

800 - DETECT LOCAL DIURNAL MOON RISE

URL arguments:

• eventid=800;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=800 : repVal = <Lunar azimuth (deg)>;
• repId=801 : repVal = <Lunar range (km)>;
• repId=802 : repVal = <Lunar illumination (%)>;

810 - DETECT LOCAL DIURNAL MOON SET

URL arguments:

• eventid=810;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=810 : repVal = <Lunar azimuth (deg)>;
• repId=811 : repVal = <Lunar range (km)>;
• repId=812 : repVal = <Lunar illumination (%)>;

820 - DETECT LOCAL DIURNAL MAXIMUM MOON ELEVATION

URL arguments:

• eventid=820;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=820 : repVal = <Maximum moon elevation (deg)>;
• repId=821 : repVal = <Lunar azimuth (deg)>;
• repId=822 : repVal = <Lunar range (km)>;
• repId=823 : repVal = <Lunar illumination (%)>;

830 - DETECT LOCAL DIURNAL MINIMUM MOON ELEVATION

URL arguments:

• eventid=830;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=830 : repVal = <Minimum moon elevation (deg)>;
• repId=831 : repVal = <Lunar azimuth (deg)>;
• repId=832 : repVal = <Lunar range (km)>;
• repId=833 : repVal = <Lunar illumination (%)>;

840 - DETECT LOCAL DIURNAL MOON AZIMUTH (0=NORTH, 90=EAST)

URL arguments:

• eventid=840;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Moon azimuth (deg)>;

XML output:

• repId=840 : Event found;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventVal4=90;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=800;event2Id=810;event3Id=820;event4Id=830;event5Id=840; (astro-test).

---

900 - DETECT LOCAL POLAR SUN DAY START

URL arguments:

• eventid=900;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=900 : Event found;
• repId=901 : repVal = <Previous sun rise * Solar azimuth (deg)>;
• repId=902 : repVal = <Previous sun rise * Solar range (km)>;

910 - DETECT LOCAL POLAR SUN DAY STOP

URL arguments:

• eventid=910;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=910 : Event found;
• repId=911 : repVal = <Next sun set * Solar azimuth (deg)>;
• repId=912 : repVal = <Next sun set * Solar range (km)>;

920 - DETECT LOCAL POLAR SUN NIGHT START

URL arguments:

• eventid=920;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=920 : Event found;
• repId=921 : repVal = <Previous sun set * Solar azimuth (deg)>;
• repId=922 : repVal = <Previous sun set * Solar range (km)>;

930 - DETECT LOCAL POLAR SUN NIGHT STOP

URL arguments:

• eventid=930;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=930 : Event found;
• repId=931 : repVal = <Next sun rise * Solar azimuth (deg)>;
• repId=932 : repVal = <Next sun rise * Solar range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=70.0;eventVal2=0.0;eventVal3=0.0;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=900;event2Id=910;event3Id=920;event4Id=930; (astro-test).

---

940 - DETECT LOCAL POLAR LUNAR DAY START

URL arguments:

• eventid=940;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=940 : Event found;
• repId=941 : Previous moon rise;

950 - DETECT LOCAL POLAR LUNAR DAY STOP

URL arguments:

• eventid=950;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=950 : Event found;
• repId=951 : Next moon set;

960 - DETECT LOCAL POLAR LUNAR NIGHT START

URL arguments:

• eventid=960;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=960 : Event found;
• repId=961 : Previous moon set;

970 - DETECT LOCAL POLAR LUNAR NIGHT STOP

URL arguments:

• eventid=970;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=970 : Event found;
• repId=971 : Next moon rise;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=75.0;eventVal2=0.0;eventVal3=0.0;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=940;event2Id=950;event3Id=960;event4Id=970; (astro-test).

---

980 - DETECT LOCAL SOLAR ECLIPSE (MINOCC MAXOCC)

URL arguments:

• eventid=980;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Minimum occultation (0 to 100)>;
• eventVal5=<Maximum occultation (0 to 100)>;

XML output:

• repId=980 : Partial solar eclipse starts;
• repId=981 : Annular solar eclipse starts;
• repId=982 : Total solar eclipse starts;
• repId=983 : repVal = <Maximum occultation>;
• repId=984 : Total solar eclipse stops;
• repId=985 : Annular solar eclipse stops;
• repId=986 : Partial solar eclipse stops;

990 - DETECT LOCAL SOLAR ECLIPSE

URL arguments:

• eventid=990;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;

XML output:

• repId=990 : Partial solar eclipse starts;
• repId=991 : Annular solar eclipse starts;
• repId=992 : Total solar eclipse starts;
• repId=993 : repVal = <Maximum occultation>;
• repId=994 : Total solar eclipse stops;
• repId=995 : Annular solar eclipse stops;
• repId=996 : Partial solar eclipse stops;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=25.3;eventVal2=-104.1;eventVal3=0.0;eventStart=2014-10-10T10:10:10Z;eventSearch=1;event1Id=980;event1Val4=99.0;event1Val5=100.0;event2Id=990; (astro-test).

---

1000 - REPORT LOCAL TC EF SOLAR SYSTEM POSITIONS AT TIME INCREMENT

URL arguments:

• eventid=1000;
• eventVal1=<Geographic latitude of observer (deg)>;
• eventVal2=<Geographic longitude of observer (deg)>;
• eventVal3=<Height of observer above reference ellipsoid (km)>;
• eventVal4=<Time increment (days)>;
• eventVal5=<Number of planets (0..9)>;

XML output:

• repId=1000 : repVal = <Sun elevation (deg)>;
• repId=1001 : repVal = <Sun azimuth (deg)>;
• repId=1002 : repVal = <Sun range (km)>;
• repId=1010 : repVal = <Mercury elevation (deg)>;
• repId=1011 : repVal = <Mercury azimuth (deg)>;
• repId=1012 : repVal = <Mercury range (km)>;
• repId=1013 : repVal = <Mercury illumination (%)>;
• repId=1020 : repVal = <Venus elevation (deg)>;
• repId=1021 : repVal = <Venus azimuth (deg)>;
• repId=1022 : repVal = <Venus range (km)>;
• repId=1023 : repVal = <Venus illumination (%)>;
• repId=1030 : repVal = <Moon elevation (deg)>;
• repId=1031 : repVal = <Moon azimuth (deg)>;
• repId=1032 : repVal = <Moon range (km)>;
• repId=1033 : repVal = <Moon illumination (%)>;
• repId=1040 : repVal = <Mars elevation (deg)>;
• repId=1041 : repVal = <Mars azimuth (deg)>;
• repId=1042 : repVal = <Mars range (km)>;
• repId=1043 : repVal = <Mars illumination (%)>;
• repId=1050 : repVal = <Jupiter elevation (deg)>;
• repId=1051 : repVal = <Jupiter azimuth (deg)>;
• repId=1052 : repVal = <Jupiter range (km)>;
• repId=1060 : repVal = <Saturn elevation (deg)>;
• repId=1061 : repVal = <Saturn azimuth (deg)>;
• repId=1062 : repVal = <Saturn range (km)>;
• repId=1070 : repVal = <Uranus elevation (deg)>;
• repId=1071 : repVal = <Uranus azimuth (deg)>;
• repId=1072 : repVal = <Uranus range (km)>;
• repId=1080 : repVal = <Neptune elevation (deg)>;
• repId=1081 : repVal = <Neptune azimuth (deg)>;
• repId=1082 : repVal = <Neptune range (km)>;
• repId=1090 : repVal = <Pluto elevation (deg)>;
• repId=1091 : repVal = <Pluto azimuth (deg)>;
• repId=1092 : repVal = <Pluto range (km)>;

Example: http://157.249.76.102/astro/cgi-bin/event.pl/?debug=1;eventVal1=60.0;eventVal2=0.0;eventVal3=0.0;eventVal4=0.1;eventStart=2014-10-10T10:10:10Z;eventSearch=1;eventId=1000; (astro-test).

---

cgi-bin/event_json.pl documentation

This script works similar to cgi-bin/event.pl, except that the output is in the json format.