1. VieVS User Workshop 7 – 9 September, 2010 Vienna Overwiev of VieVS: Installation, files, structure of the program Tobias Nilsson

2. VieVS User Workshop 20102 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 20103 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 20104 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. VieVS User Workshop 20105 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).

6. VieVS User Workshop 20106 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 20107 VieVS directories VieVS/ ATIDE/ ATM/ COMPILE/ CRF/ DATA/ DOC/ EOP/ EPHEM/ OTIDE/ OUT/ THERMDEF/ TRF/ VM1/ WORK/

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

23. VieVS User Workshop 201023 VIE_SETUP: Creates: WORK/process_list.mat: list of sessions to be processed WORK/runp.mat: Some general information about the processing, 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 201024 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 201025 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 201026 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 201027 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 201028 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 201029 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 201030 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!