Overwiev of VieVS: Installation, files, structure of the program

1. Tobias Nilsson Overwiev of VieVS:Installation, files, structure of the program

2. VieVS User Workshop 2010 System Requirements MATLAB 7.6 (R2008a) or later. About 6.4 GB of disk space, including all data files (just source code: <10 MB). Should work with any operating system able to run this MATLAB version (tested on Windows and Linux). Possible to run on older MATLAB version if the Graphical User Interface is not used. With minor corrections to the source code, it should also be possible to run VieVS on e.g. Octave (except for the GUI).

3. VieVS User Workshop 2010 Downloading VieVS VieVS can be downloading using ssh/sftp from the server: vievs1.hg.tuwien.ac.at Log in to the server as user vievsuser, download the VieVS directory.

4. VieVS User Workshop 2010 Downloading VieVS using rsync On Unix/Linux systems, VieVS can easily be downloaded using the rsync command: rsync -aL vievsuser@vievs1.hg.tuwien.ac.at:VieVS . The same command can also be used to to update your VieVS installation. To skip the NGS files (e.g. slow connections): rsync -aL --exclude 'DATA/NGS/*' vievsuser@vievs1.hg.tuwien.ac.at:VieVS .

5. Download VieVS using a sftp client • Log in to the server with your favourite sftp client (e.g. FileZilla, WinSCP). • Download the VieVS directory (to download everything). VieVS User Workshop 2010

6. VieVS User Workshop 2010 Updating VieVS Regularly update: (in order to analyse new sessions) VieVS/DATA/NGS directory VieVS/ATM directory VieVS/VM1 directory VieVS/EOP/C04_05_1962_now.txt When a new version is released: VieVS/COMPILE directory .m-files in VieVS/WORK and VieVS/OUT directories Other files, specified when the update is announced

7. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

8. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ Tidal atmospheric loading coefficients COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

9. VieVS User Workshop 2010 VieVS directories ATIDE/ 1979/ 1980/ ATM/ ... COMPILE/ 2010/ CRF/ DATA/ Non-tidal atmospheric loading DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

10. VieVS User Workshop 2010 VieVS directories VIE_SETUP_V1c/ ATIDE/ VIE_INIT_V1c/ ATM/ VIE_MOD_V1c/ COMPILE/ VIE_LSM_V1c/ CRF/ VIE_GLOB_V1c/ DATA/ VIE_SIM_V1c/ DOC/ VieVS/ ... EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ VieVS source code TRF/ VM1/ WORK/

11. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ Celestial reference frame COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

12. VieVS User Workshop 2010 VieVS directories ATIDE/ LEVEL0/ Data from VIE_INIT LEVEL1/ Data from VIE_MOD ATM/ LEVEL2/ Data from VIE_LSM (for VIE_GLOB) COMPILE/ LEVEL3/ Data from VIE_LSM CRF/ LEVEL4/ Data from VIE_SIM DATA/ MASTER/ Master files DOC/ VieVS/ NGS/ VLBI data in NGS format EOP/ OPT/ Option files EPHEM/ OUTLIER/ Outliers OTIDE/ SIM/ Simulated NGS files OUT/ TURB/ Data needed by VIE_SIM THERMDEF/ GLOB/ Data needed by VIE_GLOB TRF/ VM1/ WORK/

13. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ Some documentation DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

14. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ Earth Orientation data EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

15. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ Ephemeris of the Sun and the planets. EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

16. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ Tidal ocean loading OUT/ THERMDEF/ TRF/ VM1/ WORK/

17. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ Some scripts for e.g. creating eop output files, sinex files etc. OUT/ THERMDEF/ TRF/ VM1/ WORK/

18. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ Thermal deformation TRF/ VM1/ WORK/

19. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ OUT/ Terrestrial reference frame THERMDEF/ TRF/ VM1/ WORK/

20. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ CRF/ Vienna mapping function coefficients DATA/ DOC/ VieVS/ EOP/ EPHEM/ OTIDE/ 1979/ OUT/ 1980/ THERMDEF/ ... TRF/ 2010/ VM1/ WORK/

21. VieVS User Workshop 2010 VieVS directories ATIDE/ ATM/ COMPILE/ Main Work directory: run VieVS from here CRF/ DATA/ Predefined parameter files DOC/ VieVS/ Predefined process lists EOP/ EPHEM/ OTIDE/ PARAMETERS/ OUT/ PROCESSLIST/ THERMDEF/ TRF/ vievs.m VM1/ ... WORK/ Main VieVS program

22. VieVS User Workshop 2010 The parts of VieVS VIE_SETUP Setup of processing Graphical User Interface VIE_INIT Reads the data VIE_MOD Calculate the theoretical delay and the partial derivatives VIE_LSM Least squares adjustment VIE_SIM VIE_GLOB Global solution Simulation tools

23. VieVS User Workshop 2010 VIE_SETUP: Creates: WORK/process_list.mat: list of sessions to be processed WORK/runp.mat: Some general information about theprocessing, e.g. which parts of VieVS to be run. Parameter files in the DATA/LEVEL0/ directory. Contains the options for the analysis. One for each session in the process list. Name: SESSIONNAME_parameter.mat, e.g. 08AUG12XA_N004_parameter.mat. Files used and created by different parts of VieVS

24. VieVS User Workshop 2010 VIE_INIT: Reads: Parameter file from DATA/LEVEL0/ directory (e.g. 08AUG12XA_N004_parameter.mat). Outlier file. OPT file. Creates structure arrays saved in DATA/LEVEL0/: antenna: list of stations in the session (saved as e.g. 08AUG12XA_N004_antenna.mat). sources: list of sources observed in the session (saved as e.g. 08AUG12XA_N004_sources.mat). scan: list of scan (saved as e.g. 08AUG12XA_N004_scan.mat). Files used and created by different pars of VieVS

25. VieVS User Workshop 2010 VIE_MOD: Reads: The parameter, antenna, sources, and scan structure arrays from the DATA/LEVEL0/ directory. Creates: Saves the parameter, antenna, sources, and scan structure arrays from the DATA/LEVEL1/ directory (file names same as in DATA/LEVEL0/). Files used and created by different pars of VieVS

26. VieVS User Workshop 2010 VIE_LSM: Reads: The parameter, antenna, sources, and scan structure arrays from the DATA/LEVEL1/ directory. OPT file Creates: DATA/LEVEL3/: x_ (e.g. x_08AUG12XA_N004.mat) contains the estimated parameters. opt_ (e.g. opt_08AUG12XA_N004.mat) contains the lsm options. apta_, atpl_: normal equation matrices. DATA/LEVEL2/: Data for global solution. DATA/OUTLIER/: Detected outliers Files used and created by different pars of VieVS

27. VieVS User Workshop 2010 How to start VieVS Start MATLAB Change directory to the VieVS/WORK/ directory Run: vievs The GUI of VieVS should now be seen

28. VieVS User Workshop 2010 To just run VIE_SETUP In MATLAB, run: vievs('setup') A files will be prepared (process_list, runp, parameter files) but no processing will be done.

29. VieVS User Workshop 2010 Run VieVS in batch mode To run in batch mode (without GUI): vievs('batch') Requires that all files (parameter files, process_list, runp) have already been prepared.

30. VieVS User Workshop 2010 Run an older version of VieVS To e.g. run version 1b: vievs('1b') (Replace '1b' with the version you want to run.) To run version 1b in batch mode: vievs('1b','batch') Never mix different VieVS versions!