====== 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:
<code> sudo dnf upgrade </code>
(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. 
<code> sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm </code>

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:

<code> mkdir release </code>

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:
<code> cd release </code>
<code> wget https://github.com/NCAR/lrose-core/archive/lrose-blaze-20180911.tar.gz </code>

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:

<code> tar -xvzf lrose-* </code>

This will create a folder titled **"lrose-*"**. 
change to new diretory:

<code> cd lrose-core* </code>

To build LROSE using standard method:

<code> build/checkout_and_build_auto.py --debug --prefix ~/lrose --package lrose-blaze </code>

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:

<code> https://github.com/NCAR/titan-templates/releases </code>

From there, download the latest release available, such as:

<code>  titan_template_single_radar.20180101.tgz </code>
or 
<code> titan-20180102.x86_64.tgz </code>

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:
<code> % tar xvfz titan_template_single_radar.20180101.tgz </code>
<code> % ls </code>
then run the provided script of:
<code> % ./INSTALL_TITAN </code>
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:
<code> % cd </code>
<code> % source .cshrc </code>

then to run TITAN:
<code> % start_all </code>

To stop TITAN:
<code> % stop_all </code>

===== 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:
<code> % ln -s /titanradar/projDir.GrandForks/ projDir.GrandForks </code>
<code> % ln -s projDir.GrandForks/ ProjDir </code>
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:
<code> % ln -s /usr/local/(titan install folder, ex: titan5-20130427)/ rap </code>

The .tcshrc file must be obtained by copying it from another location.
For example, this command will copy it from Aitken.
<code> % scp -P 22000 aitken.atmos.und.edu:.tcshrc . </code>

The last two commands will source the .tcshrc file, which is done while in the tcsh shell.
<code> % tcsh </code>
<code> % source .tcshrc </code>


===== 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:
<code> % commandName -h </code> 
\\ To obtain the parameter file follow the given argument (usually print_params) remembering the 'verbose' keyword:
<code> % commandName -print_params verbose > commandName.params </code>
\\ 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.:
<code> % commandName -params commandName.params </code>

==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.