====== TITAN User Guide & Trouble Shooting ====== Titan is used for overlaying flight paths. ===== Required packages before installing Lrose and TITAN ====== Make sure to have the following packages installed and up-to-date before installing Lrose and TITAN.To do that, start by: sudo dnf upgrade (sudo yum upgrade on Redhat 7) The sudo command will require you to enter a password, so make sure you're able to operate under root. The required packages are as followed: Install epel-release repository. sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm Install additional packages. tcsh perl perl-Env ftp git emacs tkcvs m4 gcc gcc-c++ (c++) gcc-gfortran (gfortran) glibc-devel libX11-devel libXext-devel libpng-devel libtiff-devel jasper-devel zlib-devel libexpat-devel (May have to get from rpmfind) flex-devel fftw3-devel bzip2-devel qt4-devel gnuplot ImageMagick-devel ImageMagick-c++-devel xrdb Xvfb (virtual X server), specifically xorg-x11-server-Xvfb sshd (ssh logins) xorg-x11-fonts-misc xorg-x11-fonts-75dpi xorg-x11-fonts-100dpi It is not a bad idea to go through and try to install each package, just to make sure they are actually present on the computer after doing the update. To install each package simply do: % sudo dnf install thenenterthepackagesnameherewithspacesbetween ===== How to install Lrose and TITAN with latest update ===== With recent updates from NCAR, TITAN is now part of a larger program called LROSE (Lidar Radar Open Software Environment). To be able to being installing TITAN, you must first download the latest release of LROSE from the NCAR github repository. First you will need to create an area to download the release to: mkdir release This can be named anything you'd like but NCAR suggests **"release"** or **"bin_test_area"** After the directory is created you need to enter the directory and download the release: cd release wget https://github.com/NCAR/lrose-core/archive/lrose-blaze-20180911.tar.gz It is important to check what the latest release is in the repository, but it will be close in resemblance to the release above. Once the release is downloaded, untar the file: tar -xvzf lrose-* This will create a folder titled **"lrose-*"**. change to new diretory: cd lrose-core* To build LROSE using standard method: build/checkout_and_build_auto.py --debug --prefix ~/lrose --package lrose-blaze That will install lrose and install the necessary files within the ~/lrose directory. Once lrose is installed, TITAN will now have its required prerequisites to be able to be installed. To be able to install TITAN the tcsh shell must be used. **Tcsh** or **csh** can be used, both operate the same on linux. When downloading TITAN, there are different templates to choose from found at: https://github.com/NCAR/titan-templates/releases From there, download the latest release available, such as: titan_template_single_radar.20180101.tgz or titan-20180102.x86_64.tgz At this point, you are unable to use **wget** to download the release, so you will need to make sure you transfer this file from download to the same folder the lrose release was put into. From there: % tar xvfz titan_template_single_radar.20180101.tgz % ls then run the provided script of: % ./INSTALL_TITAN This will install the template files into the standard directory of **projDir** and will also install a shell startup file **.cshrc** Then from the the home directory: % cd % source .cshrc then to run TITAN: % start_all To stop TITAN: % stop_all ===== How to set up your Home directory to use TITAN ===== In order for TITAN to run for a specific user, symbolic links must created and a .tcshrc file copied. Open a terminal window and create the following links in your /home/user/ directory by typing: % ln -s /titanradar/projDir.GrandForks/ projDir.GrandForks % ln -s projDir.GrandForks/ ProjDir These commands create links to data folders used by TITAN. Next, the titan install folder must be linked to a folder called rap by typing: % ln -s /usr/local/(titan install folder, ex: titan5-20130427)/ rap The .tcshrc file must be obtained by copying it from another location. For example, this command will copy it from Aitken. % scp -P 22000 aitken.atmos.und.edu:.tcshrc . The last two commands will source the .tcshrc file, which is done while in the tcsh shell. % tcsh % source .tcshrc ===== NCAR RAP Documentation ===== Things you should read before getting started to better understand TITAN: [[http://www.ral.ucar.edu/projects/titan/docs/TitanInstall.pdf|Installing TITAN]] \\ [[http://www.ral.ucar.edu/projects/titan/docs/titan_display_guide.saws.pdf|Using the TITAN Display]] \\ [[http://www.ral.ucar.edu/projects/titan/docs/titan_analysis_guide.saws.pdf|TITAN Analysis Guide]] \\ [[http://www.ral.ucar.edu/projects/titan/docs/TitanDataFlow.pdf|TITAN Data Flow]] \\ For further reading go to [[http://www.ral.ucar.edu/projects/titan/home/history.php|NCAR's TITAN]] page. The best way to learn TITAN is by practicing with it. ===== UND NorthPol Configuration ===== All local computers should have //atmosnfs.aero.und.edu/TitanRadar mounted as /titanradar. To have Titan work with NorthPol radar data ~/projDir.GrandForks should be symbolically linked to /titanradar/projDir.GrandForks/ Radar1 (radar1.atmos.und.edu) pushes raw data via the IRIS software program to /raw_local directory on titan.atmos.und.edu using SCP (via operator user and ssh keys). On Titan /titanradar/projDir.GrandForks/data/radar/raw is symbolically linked to /raw_local. The Sigmet2Dsr script processes the raw radar data in Sigmet format to Dsr format. The Dsr2Vol script processes the Dsr format data to create processed data that Titan can display. ===== Parameter Files ===== \\ To find an executable script find look in the TITAN guides or /polcast2/titan5/rap/bin \\ All executables follow the same syntax for help information: % commandName -h \\ To obtain the parameter file follow the given argument (usually print_params) remembering the 'verbose' keyword: % commandName -print_params verbose > commandName.params \\ This will output all the parameters for 'commandName' into a file called commandName.params \\ Once the parameter file has been altered as needed pass it as an argument for the -params flag, e.g.: % commandName -params commandName.params ==Scripts for analysis of POLCAST data in the order they should be used:== Dsr2Vol * Description: Should be run before Sigmet2Dsr * Parameter File Example: {{:atmos:software:dsr2vol.params.rtf|Dsr2Vol.params}} Sigmet2Dsr * Description: Used in conjunction with Dsr2Vol to turn Sigmet raw data into TITAN MDV format: * Parameter File Example: {{:atmos:software:sigmet2dsr.params.rtf|Sigmet2Dsr.params}} \\ ctrec * Description: Derives wind data from TITAN cell advection vectors: \\ * Parameter File Example: {{:atmos:software:ctrec.params.rtf|ctrec.params}} \\ EsdAcIngest * Description: Creates aircraft tracks with ASCII input file: \\ * Parameter File Example: {{:atmos:software:esdacingest.params.rtf|EsdAcIngest.params}} \\ AcTrack2Polygon * Description: Draws polygon around tracks for a specified length of time: \\ * Parameter File Example: {{:atmos:software:actracks2polygon.n37360.rtf|AcTrack2Polygon.params}} \\ * Execute Example: AcTrack2Polygon -debug -start "2008 06 13 18 49 00" -end "2008 06 13 19 00 00" -params '/titanradar/projDir.GrandForks/params/AcTrack2Polygon.params' AdvectPolygon * Description: Advects the polygon while monitoring its average rain rate (ZDR): \\ * Parameter File Example: {{:atmos:software:advectpolygon.params.rtf|AdvectPolygon.params}} \\ ===== Creating Radar Loops in TITAN ===== ==== With Rview ==== * To create images with Rview just right click on copy. * Right clicking on copy creates a *.gif image. * The images will be saved in "$DATA_DIR/images/cappi" * The full path of the images on titan5 is "/polcast2/titan5/projDir/data/images/cappi" ==== With CIDD ==== * First find the radar images that you want to use * To do this click on "Movie" * Click on "Archive" on the left hand side of the window that pops up * Also click on the time and date on the upper right hand side of the window and input the time and date that you want. Then hit enter. * This should display the image at the time and date. * Select number of frames that you want in your loop * Select "Start" ===== Trouble Shooting ===== === Problem === setenv TITAN_SRC_DIR /home/titan5/rap /home/titan5/rap/distribs/wxmod/titan_build Gives the following error: /usr/bin/ld: skipping incompatible /usr/lib/libfl.a when searching for -lfl /usr/bin/ld: skipping incompatible /usr/lib/gcc/x86_64-redhat-linux/4.1.2/../../../../lib/libfl.a when searching for -lfl /usr/bin/ld: skipping incompatible /usr/lib/../lib/libfl.a when searching for -lfl /usr/bin/ld: skipping incompatible /usr/lib64/libfl.a when searching for -lfl /usr/bin/ld: skipping incompatible /usr/lib/libfl.a when searching for -lfl === Cause === *No /usr/lib/libfl.a on 64 bit computer. Only /usr/lib64/libfl.a === Solution === *Copy /usr/lib/libfl.a from a 32 bit Redhat computer into /usr/lib/libfl.a *This resulted in /home/titan5/rap/distribs/wxmod/titan_build working. === Problem === When creating a new user account on the Titan computer (CH601), problem with permissions for running the Titan software. Error: "Cannot locate Procmap.pm in @INC" === Cause === *Command "use Procmap" in start-up files. Wrong permissions for files. === Solution === *When creating a new user, you must copy the Titan files using a tar file. *Tar all files in rap/ and move them into the new user's files.