Atmos Wiki

You can download the ADPAA file from Airborne Data Processing and Analysis (ADPAA).

Using the link above (Under Download), you can access the ADPAA repository on the Source Forge website by using the “Code” tab, selecting the folder “trunk,” then “src.” Alternatively, to access the repository on your personal device outside of Source Forge, you can download a subversion client.

* Current knowledge is limited to Windows - Update with discovery *

You will need to download a SVN Client. For Windows, the author of this page recommends TortoiseSVN, but it is good to analyze your options and determine what will work best for you. * You can download TortoiseSVN here.

After downloading the ADPAA file and an SVN client from the website above, find its location in your computer files. With TortoiseSVN, you can right click on the file (filename is usually “ADPAA.tar.gz”) and select TortoiseSVN > Repo-browser

You will be prompted to enter a URL. Navigate back to the Source Forge website (where you downloaded the ADPAA repository from), and tab over to the “Code” tab. You should see a text box with the options “SSH,” “HTTPS,” and “RO” displayed to the left of it. Select “HTTPS” and copy the link, starting at “https:”. This is the URL you'll submit to TortoiseSVN.

This allows you access the ADPAA a different way.

Typically, this is only done on measurement devices to allow access to the code created for data acquisition, such as a Raspberry Pi.

Please skim through the instructions and read the troubleshooting section before beginning. It will likely save some frustration.

After downloading the ADPAA onto your Raspberry Pi from the link above, you will find it in your “Downloads” folder.

1. In your home directory, create two folders: “ADPAA” and “CoPAS”.
2. Move the downloaded ADPAA.tar.gz from the “Downloads” folder to the “ADPAA” folder.
3. Right click on the file (ADPAA.tar.gz) and select “Extract Here”
4. After this, run the command “sudo apt upgrade” to make sure the computer is updated and every package installed.
5. Additionally, run the command “sudo apt-get install subversion”, otherwise, you'll run into some issues later.
6. Once it has finished, open the folder, “share” and select the text files entitled “INSTALL” and “bashrc-adpaa”
7. Open the “bashrc-adpaa” file and scroll to find text that will say

  PATH=${ADPAA_DIR}/bin:${PATH}
  PYTHONPATH=${ADPAA_DIR}/bin:${PYTHONPATH}

1. Using the terminal, type the command “sudo nano ~/.bashrc”, then scroll to the bottom of the file and enter the above text.
   1. Note: Replace ${ADPAA_DIR} with the absolute path to the ADPAA/bin directory. It should be /home/pi/ADPAA/bin, unless your Raspberry Pi is not named “pi”
2. In addition, add the following text as well.

  PATH=/home/pi/CoPAS/ADPAA/bin:${PATH}
  PYTHONPATH=/home/pi/CoPAS/ADPAA/bin:${PYTHONPATH}

1. Save the file and exit.
2. Type the command “source ~/.bashrc”
3. Open the ADPAA INSTALL file and follow the instructions very carefully. Do not skip any steps or think that you may disregard them.
4. After you complete the “Developer Version Source Code Download of Package (Read Access)” step, enter your file tree and copy the folder titled “src” out of the folder titled “adpaa-code” and into your main “ADPAA” folder.
5. You will also have to do this in the directory /usr/local/ADPAA
   1. use the command “sudo cp -r /usr/local/ADPAA/adpaa-code/src /usr/local/ADPAA”
6. When doing the “Setting up Python3 for ADPAA Distribution” step, you will have to add “- - break-system-packages” to the end of the “pip3 install…” command.
7. After the “pip3 install…” command section, return to your home directory and enter the command “adpaa setup”
   1. If you've done everything correctly up to this point, the terminal will tell you to run the command “source ~/.bashrc”
   2. If not, go back and find out where an error occurred.
8. Finally, follow the instruction in the ADPAA INSTALL file to run the “make && make -f Makefile_osa” command

Trouble Shooting:

• You will likely encounter an error that says “Permission denied” or something similar along the way. If this occurs, try adding the root command “sudo” to the beginning of the line. If that doesn't work, the program will tell you, and you can try “sudo apt” in cases where you are installing or downloading something.
• When following the INSTALL instructions, when it says “${ADPAA_DIR}” or similar, you should use “~/ADPAA” instead if it doesn't work.