Difference between revisions of "SunCASA Installation"

From EOVSA Wiki
Jump to: navigation, search
(MacOS)
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
[https://github.com/suncasa/suncasa SunCASA] A Python package based on [https://casa.nrao.edu/ CASA (the Common Astronomy Software Applications package)], which includes customized routines and scripts for visualizing and analyzing spectral imaging interferometric data specific to solar radio astronomy use cases.
 +
* CASA is one of the leading software tool for "supporting the data post-processing needs of the next generation of radio astronomical telescopes such as ALMA and VLA", an international effort led by the [https://public.nrao.edu/ National Radio Astronomy Observatory]. The current version of CASA uses Python (2.7) interface. More information about CASA can be found on [https://casa.nrao.edu/ NRAO's CASA website ]. Note, CASA is available ONLY on UNIX-BASED PLATFORMS (and therefore, so is SunCASA).
 +
* All solar-specific core routines of SunCASA are available publicly at the [https://github.com/suncasa/suncasa suncasa Github repository]. However, they '''require CASA to function'''. We provide standalone packages that already include CASA (see below), in order to easily use SunCASA without the need to install CASA separately.
 +
 +
SunCASA is designed for reducing, visualizing, and analyzing solar interferometric data that adopt the standard CASA measurement set format. We have had success in using SunCASA for data from the [http://www.ovsa.njit.edu/ Expanded Owens Valley Solar Array (EOVSA)] and [https://science.nrao.edu/facilities/vla Karl G. Jansky Very Large Array (VLA)]. Modules could be added to  the package to enable the analysis of data from other telescopes (such as ALMA). We encourage our colleagues in the community to help us test and improve the software.
 +
 
=MacOS=
 
=MacOS=
 
We provide a standard disk image (dmg) for installation on MacOS. This is a repack of [https://casa.nrao.edu/casa_obtaining.shtml CASA 5.6.0-2] with additional site packages/scripts specifically wrote for solar data analysis. It has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS. Installation steps below:
 
We provide a standard disk image (dmg) for installation on MacOS. This is a repack of [https://casa.nrao.edu/casa_obtaining.shtml CASA 5.6.0-2] with additional site packages/scripts specifically wrote for solar data analysis. It has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS. Installation steps below:
# Download [https://drive.google.com/file/d/1OwFTp_bLZKL9wgPm4G8l5DrtB4JyelQ_/view?usp=sharing SunCASA disk image (SunCASA-0.7.6_Pre-release.OSX.dmg)].  
+
# Download [https://drive.google.com/file/d/1OwFTp_bLZKL9wgPm4G8l5DrtB4JyelQ_/view?usp=sharing SunCASA disk image (SunCASA-0.7.6_Pre-release.OSX.dmg)]. (536 MB)
 
# If you do not have Java SE Development Kit (JDK) installed on your Mac, please download from the [https://www.oracle.com/technetwork/java/javase/downloads/jdk12-downloads-5295953.html official site] and install it before SunCASA installation. The latest version (JDK 12) was tested to work properly. Earlier versions may also work but YMMV.
 
# If you do not have Java SE Development Kit (JDK) installed on your Mac, please download from the [https://www.oracle.com/technetwork/java/javase/downloads/jdk12-downloads-5295953.html official site] and install it before SunCASA installation. The latest version (JDK 12) was tested to work properly. Earlier versions may also work but YMMV.
 
# Open the disk image file (if your browser does not do so automatically).
 
# Open the disk image file (if your browser does not do so automatically).
Line 7: Line 13:
 
<!-- # Eject the SunCASA disk image. -->
 
<!-- # Eject the SunCASA disk image. -->
 
# Double-click the SunCASA application to run it for the first time. You may encounter the following prompts:
 
# Double-click the SunCASA application to run it for the first time. You may encounter the following prompts:
#* 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 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 complaints that the package is damaged, please turn off the OS Gatekeeper temporarily by running command ''sudo spctl --master-disable'' in Terminal. Then double-click the SunCASA application again.
 
#* If the OS complaints that the package is damaged, please turn off the OS Gatekeeper temporarily by running command ''sudo spctl --master-disable'' in Terminal. Then double-click the SunCASA application again.
# Setup environments for SunCASA. To do so, run ''!install_suncasa'' from a SunCASA prompt.  
+
# Setup environments and search paths for SunCASA. To do so, run ''!install_suncasa'' from a SunCASA prompt.  
 
#* (Optional) This step also allows to create symbolic links to the SunCASA version and its executables (default to be under /usr/local/bin; administrator privileges are required), which will allow you to run ''suncasa'', ''casaviewer'', ''casaplotms'', etc. from any terminal command line.
 
#* (Optional) This step also allows to create symbolic links to the SunCASA version and its executables (default to be under /usr/local/bin; administrator privileges are required), which will allow you to run ''suncasa'', ''casaviewer'', ''casaplotms'', etc. from any terminal command line.
 
# '''Important''': Make sure to turn the OS Gatekeeper back on after the installation by running ''sudo spctl --master-enable'' in Terminal.
 
# '''Important''': Make sure to turn the OS Gatekeeper back on after the installation by running ''sudo spctl --master-enable'' in Terminal.
# Optional: To update the data repository, run !update-data from the SunCASA prompt.
+
# (Optional) To update the CASA data repository, run !update-data from the SunCASA prompt.
# Restart SunCASA by exiting the current SunCASA prompt, and run ''suncasa'' in Terminal or double-click the SunCASA application icon.
+
# Exit the current SunCASA prompt, and restart SunCASA by double-clicking on the SunCASA application icon or typing ''suncasa'' in a Terminal window.
 
Now SunCASA has been up and running on your Mac.
 
Now SunCASA has been up and running on your Mac.
  
 
=Linux=
 
=Linux=
 
To install SunCASA for Linux, we have a binary distribution of SunCASA which is available as a downloadable tar file. We have tested the package under Scientific Linux 6 (derived from RHEL 6) and CentOS 7 (equivalent to RHEL 7). They may work under some other Linux distributions (e.g. Ubuntu), but YMMV.  
 
To install SunCASA for Linux, we have a binary distribution of SunCASA which is available as a downloadable tar file. We have tested the package under Scientific Linux 6 (derived from RHEL 6) and CentOS 7 (equivalent to RHEL 7). They may work under some other Linux distributions (e.g. Ubuntu), but YMMV.  
 +
# Download the SunCASA Linux packages
 +
#* [https://drive.google.com/file/d/1A5D7r65VmKE2HhN-Mg_cqMeZp3lNw1gZ/view?usp=sharing SunCASA-0.7.6_Pre-release Package for RedHat6 or equivalent] (676 MB)
 +
#* [https://drive.google.com/file/d/1nMHevR4u-rLMW0zGSu22OMUk2DoXjnpi/view?usp=sharing SunCASA-0.7.6_Pre-release Package for RedHat7 or equivalent] (744 MB)
 
# If you do not have Java installed on your machine, please download from the [https://www.java.com/en/download/ official site] and install it before SunCASA installation. The latest version was tested to work properly. Earlier versions may also work but YMMV.
 
# If you do not have Java installed on your machine, please download from the [https://www.java.com/en/download/ official site] and install it before SunCASA installation. The latest version was tested to work properly. Earlier versions may also work but YMMV.
 
# The following libraries need to be available to run (Sun)CASA, if they do not already come with your distribution. In Redhat/CentOS, for example, use "''yum install '''yourpackagename'''''" to install.
 
# The following libraries need to be available to run (Sun)CASA, if they do not already come with your distribution. In Redhat/CentOS, for example, use "''yum install '''yourpackagename'''''" to install.
Line 29: Line 38:
 
#* libGL
 
#* libGL
 
#* libXpm
 
#* libXpm
# Download the packages
 
#* [https://drive.google.com/file/d/1A5D7r65VmKE2HhN-Mg_cqMeZp3lNw1gZ/view?usp=sharing SunCASA-0.7.6_Pre-release Package for RedHat6 or equivalent]
 
#* [https://drive.google.com/file/d/1nMHevR4u-rLMW0zGSu22OMUk2DoXjnpi/view?usp=sharing SunCASA-0.7.6_Pre-release Package for RedHat7 or equivalent]
 
 
# Untar the package
 
# Untar the package
 
#: <pre>tar -xzvf SunCASA-release-##version##.tar.gz</pre>
 
#: <pre>tar -xzvf SunCASA-release-##version##.tar.gz</pre>
Line 38: Line 44:
 
#:<pre>PATH=`pwd`:$PATH</pre>
 
#:<pre>PATH=`pwd`:$PATH</pre>
 
# Then you can initialize SunCASA with the command in bash
 
# Then you can initialize SunCASA with the command in bash
#: <pre>./install_suncasa</pre>
+
#: <pre>install_suncasa</pre>
 
# Optional: To update the data repository, run !update-data from the SunCASA prompt.
 
# 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''. Enjoy!
 
Now SunCASA has been successfully installed on your machine. Open a new Terminal and run ''suncasa''. Enjoy!

Revision as of 02:47, 29 May 2019

SunCASA A Python package based on CASA (the Common Astronomy Software Applications package), which includes customized routines and scripts for visualizing and analyzing spectral imaging interferometric data specific to solar radio astronomy use cases.

  • CASA is one of the leading software tool for "supporting the data post-processing needs of the next generation of radio astronomical telescopes such as ALMA and VLA", an international effort led by the National Radio Astronomy Observatory. The current version of CASA uses Python (2.7) interface. More information about CASA can be found on NRAO's CASA website . Note, CASA is available ONLY on UNIX-BASED PLATFORMS (and therefore, so is SunCASA).
  • All solar-specific core routines of SunCASA are available publicly at the suncasa Github repository. However, they require CASA to function. We provide standalone packages that already include CASA (see below), in order to easily use SunCASA without the need to install CASA separately.

SunCASA is designed for reducing, visualizing, and analyzing solar interferometric data that adopt the standard CASA measurement set format. We have had success in using SunCASA for data from the Expanded Owens Valley Solar Array (EOVSA) and Karl G. Jansky Very Large Array (VLA). Modules could be added to the package to enable the analysis of data from other telescopes (such as ALMA). We encourage our colleagues in the community to help us test and improve the software.

MacOS

We provide a standard disk image (dmg) for installation on MacOS. This is a repack of CASA 5.6.0-2 with additional site packages/scripts specifically wrote for solar data analysis. It has been tested to work under Mojave (macOS v10.14). YMMV for earlier versions of macOS. Installation steps below:

  1. Download SunCASA disk image (SunCASA-0.7.6_Pre-release.OSX.dmg). (536 MB)
  2. If you do not have Java SE Development Kit (JDK) installed on your Mac, please download from the official site and install it before SunCASA installation. The latest version (JDK 12) was tested to work properly. Earlier versions may also work but YMMV.
  3. Open the disk image file (if your browser does not do so automatically).
  4. Drag the SunCASA application to the Applications folder of your hard disk.
  5. Double-click the SunCASA application to run it for the first time. You may encounter the following prompts:
    • 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 complaints that the package is damaged, please turn off the OS Gatekeeper temporarily by running command sudo spctl --master-disable in Terminal. Then double-click the SunCASA application again.
  6. Setup environments and search paths for SunCASA. To do so, run !install_suncasa from a SunCASA prompt.
    • (Optional) This step also allows to create symbolic links to the SunCASA version and its executables (default to be under /usr/local/bin; administrator privileges are required), which will allow you to run suncasa, casaviewer, casaplotms, etc. from any terminal command line.
  7. Important: Make sure to turn the OS Gatekeeper back on after the installation by running sudo spctl --master-enable in Terminal.
  8. (Optional) To update the CASA data repository, run !update-data from the SunCASA prompt.
  9. Exit the current SunCASA prompt, and restart SunCASA by double-clicking on the SunCASA application icon or typing suncasa in a Terminal window.

Now SunCASA has been up and running on your Mac.

Linux

To install SunCASA for Linux, we have a binary distribution of SunCASA which is available as a downloadable tar file. We have tested the package under Scientific Linux 6 (derived from RHEL 6) and CentOS 7 (equivalent to RHEL 7). They may work under some other Linux distributions (e.g. Ubuntu), but YMMV.

  1. Download the SunCASA Linux packages
  2. If you do not have Java installed on your machine, please download from the official site and install it before SunCASA installation. The latest version was tested to work properly. Earlier versions may also work but YMMV.
  3. The following libraries need to be available to run (Sun)CASA, if they do not already come with your distribution. In Redhat/CentOS, for example, use "yum install yourpackagename" to install.
    • xauth
    • libXft
    • libXi
    • libXrandr
    • libXfixes
    • libXcursor
    • libXinerama
    • libGL
    • libXpm
  4. Untar the package
    tar -xzvf SunCASA-release-##version##.tar.gz
  5. All executables, including suncasa are in the SunCASA-release-##version##/bin directory. Include these executables to your path (just for once; examples below are in bash)
    cd SunCASA-release-##version##/bin
    PATH=`pwd`:$PATH
  6. Then you can initialize SunCASA with the command in bash
    install_suncasa
  7. 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. Enjoy!

Help?

Please contact Sijie Yu or Bin Chen for questions regarding installing SunCASA.