output output_options
The output command is used to control output of the files other than the listing file. Its syntax is very similar to that for the list command - it may be followed by several options separated by spaces. Each option can be negated by preceding it with "no_", for example "no_binary_file". The options that are available with the output command are:
binary_file
Creates a binary file which is used by SNAPPLOT and other programs to obtain information about the adjustment for subsequent display and processing.
decomposition
Includes the choleski decomposition of the normal equations in the binary file. This may be used by analysis programs, eg snapspec.
relative_covariances [under max_length] [between station_list]
Includes relative station coordinate covariance information in the binary file. This happens by default for observed vectors. This command can be used to suppress covariance information (no_relative_covariances), or to add additional vectors. Note that additional vectors are included in the station reordering and may affect the efficiency of the adjustment. If all possible vectors are required then the "output all_relative_covariances" option should be used as it does not affect the station reordering and the efficiency of the calculation phase of snap. To add vectors specify the maximum length of vector, and/or a list of stations between which vectors are required. The if both options are supplied then only vectors between the listed stations and less than the maximum length will be included. This command can be used multiple times to compile the required vectors. Not that the maximum length test is based in the a priori coordinates, not on the calculated final coordinates. Using this can make analysis programs such as snapspec more efficient to run.
all_relative_covariances
Includes complete station coordinate covariance information in the binary file. This may be used by analysis programs, eg snapspec. Note that for a large adjustment this can generate a very large binary file.
coordinate_file
Creates a new version of the station coordinate file.
rejected_station_coordinates
By default rejected and ignored stations are copied into the new coordinate file. The can be omitted by using the no_rejected_station_coordinates option.
sinex
Creates a SINEX format file of the coordinates and covariances calculated. Note that this will only properly represent the solution if all stations involved in the adjustment are freely adjusted in three dimensions. Constrained stations will not be included if fully constrained. Stations adjusted in one or two dimensions will be included, but the covariance matrix in the SINEX file will be singular. If the adjustment includes additional parameters then these will not be included in the output, so the number of parameters in the SOLUTION SUMMARY block of the SINEX file will not match the number in the covariance matrix. The SINEX solution date is based on the mid date of the input observations. If the adjustment uses a deformation model or station offset file then this may misrepresent the effective date of the coordinates.
covariance_json
Creates a JSON formatted text file listing the station coordinates calculated and their covariance matrix. This may be used as input to other programs.
solution_json
Creates a JSON formatted text file listing the solution parameters, statistics, and the covariance matrix of the solution.
covariance_matrix_file
Creates a text file listing the covariance matrix of the derived coordinates. This may be used as input to other programs. This is a legacy command - it is recommended that SINEX or covariance_json options are used instead.