.:SVNInstall:home: Difference between revisions

From ADPAA
Jump to navigation Jump to search
m (Protected ".:SVNInstall:home" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
No edit summary
Line 1: Line 1:
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)
The latest source code of the Aircraft Data Processing and Analysis (ADPAA)
package can be downloaded from SourceForge using a Subversion client.  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
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.
Ubuntu.  On Linux, the svn command can be executed from a shell terminal.
The Linux svn command can be use as illustrated below. Note that ADPAA has
Typical svn command related to ADPAA are given below.
been moved from using the Concurrent Version System (csv) to using Subversion
 
(svn) as the version control system.  You can download the binary cplot and
You can download the binary cplot and cplot2 programs if you only need only need
cplot2 programs if you only need only want to display and analyze data, instead
to display and analyze data, instead of processing raw aircraft data files. You
of processing raw aircraft data files. You can also use a windows Subversion
can also use a windows Subversion client to download the source code if you like
client to download the source code if you like to view the code; however, the
to view the code; however, the code is also viewable online via a Web browser.
code is also viewable online via a Web browser. The use of Linux shell scripts
The use of Linux shell scripts and file system commands makes running ADPAA
and file system commands makes running ADPAA under windows impossible.
under Windows impossible.


To download binary (run-time) version of ADPAA
Binary Distribution Download Commands:
   Create directory if necessary - /usr/local/ADPAA if necessary
   mkdir /usr/local/ADPAA
   Change ownership if necessary - chown username /usr/local/ADPAA
    Create directory if necessary.
   Change to ADPAA directory - cd /usr/local/ADPAA
   chown username /usr/local/ADPAA
   Get the latest binary ADPAA release - wget https://sourceforge.net/projects/adpaa/files/ADPAA.tar.gz
    Change ownership if necessary
   Extract data files - tar -xzvf ADPAA.tar.gz
   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):


To download ADPAA source code using svn access.
Source Code Distribution Download Commands (Read Access):
   Create directory /usr/local/ADPAA if necessary
   Create directory /usr/local/ADPAA if necessary
     Change ownership if necessary, i.e. chown username /usr/local/ADPAA
     Change ownership if necessary, i.e. chown username /usr/local/ADPAA
   cd /usr/local/ADPAA
   cd /usr/local/ADPAA
   svn co https://svn.code.sf.net/p/adpaa/code/trunk
   svn checkout svn://svn.code.sf.net/p/adpaa/code/trunk adpaa-code
   cd trunk
   cd adpaa-code
   mv src .svn ..
   mv src .svn ..
   cd ..
   cd ..
   rmdir trunk
   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.


To update ADPAA source code using svn access.
Update Existing Source In Software Repository:
  cd /usr/local/ADPAA/src
   svn update
   svn update


Define and export variables system (typically in /etc/profile and/or /etc/csh.cshrc).
Define System Variables (/etc/profile and/or /etc/csh.cshrc):
   ADPAA_DIR=/usr/local/ADPAA
   ADPAA_DIR=/usr/local/ADPAA
   IDL_PROG=${ADPAA_DIR}/src
   IDL_PROG=${ADPAA_DIR}/src
   PYTHONPATH=${ADPAA_DIR}/src/python_lib
  idl_exe=/usr/bin/idl
   PYTHONPATH=$PYTHONPATH:${ADPAA_DIR}/src/python_lib
   SVN_EDITOR=vim
   SVN_EDITOR=vim
  Add /usr/local/ADPAA/bin to your PATH environmental variable.
  Export the values ADPAA_DIR IDL_PROG PYTHONPATH SVN_EDITOR.


Build (compile) and install executable files by using the followingRequires an IDL license to compile the IDL source code.
    Add /usr/local/ADPAA/bin to your PATH environmental variable.
   Create directory /usr/local/ADPAA/bin
    Export the system variables, ADPAA_DIR IDL_PROG PYTHONPATH SVN_EDITOR idl_exe.
   Create directory /usr/local/ADPAA/sav
 
   Create directory /usr/local/ADPAA/share
  Notes on System Variables.
   cd /usr/local/ADPAA/src/build/ && make
    1.)  idl_exe can be set to /usr/bin/gdl if GDL (GNU Data Language) is
Note to compile the modula requires an IDL license.
        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.


Test the installation by executing a script such as cplot.
Testing ADPAA Installation:
  cplot
  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


If you are an ADPAA developer, you can update a file, such as 'INSTALL', in
Committing to Database:
the SVN database.  Please provide a comment on what is being changed.
   svn commit INSTALL
   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.


If the file is new (i.e. somethingnew), you need to add it to the database
Adding to Database:
before committing it.
   svn add somethingnew
   svn add somethingnew
    New files need to be added to the database before committing it.

Revision as of 03:29, 14 February 2015

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:

 svn update

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.