NovasCioArray Method

Calculate an array of CIO RA values around a given date

Definition

Namespace: ASCOM.Tools.Novas31
Assembly: ASCOM.AstrometryTools (in ASCOM.AstrometryTools.dll) Version: 3.0.0-rc.1+86c25ce733aebb4d8b1b8a62e84770ea5e972bea
C#
public static short CioArray(
	double JdTdb,
	int NPts,
	ref ArrayList Cio
)

Parameters

JdTdb  Double
TDB Julian date.
NPts  Int32
Number of Julian dates and right ascension values requested (not less than 2 or more than 20).
Cio  ArrayList
An arraylist of RaOfCIO structures containing a time series of the right ascension of the Celestial Intermediate Origin (CIO) with respect to the GCRS.

Return Value

Int16
            0 ... everything OK
            1 ... error opening the 'cio_ra.bin' file
            2 ... 'JdTdb' not in the range of the CIO file; 
            3 ... 'NPts' out of range
            4 ... unable to allocate memory for the internal 't' array; 
            5 ... unable to allocate memory for the internal 'RA' array; 
            6 ... 'JdTdb' is too close to either end of the CIO file; unable to put 'NPts' data points into the output object.
            

Remarks

Given an input TDB Julian date and the number of data points desired, this function returns a set of Julian dates and corresponding values of the GCRS right ascension of the celestial intermediate origin (CIO). The range of dates is centered (at least approximately) on the requested date. The function obtains the data from an external data file.

Example

How to create and retrieve values from the arraylist Dim CioList As New ArrayList, Nov3 As New ASCOM.Astrometry.NOVAS3 rc = Nov3.CioArray(2455251.5, 20, CioList) ' Get 20 values around date 00:00:00 February 24th 2010 MsgBox("Nov3 RC= " & rc) For Each CioA As ASCOM.Astrometry.RAOfCio In CioList MsgBox("CIO Array " & CioA.JdTdb & " " & CioA.RACio) Next

Version Information

.NET Standard

Supported in: 2.0

See Also