.:SVNInstall:home

From ADPAA
Revision as of 21:33, 16 April 2015 by Davidjdelene (talk | contribs)
Jump to navigation Jump to search

The Aircraft Data Processing and Analysis (ADPAA) software package is avaivalbe as a binary (compiled) distribution and a source code distribution. Both distributions are available on the Source Forge ADPAA site, http://sourceforge.net/projects/adpaa/. The binary distribution is available as a single compressed archive file, ADPAA.tar.gz. The ADPAA.tar.gz file can be download from http://sourceforge.net/projects/adpaa/files/. Details instructions are given below to download the ADPAA binary distribution.

The latest source code of the Aircraft Data Processing and Analysis (ADPAA) package can be downloaded from SourceForge using a Subversion client. ADPAA is designed to run on the Linux OS and has been tested on Redhat, Fedora, and Ubuntu. On Linux, the svn command can be executed from a shell terminal. Typical svn command related to ADPAA are given below.

You can download the binary cplot and cplot2 programs if you only need only need to display and analyze data, instead of processing raw aircraft data files. You can also use a windows Subversion client to download the source code if you like to view the code; however, the code is also viewable online via a Web browser. The use of Linux shell scripts and file system commands makes running ADPAA under Windows impossible.

Binary Distribution Download Commands:

 mkdir /usr/local/ADPAA
   Create directory if necessary.
 chown username /usr/local/ADPAA
   Change ownership if necessary
 cd /usr/local/ADPAA
   Change to ADPAA directory
 wget https://sourceforge.net/projects/adpaa/files/ADPAA.tar.gz
   Get the latest binary release
 tar -xzvf ADPAA.tar.gz
   Extract data files
 ADPAA_DIR=/usr/local/ADPAA
   Define the ADPAA System Variables (/etc/profile and/or /etc/csh.cshrc):

Source Code Distribution Download Commands (Read Access):

 Create directory /usr/local/ADPAA if necessary
   Change ownership if necessary, i.e. chown username /usr/local/ADPAA
 cd /usr/local/ADPAA
 svn checkout svn://svn.code.sf.net/p/adpaa/code/trunk adpaa-code
 cd adpaa-code
 mv src .svn ..
 cd ..
 rmdir adpaa-code

Source Code Distribution Download Commands (Read/Write Access):

 svn checkout --username=name svn+ssh://name@svn.code.sf.net/p/adpaa/code/trunk adpaa-code
   Where name is developer's username.  The lead developer, David Delene, has
   to give include you as a ADPAA developer.

Update Existing Source In Software Repository:

 cd /usr/local/ADPAA/src
 svn update
 cd build
 ./install_adpaa.bash

Define System Variables (/etc/profile and/or /etc/csh.cshrc):

 ADPAA_DIR=/usr/local/ADPAA
 IDL_PROG=${ADPAA_DIR}/src
 idl_exe=/usr/bin/idl
 PYTHONPATH=$PYTHONPATH:${ADPAA_DIR}/src/python_lib
 SVN_EDITOR=vim
   Add /usr/local/ADPAA/bin to your PATH environmental variable.
   Export the system variables, ADPAA_DIR IDL_PROG PYTHONPATH SVN_EDITOR idl_exe.
 Notes on System Variables.
   1.)  idl_exe can be set to /usr/bin/gdl if GDL (GNU Data Language) is
        install instead of IDL
   2.)  System variable "verbose_mode" can be set to:
        0 - Suppress output
        1 - Provide additional information to termial.
   3.)  System variable "virtual_machine" can be set to:
        0 - Force use of the binary version of ADPAA (No IDL Licence)
            Use binary IDL files from /usr/local/ADPAA/sav
        1 - Force use of the source code version of ADPAA (Requires IDL Licence)
            Compiles IDL code before execution.

Building:

 mkdir /usr/local/ADPAA/bin
 mkdir /usr/local/ADPAA/sav
 mkdir /usr/local/ADPAA/share
 cd /usr/local/ADPAA/src/build/ && ./install_adpaa.bash

Build Requirements:

 An Interactive Data language (IDL) license is required to compile the ADPAA
 source code.  Some modules are able to be compile using GNU Data Language
 (GDL).  While the majority of ADPAA code is written in IDL, ADPAA contains
 perl, BASH, CSH, C, FORTRAN, python, and tcl code.

Testing ADPAA Installation:

 Start the cplot2 GNU for displaying data from files.
   cplot2
 Conduct Level 1 processing of raw M300 data system file.
   cp -r /usr/local/ADPAA/src/TestData/FlightData ~
   cd ~/FlightData/20140429_152103/PostProcessing
   process_raw 14_04_29_15_21_03.sea
 Conduct Level 1-4 processing of raw M300 data system file.
   cp -r /usr/local/ADPAA/src/TestData/FlightData ~
   cd ~/FlightData/20140429_152103/PostProcessing
   process_all 14_04_29_15_21_03.sea
 Conduct processing of a aircraft flight.
   cp -r /usr/local/ADPAA/src/TestData/FlightData ~
   cd ~/FlightData/20140429_152103/
   process_all_iphex

Committing to Database:

 svn commit INSTALL
   ADPAA developer can update a file, such as 'INSTALL', in the SVN database.
   Please provide a comment on what is being changed.

Adding to Database:

 svn add somethingnew
   New files need to be added to the database before committing it.