site2gps is a program to create a data file of "dummy" GPS observations between stations in a coordinate file. This can be used to assist in network design before carrying out a survey.
The typical usage would include the following steps:
Create a SNAP coordinate file with the stations to be surveyed and their approximate coordinates.
Run site2gps to generate a data file of vectors between the stations. This can either generate specific vectors, or all possible vectors between the stations. Usually this would include the vectors in the proposed survey.
Edit the generated data file to specify the expected accuracy of the GPS observations.
Create/edit a SNAP command file using the station file and data file. This will include specifications of which stations are to be fixed. This will typically be a "network analysis" mode adjustment.
Run SNAP to determine the expected accuracies of the surveyed points.
Analyse the output with snapplot, snapspec, or by reviewing the listing file to see whether the required coordinate accuracies are achieved.
The program requires as input a SNAP coordinate file and optionally a file listing the proposed observations.
The proposed observation file is a simple text file on which each line contains a set two or more station codes (separated by space characters). site2gps can generate either a multistation data set including each station in the set, or a set of vectors between each pair of stations.
To run the program use the command
site2gps [options] coord_file line_list_file output_file
or
site2gps -a [options] coord_file output_file
The program can take the following options:
-b | Generate individual baselines between pairs of stations rather than multistation GPS observations. |
-c# | Specifies that lines less than # kilometers will not be generated |
-f# | Specifies that lines greater than # kilometers will not be generated |
-n# | Specifies that no more than n stations will be connected to each base station (these will be the n closest stations, not including any excluded by the -c parameter |