All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class JObserve.Telescope

java.lang.Object
   |
   +----JObserve.Telescope

public class Telescope

extends Object

See Also:

ListBlock

AskForFilename

File name to force asking user for file name

Azimuth

Initial azimuth 8 characters "sddd.dd"

Declination

Initial Declination 8 characters "sDDMMSS "

defaultPanel

Elevation

Initial elevation 8 characters "sddd.dd"

fileExt

File extensions for the Observe lists Note: these are coordinated with the list numbers in Observation.

HourAngle

Initial Hour Angle 8 characters "sHHMMSS"

J2000CalNames

Use J2000 calibrator names?

LeapSeconds

Leap seconds to correct UT to IAT

LocalSiderealDay

Local Siderial day number 6 characters "ddddd"

LocalSiderealTime

Local Siderial time 7 characters "HHMMSS"

LocalTime

Local Time

myListEditPanel

List display/edit panel

NRAOCalibratorFile

URL of file containing most recent version of the Calibrator List.

NRAODefaultFile

URL of file containing most recent version of the NRAO Defaults List.

observeFile

Observe file name

observeFilter

Observe file name filter This doesn't actually work - another java bug

obsTextFile

Text Schedule file

PlanetAngSepLimit

Planetary warning angle How close can an observed source be to a planet (deg) before a warning is issued?

reportFiles

Observe report file names

RightAscension

Initial Right Ascension 7 characters ""HHMMSS"

saveDirectory

Save Directory

saveFile

Save/restore file name root

SolarAngSepLimit

Solar warning angle How close can an observed source be to the sun (deg) before a warning is issued?

sourceTextFile

Text Source file

UT

UTC time

Telescope()

Constructor

CheckDB()

Check data base versions This allows the user to see if he/she is using the most recent calibrator lists and NRAO Defaults lists.

FetchDB()

Fetch database file from NRAO This allows the user to update the version of a file from NRAO.

getPlanetWarn()

Get Planetary warnings distance

getSolarWarn()

Get Solar warnings distance

MakeBandInfo()

Create a Calibrator BandInfo structure - a virtual function

MakeScan()

Create a Scan structure - a virtual function

MakeScan(Scan)

Duplicate a Scan structure - a virtual function

MakeScanPos(boolean)

Create a ScanPos structure This is the virtual version

MoveTime(Scan)

Compute telescope Move time

parseHeaderCard(String)

Parse Card from beginning of a Scan list virtual version

ReadCalDB(String, Observation)

Read Calibrator database virtual version

ReadObsFile(String, Observation)

Read Observe List virtual version

ReadScanList(String, Observation, int)

Read schedule ScanList

ReadSetupFile(String, Observation)

Read schedule Setup file virtual version

ReadSourceFile(String, Observation)

Read Source list Read a source list from a free format text file virtual version

ReadTextObs(String, Observation)

Read Text Schedule Read a schedule from a free format text file virtual version

ResetCalibrator(boolean)

Reset Calibrator Epoch boolean true if J2000, else B1950

ResetTimes(Observation, int)

Reset stop times (Stop time, duration, or Dwell time) in Scan members.

Schedule(Observation)

Process an observing schedule Process any scans not scheduled

ScheduleAll(Observation)

Process an observing schedule Completely reschedule

ScheduleScan(Scan)

Schedule scan virtual version

ScheduleUpTo(Observation, Scan)

Process an observing schedule Process up to a given scan

setPlanetWarn(double)

Set Planetary warnings distance

setSolarWarn(double)

Set Solar warnings distance

SetupScan(ScanPos, Scan)

Setup for scan virtual version

ShowEditListsPanel()

Display EditListsPanel virtual version

ShowInitialConditionsPanel()

Display Initial Conditions Panel virtual version

ShowInitialPanel()

Display initial panel virtual version

ShowPlanetWarnPanel()

Display Planetary warnings Panel

ShowSolarWarnPanel()

Display Solar warnings Panel

StripExtn(String)

Get filename root Strip any ".*" from a file name

Unschedule(Observation, Scan)

Unschedule the Observe List

Rules of the game:

1. Only the observe list may be unscheduled.
   VerifyScan(Scan)
   Verify scan correctness Any errors found are returned in the Messages member virtual version
   WriteObsFile(String, Observation)
   Write Observe file virtual version
   WriteReport(String, Observation, int)
   Write Report virtual version
   WriteScanList(String, Observation, int)
   Write schedule ScanList If the scan list is empty and a null name is given then the routine throws an IllegalArgumentException
   WriteSetupFile(String, Observation)
   Write schedule Setup file virtual version
   xxxReadScanList(String, Observation, int)
   Read schedule ScanList virtual version
   xxxWriteScanList(String, Observation, int)
   Write schedule ScanList virtual version

 public ObservePanel defaultPanel

 public ListEditPanel myListEditPanel

List display/edit panel

 protected String saveDirectory

Save Directory

 protected String saveFile

Save/restore file name root

 protected String observeFile

Observe file name

 protected String sourceTextFile

Text Source file

 protected String obsTextFile

Text Schedule file

 protected String NRAOCalibratorFile

URL of file containing most recent version of the Calibrator List. This is set in the array specific constructor.

 protected String NRAODefaultFile

URL of file containing most recent version of the NRAO Defaults List. This is set in the array specific constructor.

 protected FilenameFilter observeFilter

Observe file name filter This doesn't actually work - another java bug

 public String LocalSiderealDay

Local Siderial day number 6 characters "ddddd"

 public String LocalSiderealTime

Local Siderial time 7 characters "HHMMSS"

 public double LocalTime

Local Time

 public double UT

UTC time

 public double LeapSeconds

Leap seconds to correct UT to IAT

 public String Azimuth

Initial azimuth 8 characters "sddd.dd"

 public String Elevation

Initial elevation 8 characters "sddd.dd"

 public String HourAngle

Initial Hour Angle 8 characters "sHHMMSS"

 public String RightAscension

Initial Right Ascension 7 characters ""HHMMSS"

 public String Declination

Initial Declination 8 characters "sDDMMSS "

 public boolean J2000CalNames

Use J2000 calibrator names?

 public double SolarAngSepLimit

Solar warning angle How close can an observed source be to the sun (deg) before a warning is issued?

 public double PlanetAngSepLimit

Planetary warning angle How close can an observed source be to a planet (deg) before a warning is issued?

 public static final String fileExt[]

File extensions for the Observe lists Note: these are coordinated with the list numbers in Observation.

 public static final String reportFiles[]

Observe report file names

 public static final String AskForFilename

File name to force asking user for file name

 public Telescope()

Constructor

 public double MoveTime(Scan theScan)

Compute telescope Move time

Parameters:

Scanthe - Scan defining the position to move to.

Returns:

double the move time in seconds, -1.0 => an impossible move

 public Scan MakeScan()

Create a Scan structure - a virtual function

Returns:

Scan the new Scan

 public Scan MakeScan(Scan scan)

Duplicate a Scan structure - a virtual function

Parameters:

Scan - the Scan to copy

Returns:

Scan the new scan

 public BandInfo MakeBandInfo()

Create a Calibrator BandInfo structure - a virtual function

Returns:

BandInfo the new BandInfo

 public ScanPos MakeScanPos(boolean initial)

Create a ScanPos structure This is the virtual version

Parameters:

boolean - it true set to initial conditions

 public void Schedule(Observation Obs)

Process an observing schedule Process any scans not scheduled

Parameters:

- Observation the Observation (schedule).

 public void ScheduleUpTo(Observation Obs,
                          Scan StopScan)

Process an observing schedule Process up to a given scan

Parameters:

- Observation the Observation (schedule).

- Scan last Scan to process.

 public void ScheduleAll(Observation Obs)

Process an observing schedule Completely reschedule

Parameters:

- Observation the Observation (schedule).

 public void Unschedule(Observation Obs,
                        Scan startScan)

Unschedule the Observe List

Rules of the game:

1. Only the observe list may be unscheduled. The scan pointer given must point to a valid source within that list, or be null(). Bad things will happen if it doesn't.
2. A null scan pointer means that the entire list will be unscheduled.
3. A valid pointer will cause that scan, and all others to the end of the list to be unscheduled.
4. All unscheduled sources except the first will have all times except the specified time marked as NotPresent.
5. The first unscheduled source may have the start time left as computed.

   Parameters:

   - Observation the Observation (schedule).

   - Scan the first Scan to be descheduled, if null then from the start.

 public void SetupScan(ScanPos Current,
                       Scan theScan)

Setup for scan virtual version

Parameters:

ScanPos - Telescope pointing at the start of the scan

Scan - The Scan in question

 public void ScheduleScan(Scan theScan)

Schedule scan virtual version

Parameters:

Scan - The Scan in question

 public void VerifyScan(Scan theScan)

Verify scan correctness Any errors found are returned in the Messages member virtual version

Parameters:

Scan - The Scan in question

 public void ResetTimes(Observation Obs,
                        int newTime)

Reset stop times (Stop time, duration, or Dwell time) in Scan members. this will unschedule all Scans

Parameters:

- Observation the Observation (schedule).

- int new time specification for scans (Scan.java)

See Also:

Scan

 public void ResetCalibrator(boolean J2000)

Reset Calibrator Epoch boolean true if J2000, else B1950

 public void ShowInitialPanel()

Display initial panel virtual version

 public void ShowInitialConditionsPanel()

Display Initial Conditions Panel virtual version

 public void ShowEditListsPanel()

Display EditListsPanel virtual version

 public void ShowPlanetWarnPanel()

Display Planetary warnings Panel

 public void setPlanetWarn(double distance)

Set Planetary warnings distance

Parameters:

double - the warning distance

 public double getPlanetWarn()

Get Planetary warnings distance

Returns:

double the warning distance

 public void ShowSolarWarnPanel()

Display Solar warnings Panel

 public void setSolarWarn(double distance)

Set Solar warnings distance

Parameters:

double - the warning distance

 public double getSolarWarn()

Get Solar warnings distance

Returns:

double the warning distance

 public boolean ReadSetupFile(String File,
                              Observation Obs) throws IllegalArgumentException, IOException

Read schedule Setup file virtual version

Parameters:

String - file name (null = ask) if name = Telescope.AskForFilename" then the user will always be asked

Observation - the observation

Returns:

boolean true if worked, else user abort

 public boolean WriteSetupFile(String File,
                               Observation Obs) throws IllegalArgumentException, IOException

Write schedule Setup file virtual version

Parameters:

String - file name (null = ask) if name = Telescope.AskForFilename" then the user will always be asked

Observation - the observation

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

 public boolean xxxReadScanList(String File,
                                Observation Obs,
                                int whichList) throws IllegalArgumentException, IOException

Read schedule ScanList virtual version

Parameters:

String - file name (null = ask) if name = Telescope.AskForFilename" then the user will always be asked

Observation - the observation

int - 0-rel ListBlock to update (defined in Observation)

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

See Also:

Observation

 public boolean ReadScanList(String File,
                             Observation Obs,
                             int whichList) throws IllegalArgumentException, IOException

Read schedule ScanList

Parameters:

String - file name (null = ask, or use Save file) if name = Telescope.AskForFilename" then the user will always be asked if name is null no return will be OK if no UserDefault, Default, Observe or Source list is found

Observation - the observation

int - 0-rel ListBlock to update (defined in Observation)

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

See Also:

Observation

 public boolean xxxWriteScanList(String File,
                                 Observation Obs,
                                 int whichList) throws IllegalArgumentException, IOException

Write schedule ScanList virtual version

Parameters:

String - file name (null = ask) if name = Telescope.AskForFilename" then the user will always be asked

Observation - the observation

int - 0-rel ListBlock to update (defined in Observation)

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

See Also:

Observation

 public boolean WriteScanList(String File,
                              Observation Obs,
                              int whichList) throws IllegalArgumentException, IOException

Write schedule ScanList If the scan list is empty and a null name is given then the routine throws an IllegalArgumentException

Parameters:

String - file name (null = ask, or use Save file) if name = Telescope.AskForFilename" then the user will always be asked

Observation - the observation

int - 0-rel ListBlock to update (defined in Observation)

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

Throws: IllegalArgumentException

if List is empty and a nonnull File given

See Also:

Observation

 public boolean ReadObsFile(String File,
                            Observation Obs) throws IllegalArgumentException, IOException

Read Observe List virtual version

Parameters:

String - file name (null = ask)

Observation - the observation

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

 public boolean WriteObsFile(String File,
                             Observation Obs) throws IllegalArgumentException, IOException

Write Observe file virtual version

Parameters:

String - file name (null = ask)

Observation - the observation

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

 public boolean WriteReport(String File,
                            Observation Obs,
                            int type) throws IllegalArgumentException, IOException

Write Report virtual version

Parameters:

String - file name (null = ask)

Observation - the observation

int - report type (defined in Report.java)

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

See Also:

Report

 public boolean ReadSourceFile(String File,
                               Observation Obs) throws IllegalArgumentException, IOException

Read Source list Read a source list from a free format text file virtual version

Parameters:

String - file name (null = ask)

Observation - the observation

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

 public boolean ReadTextObs(String File,
                            Observation Obs) throws IllegalArgumentException, IOException

Read Text Schedule Read a schedule from a free format text file virtual version

Parameters:

String - file name (null = ask)

Observation - the observation

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

 public boolean ReadCalDB(String File,
                          Observation Obs) throws IllegalArgumentException, IOException

Read Calibrator database virtual version

Parameters:

String - file name (null = ask)

Observation - the observation

Returns:

boolean true if worked, else user abort

Throws: IOException

if problem opening, reading or closing

 public void parseHeaderCard(String Card)

Parse Card from beginning of a Scan list virtual version

Parameters:

String - Card image

 public void CheckDB()

Check data base versions This allows the user to see if he/she is using the most recent calibrator lists and NRAO Defaults lists. The current and NRAO current version strings are displayed in a box.

 public void FetchDB()

Fetch database file from NRAO This allows the user to update the version of a file from NRAO. This can be either the Calibrator list or the NRAO Default list.

 public static String StripExtn(String name)

Get filename root Strip any ".*" from a file name

Parameters:

String - file name

Returns:

String stripped file name

All Packages  Class Hierarchy  This Package  Previous  Next  Index