EOVSA Data Analysis Tutorial

Software

Here are some basic information on CASA and the software we are developing:

• SunCASA A wrapper around CASA for imaging and visualizing spectral imaging data of the Sun. ONLY AVAILABLE on UNIX-BASED PLATFORMS (MacOS High-Sierra and later, REDHAT 6 & 7 and equivalents)
• GSFIT
• Obtaining CASA; CASA Guides

SunCASA

Connecting to our AWS server

This is an Amazon AWS Lightsail server for testing purposes. The server has 2 CPUs, 8 GB RAM, and 160 GB SSD storage. It runs CentOS 7 (1901-01) Linux. Please limit your usage to LIGHTWEIGHT DATA PROCESSING ONLY.

NOTE: THE ACCOUNT IS ONLY INTENDED FOR THE EOVSA TUTORIAL, BUT *NOT* FOR CARRYING OUT ACTUAL DATA REDUCTION

• Obtain SSH Key from Bin Chen
• Put it under a secure location on your own machine.
• Follow remaining directions depending on your client machine.

Linux / Mac

Recommend to use "~/.ssh" (create if it does not exist by "mkdir ~/.ssh").

• Edit the permission of ~/.ssh and the key (here I use ~/.ssh as the directory to place your key)

chmod 700 ~/.ssh
chmod 400 ~/.ssh/guest-virgo.pem

• Log on to test AWS server (password-less)

ssh -X -i ~/.ssh/guest-virgo.pem guest@virgo.arcs.az.njit.edu

Enter SunCASA

[guest@ip-172-26-5-203 ~]$ suncasa

Windows (MobaXterm)

Recommend to use "Documents\MobaXterm\home\.ssh"

• Create new session, click SSH, enter virgo.arcs.az.njit.edu for Remote host, guest for username.
• On advanced SSH settings tab, click Use private key, navigate to and select file guest_key.pem
• Close setup window and click the new sessions icon, which will log you in.

Enter SunCASA

[guest@ip-172-26-5-203 ~]$ suncasa

Setup SunCASA on your own machine

MacOS

• Download SunCASA disk image (SunCASA-0.6_Pre-release.OSX.dmg).
• The disk image has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS.
• If you do not have Java SE Development Kit 12 (JDK) installed on your Mac, please download the official JDK installer and install it before SunCASA installation.
• Open the disk image file (if your browser does not do so automatically).
• Drag the SunCASA application to the Applications folder of your hard disk.
• Eject the SunCASA disk image.
• Double-click the SunCASA application to run it for the first time. If the OS does not allow you to install apps from non-Apple sources, please Change the settings in "System Preferences-> Security & Privacy -> General" and "Allow applications downloaded from: Mac App store and identified developers". If the OS still reports that the app is damaged, please turn off the OS Gatekeeper for now by running command sudo spctl --master-disable in Terminal. Then double-click the SunCASA application again.
• Initialize SunCASA. To do so, run !install_suncasa from a SunCASA prompt. This step also allow you to create symbolic links to the SunCASA version and its executables (Administrator privileges are required), which will allow you to run suncasa, casaviewer, casaplotms, etc. from any terminal command line.
• Important: Make sure to turn on the OS Gatekeeper after the installation by running sudo spctl --master-enable in Terminal.
• Optional: To update the data repository, run !update-data from the SunCASA prompt.

Now SunCASA has been successfully installed on your machine. Exit the SunCASA prompt, and run suncasa in Terminal or double-click the SunCASA application to restart SunCASA.

Unix (REL 6 or 7)

• To install SunCASA for Linux, we have packaged up a binary distribution of SunCASA which is available as a downloadable tar file. We believe this binary distribution works with most Linux distributions
• Simply download and untar the distribution. All executables, includingcasapy are in the SunCASA-release-##version##/bin directory.

  tar -xzvf SunCASA-release-##version##.tar.gz

You do not have to have root or sudo permission, you can easily install SunCASA, delete it, move it, and it works for many versions of Linux.

• Include the executables to your path

cd SunCASA-release-##version##/bin
PATH=`pwd`:$PATH 

• Then you can initialize SunCASA with the command in Bash Terminal

install_suncasa

• Optional: To update the data repository, run !update-data from the SunCASA prompt.
• Now SunCASA has been successfully installed on your machine. Open a new Terminal and run suncasa.