list list_options
print list_options
The list (or print) command specifies which components of the output listing are to be printed, and also provides some control over the format of those sections. list_options is a list of sections that can be included in the output. For example the listing can include the adjusted coordinates of the stations. This section is referred to as station_coordinates in the list command. So to include this section the command required is
list station_coordinates
If the section is not wanted, it can be excluded by prefixing the station name with no_. The command to exclude station coordinates is thus
list no_station_coordinates
Several sections can be included in the same list command, each separated by one or more spaces. Here is a more complex list command
list command_file no_file_summary no_station_coordinates
The following section names can be included in the list command. They are described here in the order that they would appear in an output listing file. Sections marked with an asterisk (*) are output by default.
command_file
Puts a copy of the input command file into the output listing. Note that this does not list included command files or configuration files that also affect the adjustment.
file_summary*
Lists the input data files used in the adjustment. The listing describes the number of each type of observation that have been read from each file.
input_data
Makes a detailed list of the input data. The format of the data is not very readable. This is intended for debugging the program more than for use in interpreting the adjustment.
problem_definition
Summarizes the adjustment that will be done. This section lists the stations that will be adjusted or fixed and the additional parameters that will be calculated in the adjustment.
iteration_summary*
Prints a summary of each iteration which lists the maximum change to a station coordinate.
observation_equations
Prints a list of the least squares observation equations at each iteration. This is intended for debugging purposes only. The equations are output in a JSON format that can be easily imported into many scripting software.
observation_deformation
Prints station deformations that are used to calculate observation equations. This is intended for debugging purposes only.
station_adjustments
Prints a list of all adjustments to station coordinates at each iteration.
solution_summary*
Summarizes the statistics of the solution (number of observations, number of parameters, degrees of freedom, and so on).
station_coordinates*
Prints a list of station coordinates, total adjustments to the coordinates, error ellipses, and height errors.
station_offsets
Prints a list of the offset time series that apply at each station.
floated_stations*
Prints a list of adjustments of floated stations with their significance.
reference_frames*
Prints a list of reference frames used by GPS data. By default reference frames are printed using the same type (geocentric, topocentric, IERS) as they are defined by in the command file. This can be modified with the geocentric_ref_frame, topocentric_ref_frame, and iers_ref_frame options.
geocentric_ref_frame
Includes the geocentric reference frame parameters in the listing.
topocentric_ref_frame
Includes the topocentric reference frame parameters in the listing.
iers_ref_frame
Includes the geocentric reference frame parameters in IERS format.
parameters*
Prints a list of additional parameters of the adjustment with their values and errors.
residuals*
Prints a list of all observations used. By default this includes the residuals errors and standardized residuals for each observation. However the contents of this section can be changed with the define_residual_format and add_residual_column commands.
error_summary*
This section presents accumulated error summaries. By default it presents summaries of the errors for each data file and for each data type. However you can obtain other summaries using the summarize_errors_by command.
worst_residuals*
Prints a list of the worst standardized residual errors in the adjustment. By default the 10 worst residuals are listed. This can be modified with the number_of_worst_residuals command.
The list and print command are also used to modify the presentation of some sections of the output. The following items can be included as list options. Again the options are turned off by prefixing them with no_.
file_locations
Specifies that the data file name and line number will be printed periodically in the otuput listing (see also file_location_frequency).
notes
Specifies that notes associated with observations (using #note in the data file) will be copied to the list of residuals.
distance_ratio_scales
Specifies that the scale factor calculated for distance ratio observations will be included in the list of residuals.
xyz_vector_residuals
Specifies that residuals for vector data types are listed in terms of X, Y, and Z components. The default is to use E, N, U residuals.
rejected_stations
Specifies that rejected stations will be included in the output. If rejection stations are excluded (using list no_rejected_stations) then rejected stations and observations to them are omitted from the output. This causes rejected stations to be treated the same way as ignored stations.
grouped_data_by_type
By default observations are listed in the same order as they occur in the input. If this option is selected then grouped data involving more than one data type are listed showing each type separately. This is often a lot clearer. For example if the input contained grouped data with a horizontal angle and a slope distance on each line. then the output would contain all the distances for the each set followed by all the angles.
sort_stations
By default stations are listed in the listing file in the same order that they appear in the input coordinate file. Using this option causes them to be sorted according to the station code.
form_feeds
By default sections in the output file are separated by form feed characters. These can be suppressed using the no_form_feeds option.