TSM Program

The program is a small (2.4 Klines) of mixed C, FORTRAN and Tcl/tk. The program can be evoked by the command track as long as the directory /home/scobbie/bin is in your path.

This should run up a small window with the title track and a menu bar running along the top. The menu bar offers four options Commands, Plots, Phase and Help. Some sample files can be found in /home/scobbie/jtrack the best being the number 10 sequence. Naming conventions for files are,

• filename.pol Track polynomials.
• filename.par Track parameters.
• filename.dat Track Surface Data.
• filename.ntm Normalised track surface data.
• filename.raw Raw pointing errors from Wheel model.
• filename.off Moderated pointing errors from wheel model.
• filename.rms RMS of the moderated pointing errors.
• filename.inc Roll, pitch and yaw from simple physical model.
• filename.ppar Parameters for the Wheel model of phase shift.
• filename.pha Phase shifts in x,y,z.
• filename.tpha Total Phase shifts.

The Commands of the TSM are,

• Generate Track: This command invokes a window that allows the user to enter a track description of 14 sections each containing a bowed track section and an end joint. The inputs are the start and end azimuth, the polynomial co-effcients and the end joint data. From this data a plot of track height versus azimuth is made and saved to file.

• Track Parameters: This command invokes a window in which the user can enter details relating to the 'Behavioural Wheel Model' of predicting pointing offsets from relative wheel heights. Inputs are the wheel zero positions, the effects of each wheel in azimuth and elevation in arcsec per micron, the efficiency of the existing software model. The parameters can be saved to file.

• Generate rms Plot: This option takes a track plot file and a file of parameters from the previous two options and produces; a normalised track profile (with the azimuth zeroed at zero on telescope pointing); a file containing the raw errors in azimuth and elevation against azimuth position; a modified file of offsets (errors in azimuth and elevation against azimuth position) with the efficiency of the software Telescope model taken into account; and a file of the rms errors in azimuth and elevation against azimuth position. This option uses a behavioural wheel model of the telescope.

• Simple Physical Model: This command takes a track plot file and a file of parameters (from which it get the wheel zero positions) and generates the roll, pitch and yaw corrections as a function of azimuth position. This option uses a simple mechanical model of the telescope.

• Telescope Model Corrections: This option simulates the workings of the telescope pointing correction software run the Telescope control task. It takes as its input the lookup table file provided by inclinometry[1] and calculates the offsets to azimuth and elevation using the same calculations as the Telescope control task. The offsets are listed into a file along with the azimuth position, the elevation is fixed at 58.0 degrees.

• Exit: Close the program.

The Plot options are,

• Plot Track Profile: This plots for one variable - in this case the track model or normalized track model.
• Plot Track Errors: This will plot for two variables - in this case the azimuth and elevation errors.
• Plot Inclinometry Model: This will plot for three variables- in this case the roll, pitch and yaw of the inclinometry lookup table.
• Plot Phase Shift: This will plot the three variables- Dx, Dy and Dz of the phase shift and also look for and plot the file of the total phase shift.
• Plot Comparisons (Errors): This will plot a comparison of two variables taken from separate files. The files having only two variables.
• Plot Comparisons (Models): This will plot a comparison of two variables taken from separate files. The files having three variables.

The Phase options are,

• Phase Centre Wheel Parameters: This command invokes a window where the user can enter details of a wheel model for the phase centre shift. The entries are changes in x,y and z for each wheel motion of 1.0 micron.
• Wheel Model of Phase: This option takes a normalised track surface and phase centre wheel parameters files and produces the shifts in the phase centre as a function of azimuth.
• Physical Model of Phase: This option takes a normalised track surface and a telescope parameters file and produces the shifts in the phase centre as a function of azimuth.

The Help option offers help on the commands.

Programs that track is dependant upon;

• tsm.c: This C program calculates the behavioral wheel model corrections and produces the normalised track surface.
• mech.c: This C program calculates the simple physical model roll, pitch and yaw for a given track surface.
• sim-tel.f: This FORTRAN program executes the calculations done inside the Telescope task for pointing. Using the roll, pitch and yaw from and Inclinometry file it calculates the error in azimuth and elevation.
• phase.c: This C program does a very poor physical estimation of the shift in phase centre.
• pwm.c: This C program calculates the Wheel Model for phase centre shifts.