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

VieVS User Workshop 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).

VieVS User Workshop 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.

VieVS User Workshop Downloading VieVS using rsync On Unix/Linux systems, VieVS can easily be downloaded using the rsync command: rsync -aL 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/*'

VieVS User Workshop 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 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

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

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

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

VieVS User Workshop 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/

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

VieVS User Workshop 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

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

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

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

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

VieVS User Workshop 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.

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

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

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

VieVS User Workshop 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

VieVS User Workshop 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

VieVS User Workshop 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

VieVS User Workshop 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

VieVS User Workshop 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

VieVS User Workshop 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

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

VieVS User Workshop 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.

VieVS User Workshop 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.

VieVS User Workshop 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!