Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1488

News	FAQ
Search	Home

measures.riseset - Function

	Package	general
	Module	measures
	Tool	measures

get rise and set times

Synopsis
riseset(crd, ev)

Arguments

crd	in	direction of source
		Allowed:	direction measure
ev	in	elevation limit
		Allowed:	angle quantity
		Default:	'5deg'

Returns
record with rise and set epoch or strings

Description
rise will give the rise/set times of a source. It needs the position in the frame, and a time. If the latter is not set, the current time will be used. The returned value is a record with a 'solved' field, which is F if the source is always below or above the horizon. In that case the rise and set fields will all have a string value. The record also returns a rise and set record, with 'last' and 'utc' fields showing the rise and set times as epochs.

Example

- dm.riseset(dm.direction('sun'))                     
[solved=T,
 rise=[last=[type=epoch, refer=LAST, m0=[value=0.0731388605, unit=d]],
       utc=[type=epoch, refer=UTC, m0=[value=52085.8964, unit=d]]],
 set=[last=[type=epoch, refer=LAST, m0=[value=0.455732593, unit=d]],
       utc=[type=epoch, refer=UTC, m0=[value=52086.2779, unit=d]]]] 
- dm.riseset(dm.direction('sun'), dq.unit('80deg'))                     
[solved=F,
 rise=[last=below, utc=below],
 set=[last=below, utc=below]] 
- dq.form.long(dm.riseset(dm.direction('sun')).rise.utc.m0)  
21:30:47.439