# suncasa
[](https://pypi.python.org/pypi/suncasa/)
[suncasa](https://github.com/suncasa/suncasa-src) is a Python wrapper around [CASA](https://casa.nrao.edu/) for
importing, calibrating, synthesis imaging and visualizing solar spectral imaging data. CASA is one of the leading
software tools 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 (NRAO)](https://public.nrao.edu/). The current version of CASA uses Python 3.6
to 3.8 on most of the platforms. More information about the compatibility of CASA can be found
on [CASA Compatibility](https://casadocs.readthedocs.io/en/latest/notebooks/introduction.html#Compatibility/).
> **_NOTE:_** CASA is available ONLY on unix-based platforms, and therefore, so as for suncasa. CASA software is compatible with multiple LINUX and Mac computer operating systems, as well as multiple versions of Python. Please refer to the [Compatibility Matrix](https://casadocs.readthedocs.io/en/latest/notebooks/introduction.html#Compatibility) for detailed information on the Operating Systems and Python versions expected to work with current and future versions of CASA.
> **_NOTE:_** If you're using Windows, you'll need to install a virtual machine running a Linux system. For detailed instructions, please refer to this [guidance](https://docs.google.com/document/d/1DuRoVSVEwHOSIntbYYecXYxC8_pKt-oJ2UK_Q5Ye-vE/edit?usp=sharing).
In principle, suncasa an casa can be installed easily using [pip](https://pypi.org/project/suncasa/), assuming the right
python version is in use. However, YMMV if your do not have prerequisite environment configured.The followinig tutorial
demonstrates the installation of **suncasa** in **python 3.8** environment on **MacOS 12** and **Ubuntu 18.04.6 LTS**.
Full installation instructions of the standalone CASA package (as a Linux (.tar) or Mac (.dmg) files) including the
build-in Python environment are available from NRAO [Downloads](http://casa.nrao.edu/casa_obtaining.shtml)
page ([http://casa.nrao.edu/casa_obtaining.shtml](http://casa.nrao.edu/casa_obtaining.shtml))
The CASA 6.x series is also available as modular packages, giving users the flexibility to build CASA tools and tasks in
their own Python environment. This includes the casatools, casatasks, and casampi modules, allowing for core data
processing capabilities in parallel.
<hr />
**If you want to use full funtionalities provided by the standalone CASA, please go through all steps.**
**If you just want to install SUNCASA with the modular CASA option in the usual "Pythonic" manner, after Step 1 (Python
installation), you can skip Step 2 and go directly to Step 3.**
<hr />
## Step 1: Python 3.8 Installation[](#installation)
(Adapted from [this tutorial](https://casadocs.readthedocs.io/en/latest/notebooks/introduction.html#id1))
### Prerequisite OS Libraries[](#Prerequisite-OS-Libraries)
CASA requires certain libraries be installed in the users operating system. Some may already be present by default. In
case they are not, the following list should be checked before using CASA or if errors are encountered at runtime.
Commands and package names are for Red Hat Linux, but equivalents can be found for other Linux distributions.
**On Linux:**
A system administrator may be required to install OS libraries. One can
use [yum](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/ch-yum) (
RHEL) or [apt-get](https://help.ubuntu.com/community/AptGet/Howto) (Ubuntu) to install the missing libraries. For
example, for RHEL8 the following OS libraries should be installed:
```bash
sudo yum install libgfortran3
sudo yum install ImageMagick*
sudo yum install xorg-x11-server-Xvfb
sudo yum install compat-libgfortran-48
sudo yum install libnsl
sudo yum install libcanberra-gtk2
```
For modular CASA, one must supply their own Python environment. There are many, including ipython and Jupyter, here is a
basic example for
RHEL8 ([yum](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/ch-yum))
and Ubuntu ([apt-get](https://help.ubuntu.com/community/AptGet/Howto)), respectively.
```bash
sudo yum install python38-devel
```
```bash
sudo apt install python3.8 python3.8-venv python3-venv
```
**On Macintosh:**
Install [XQuartz](https://www.xquartz.org/)
and [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12).
[comment]: <> (gcc ([brew](https://brew.sh/) install),)
Same as for Linux, one must supply their own Python environment for modular CASA. Here is an example for MacOS to
install python 3.8 using PyEnv.
Clone pyenv to a local directory (e.g., `$HOME/.pyenv`):
```bash
git clone https://github.com/pyenv/pyenv.git $HOME/.pyenv
```
Set up your shell environment for Pyenv. Assuming you are using **bash**, add the configuration commands to `~/.bashrc`
by running the following in your terminal:
~~~bash
bash
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
~~~
Install the Python 3.8.
```bash
pyenv install 3.8.16
```
> **_Troubleshooting:_** If you encounter an error that "C compiler cannot create executables" then the simplest way to solve this is to reinstall Apple's [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12). Xcode is a tool created by Apple that includes all the C libraries and other tools that Python uses when it runs on MacOS. Xcode is a whopping 11 gigabytes, but you'll want to be up-to-date. You may want to run this while you're sleeping. Once it is done, just re-run the above `pyenv install 3.8.16` and it should now work.
Now you can set this version of Python to be the **current** version of Python MacOS uses. This setting is temporary.
```bash
pyenv global 3.8.16
```
If you want to set this version of Python to the the **default** version of Python, add the configuration command
to `~/.bashrc`.
```bash
echo 'pyenv global 3.8.16' >> ~/.bashrc
```
### Step 2: CASA (Standalone Monolithic Distribution) Installation [](#Monolithic-CASA-Distribution)
Download the standalone CASA package (as a Linux (.tar) or Mac (.dmg) files) including the build-in Python environment
following
[http://casa.nrao.edu/casa_obtaining.shtml](http://casa.nrao.edu/casa_obtaining.shtml).
**On Linux:**
1. Download the .tar file and place it in a work directory (e.g. `$HOME/casa`).
2. From a Linux terminal window:
~~~ bash
tar -xvf casa-xyz.tar.xz
$HOME/casa/casa-xyz/bin/casa
~~~
3. Add casa to environment `PATH`. Assuming you are using *bash*, add the configuration commands to `~/.bashrc` by
running the following in your terminal:
~~~ bash
echo 'export CASAROOT="$HOME/casa/casa-xyz/"' >> ~/.bashrc
echo 'export PATH="$PATH:$CASAROOT/bin"' >> ~/.bashrc
~~~
4. Restart your shell for the `PATH` changes to take effect.
```sh
exec "$SHELL"
```
You can now start casa.
```sh
casa
```
The one caveat is that CASA on Linux currently will not run if the Security-Enhanced Linux option of the linux operating
system is set to enforcing. For the non-root install to work, SElinux must be set to disabled or permissive (in _
/etc/selinux/config_) or you must run (as root): `$: setsebool -P allow_execheap=1`. Otherwise, you will encounter
errors like:
error while loading shared libraries: /opt/casa/casa-20.0.5653-001/lib/liblapack.so.3.1.1: cannot restore segment prot
after reloc: Permission denied_
> **_WARNING:_** By default, python 3.6 (and earlier versions of python 3) include the current working directory in the python path at startup. Any script in that directory with the same name as a standard python module or a CASA module will be detected and used by python instead of the code that is delivered with CASA. Protections have been included for files called “new.py” and “pickle.py”, but other scripts may cause problems with the CASA startup. For example, do not include a file named runpy.py in the working directory.
**On Macintosh:**
1. Download the .dmg disk image file
2. Double click on the disk image file (if your browser does not automatically open it).
3. Drag the CASA application to the _Applications_ folder of your hard disk.
4. Eject the CASA disk image.
5. Double click the CASA 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”.
6. Optional: Create symbolic links to the CASA version and its executables (Administrator privileges are required),
which will allow you to run `casa`, `casaviewer`, `casaplotms`, etc. from any terminal command line. To do so, run
```console
!create-symlinks
```
### Step 3: Install SUNCASA (along with CASA modular version) [](#Modular-Packages)
Pip wheels for casatools, casatasks, as well as suncasa are available as Python 3 modules. This allows simple
installation and import into standard Python environments. Make sure you have set up your machine with the _necessary
prerequisite libraries_ first. Then a separate installation of desired modules (from a unix terminal window) as follows.
First create a Python virtual environment named `suncasaenv` under the `$HOME` directory:
```bash
cd $HOME
python3.8 -m venv suncasaenv
```
> **_NOTE:_** We strongly recommend using a Python virtual environment to prevent breaking any packages within a pre-existing Python environment.
Then use [pip](https://pypi.org/project/suncasa/) to install suncasa within the newly-created virtual environment:
```bash
source suncasaenv/bin/activate
pip install --upgrade pip
pip install suncasa
```
> **_NOTE:_** If this does not work, it could be due to unsuccessful installation of some dependencies. Running these commands should address this.
```bash
pip install casatasks
pip install casatools
pip install casadata
pip install PyQt5
pip install sunpy[all]
pip install suncasa
```
To exit the python venv, type `deactivate` from the terminal. However, the rest of this tutorial **assumes the venv is
active** (to reactivate, type `source $HOME/suncasaenv/bin/activate`)
You can update suncasa to its latest version by running:
```bash
pip install --upgrade suncasa
```
**Sanity check**
With the pip installation, suncasa as well as CASA may be used in a standard Pythonic manner. For example, suncasa
modules and CASA tasks can be invoked using “import”, while CASA tools first need to be instantiated:
```console
(suncasaenv) $ ipython
In [1]: import suncasa
In [2]: help(suncasa)
In [3]: import casatasks
In [4]: help(casatasks)
```
The use of python3 venv is a simple built-in method of containerizing the pip install such that multiple versions of
suncasa can be kept on a single machine in different environments. In addition, suncasa is built and tested using
standard python 3.8 libraries (backward compatible) which can be replicated with a fresh venv, keeping the libraries
needed for suncasa isolated from other libraries which may already be installed on your machine.
**Add EOVSA to CASA observatories list**
The following command creates a configuration file to define the EOVSA instrument so that CASA is aware of it. We plan
to add EOVSA officially to the CASA distribution in the future, after which this step is unnecessary.
```bash
printf "import sys \nimport os \nimport sysconfig \nimport casatools \nimport casadata \nimport time \nlogfile='casalog-{}.log'.format(time.strftime('%%Y%%m%%d-%%H',time.localtime())) \ntelemetry_enabled = False \ncrashreporter_enabled = True \ntb=casatools.table() \nospathsep = os.path.sep \nlibpath = sysconfig.get_paths()['purelib'] \nobsdict = {'MJD': 57447.0, 'Name': 'EOVSA', 'Type': 'WGS84', 'Long': -118.287, \n 'Lat': 37.2332, 'Height': 1207.13, 'X': 0.0, 'Y': 0.0, 'Z': 0.0, \n 'Source': 'Dale Gary'} \nobstable = os.path.join(casadata.datapath,'geodetic','Observatories') \ntb.open(obstable, nomodify=True) \nif 'EOVSA' not in tb.getcol('Name'): \n print('Adding EOVSA to the Observatories') \n tb.close() \n tb.open(obstable, nomodify=False) \n nrows = tb.nrows() \n tb.addrows(1) \n for k in obsdict.keys(): \n tb.putcell(k, nrows, obsdict[k]) \ntb.close() \n" > $HOME/.casa/config.py
```
***Last but not least, add the `site-packages` path where the suncasa and its dependent packages installedd to the
Monolithic CASA***
```bash
echo "sitepackagepath = '$HOME/suncasaenv/lib/python3.8/site-packages'" >> $HOME/.casa/config.py
echo "if sitepackagepath not in sys.path:" >> $HOME/.casa/config.py
echo " sys.path.append(sitepackagepath)" >> $HOME/.casa/config.py
```
> **_note:_** The `sitepackagepath` may varies for python versions on different platforms.
**Note for Mac M1 users**: For macOS 12 on an ARM-based M1 chip, users will need to install the wheels of CASA version
11 for intel architecture. For that, we recommend to install [Apple Rosetta](https://support.apple.com/en-us/HT211861) to enable a Mac with Apple silicon to use
apps made for an Intel processor ([How-to](https://medium.com/mkdir-awesome/how-to-install-x86-64-homebrew-packages-on-apple-m1-macbook-54ba295230f)).
By now you can use the following command to pip install the CASA wheels:
```bash
arch -x86_64 python3.8 -m pip install ...
```
Raw data
{
"_id": null,
"home_page": "https://github.com/suncasa/suncasa",
"name": "suncasa",
"maintainer": "",
"docs_url": null,
"requires_python": "!=3.7.*,<3.9,>=3.6",
"maintainer_email": "",
"keywords": "solar physics,solar,science,sun,wcs,coordinates",
"author": "The EOVSA team",
"author_email": "sijie.yu@njit.edu",
"download_url": "https://files.pythonhosted.org/packages/da/c4/f13780f5ab1febdcd4ad87ee845e00c0c30918d077cf2fee380847901bca/suncasa-1.0.5.tar.gz",
"platform": "any",
"description": "# suncasa\n\n[](https://pypi.python.org/pypi/suncasa/)\n\n[suncasa](https://github.com/suncasa/suncasa-src) is a Python wrapper around [CASA](https://casa.nrao.edu/) for\nimporting, calibrating, synthesis imaging and visualizing solar spectral imaging data. CASA is one of the leading\nsoftware tools for \"supporting the data post-processing needs of the next generation of radio astronomical telescopes\nsuch as ALMA and VLA, an international effort led by\nthe [National Radio Astronomy Observatory (NRAO)](https://public.nrao.edu/). The current version of CASA uses Python 3.6\nto 3.8 on most of the platforms. More information about the compatibility of CASA can be found\non [CASA Compatibility](https://casadocs.readthedocs.io/en/latest/notebooks/introduction.html#Compatibility/).\n> **_NOTE:_** CASA is available ONLY on unix-based platforms, and therefore, so as for suncasa. CASA software is compatible with multiple LINUX and Mac computer operating systems, as well as multiple versions of Python. Please refer to the [Compatibility Matrix](https://casadocs.readthedocs.io/en/latest/notebooks/introduction.html#Compatibility) for detailed information on the Operating Systems and Python versions expected to work with current and future versions of CASA.\n\n> **_NOTE:_** If you're using Windows, you'll need to install a virtual machine running a Linux system. For detailed instructions, please refer to this [guidance](https://docs.google.com/document/d/1DuRoVSVEwHOSIntbYYecXYxC8_pKt-oJ2UK_Q5Ye-vE/edit?usp=sharing).\n\nIn principle, suncasa an casa can be installed easily using [pip](https://pypi.org/project/suncasa/), assuming the right\npython version is in use. However, YMMV if your do not have prerequisite environment configured.The followinig tutorial\ndemonstrates the installation of **suncasa** in **python 3.8** environment on **MacOS 12** and **Ubuntu 18.04.6 LTS**.\n\nFull installation instructions of the standalone CASA package (as a Linux (.tar) or Mac (.dmg) files) including the\nbuild-in Python environment are available from NRAO [Downloads](http://casa.nrao.edu/casa_obtaining.shtml)\npage ([http://casa.nrao.edu/casa_obtaining.shtml](http://casa.nrao.edu/casa_obtaining.shtml))\n\nThe CASA 6.x series is also available as modular packages, giving users the flexibility to build CASA tools and tasks in\ntheir own Python environment. This includes the casatools, casatasks, and casampi modules, allowing for core data\nprocessing capabilities in parallel.\n\n<hr />\n\n**If you want to use full funtionalities provided by the standalone CASA, please go through all steps.**\n\n**If you just want to install SUNCASA with the modular CASA option in the usual \"Pythonic\" manner, after Step 1 (Python\ninstallation), you can skip Step 2 and go directly to Step 3.**\n\n<hr />\n\n## Step 1: Python 3.8 Installation[](#installation)\n\n(Adapted from [this tutorial](https://casadocs.readthedocs.io/en/latest/notebooks/introduction.html#id1))\n\n### Prerequisite OS Libraries[](#Prerequisite-OS-Libraries)\n\nCASA requires certain libraries be installed in the users operating system. Some may already be present by default. In\ncase they are not, the following list should be checked before using CASA or if errors are encountered at runtime.\nCommands and package names are for Red Hat Linux, but equivalents can be found for other Linux distributions.\n\n**On Linux:**\n\nA system administrator may be required to install OS libraries. One can\nuse [yum](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/ch-yum) (\nRHEL) or [apt-get](https://help.ubuntu.com/community/AptGet/Howto) (Ubuntu) to install the missing libraries. For\nexample, for RHEL8 the following OS libraries should be installed:\n\n```bash\nsudo yum install libgfortran3\nsudo yum install ImageMagick*\nsudo yum install xorg-x11-server-Xvfb\nsudo yum install compat-libgfortran-48\nsudo yum install libnsl\nsudo yum install libcanberra-gtk2\n```\n\nFor modular CASA, one must supply their own Python environment. There are many, including ipython and Jupyter, here is a\nbasic example for\nRHEL8 ([yum](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/system_administrators_guide/ch-yum))\nand Ubuntu ([apt-get](https://help.ubuntu.com/community/AptGet/Howto)), respectively.\n\n```bash\nsudo yum install python38-devel\n```\n\n```bash\nsudo apt install python3.8 python3.8-venv python3-venv\n```\n\n**On Macintosh:**\n\nInstall [XQuartz](https://www.xquartz.org/)\nand [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12).\n\n[comment]: <> (gcc ([brew](https://brew.sh/) install),)\n\nSame as for Linux, one must supply their own Python environment for modular CASA. Here is an example for MacOS to\ninstall python 3.8 using PyEnv.\n\nClone pyenv to a local directory (e.g., `$HOME/.pyenv`):\n\n```bash\ngit clone https://github.com/pyenv/pyenv.git $HOME/.pyenv\n```\n\nSet up your shell environment for Pyenv. Assuming you are using **bash**, add the configuration commands to `~/.bashrc`\nby running the following in your terminal:\n\n~~~bash\nbash\necho 'export PYENV_ROOT=\"$HOME/.pyenv\"' >> ~/.bashrc\necho 'command -v pyenv >/dev/null || export PATH=\"$PYENV_ROOT/bin:$PATH\"' >> ~/.bashrc\necho 'eval \"$(pyenv init -)\"' >> ~/.bashrc\n~~~\n\nInstall the Python 3.8.\n\n```bash\npyenv install 3.8.16\n```\n\n> **_Troubleshooting:_** If you encounter an error that \"C compiler cannot create executables\" then the simplest way to solve this is to reinstall Apple's [Xcode](https://apps.apple.com/us/app/xcode/id497799835?mt=12). Xcode is a tool created by Apple that includes all the C libraries and other tools that Python uses when it runs on MacOS. Xcode is a whopping 11 gigabytes, but you'll want to be up-to-date. You may want to run this while you're sleeping. Once it is done, just re-run the above `pyenv install 3.8.16` and it should now work.\n\nNow you can set this version of Python to be the **current** version of Python MacOS uses. This setting is temporary.\n\n```bash\npyenv global 3.8.16\n```\n\nIf you want to set this version of Python to the the **default** version of Python, add the configuration command\nto `~/.bashrc`.\n\n```bash\necho 'pyenv global 3.8.16' >> ~/.bashrc\n```\n\n### Step 2: CASA (Standalone Monolithic Distribution) Installation [](#Monolithic-CASA-Distribution)\n\nDownload the standalone CASA package (as a Linux (.tar) or Mac (.dmg) files) including the build-in Python environment\nfollowing\n[http://casa.nrao.edu/casa_obtaining.shtml](http://casa.nrao.edu/casa_obtaining.shtml).\n\n**On Linux:**\n\n1. Download the .tar file and place it in a work directory (e.g. `$HOME/casa`).\n\n2. From a Linux terminal window:\n ~~~ bash\n tar -xvf casa-xyz.tar.xz\n $HOME/casa/casa-xyz/bin/casa\n ~~~ \n3. Add casa to environment `PATH`. Assuming you are using *bash*, add the configuration commands to `~/.bashrc` by\n running the following in your terminal:\n\n ~~~ bash\n echo 'export CASAROOT=\"$HOME/casa/casa-xyz/\"' >> ~/.bashrc\n echo 'export PATH=\"$PATH:$CASAROOT/bin\"' >> ~/.bashrc\n ~~~\n\n\n4. Restart your shell for the `PATH` changes to take effect.\n\n ```sh\n exec \"$SHELL\"\n ``` \n\nYou can now start casa.\n\n ```sh\n casa\n ``` \n\nThe one caveat is that CASA on Linux currently will not run if the Security-Enhanced Linux option of the linux operating\nsystem is set to enforcing. For the non-root install to work, SElinux must be set to disabled or permissive (in _\n/etc/selinux/config_) or you must run (as root): `$: setsebool -P allow_execheap=1`. Otherwise, you will encounter\nerrors like:\n\nerror while loading shared libraries: /opt/casa/casa-20.0.5653-001/lib/liblapack.so.3.1.1: cannot restore segment prot\nafter reloc: Permission denied_\n\n> **_WARNING:_** By default, python 3.6 (and earlier versions of python 3) include the current working directory in the python path at startup. Any script in that directory with the same name as a standard python module or a CASA module will be detected and used by python instead of the code that is delivered with CASA. Protections have been included for files called \u201cnew.py\u201d and \u201cpickle.py\u201d, but other scripts may cause problems with the CASA startup. For example, do not include a file named runpy.py in the working directory.\n\n**On Macintosh:**\n\n1. Download the .dmg disk image file\n\n2. Double click on the disk image file (if your browser does not automatically open it).\n\n3. Drag the CASA application to the _Applications_ folder of your hard disk.\n\n4. Eject the CASA disk image.\n\n5. Double click the CASA application to run it for the first time. If the OS does not allow you to install apps from\n non-Apple sources, please Change the settings in \u201cSystem Preferences-> Security & Privacy -> General\u201d and \u201cAllow\n applications downloaded from: Mac App store and identified developers\u201d.\n\n6. Optional: Create symbolic links to the CASA version and its executables (Administrator privileges are required),\n which will allow you to run `casa`, `casaviewer`, `casaplotms`, etc. from any terminal command line. To do so, run\n\n```console\n !create-symlinks\n``` \n\n### Step 3: Install SUNCASA (along with CASA modular version) [](#Modular-Packages)\n\nPip wheels for casatools, casatasks, as well as suncasa are available as Python 3 modules. This allows simple\ninstallation and import into standard Python environments. Make sure you have set up your machine with the _necessary\nprerequisite libraries_ first. Then a separate installation of desired modules (from a unix terminal window) as follows.\nFirst create a Python virtual environment named `suncasaenv` under the `$HOME` directory:\n\n```bash\ncd $HOME\npython3.8 -m venv suncasaenv\n```\n\n> **_NOTE:_** We strongly recommend using a Python virtual environment to prevent breaking any packages within a pre-existing Python environment.\n\nThen use [pip](https://pypi.org/project/suncasa/) to install suncasa within the newly-created virtual environment:\n\n```bash\nsource suncasaenv/bin/activate\npip install --upgrade pip\npip install suncasa\n```\n\n> **_NOTE:_** If this does not work, it could be due to unsuccessful installation of some dependencies. Running these commands should address this.\n\n```bash\npip install casatasks\npip install casatools\npip install casadata\npip install PyQt5\npip install sunpy[all]\npip install suncasa\n```\n\nTo exit the python venv, type `deactivate` from the terminal. However, the rest of this tutorial **assumes the venv is\nactive** (to reactivate, type `source $HOME/suncasaenv/bin/activate`)\n\nYou can update suncasa to its latest version by running:\n\n```bash\npip install --upgrade suncasa\n```\n\n**Sanity check**\n\nWith the pip installation, suncasa as well as CASA may be used in a standard Pythonic manner. For example, suncasa\nmodules and CASA tasks can be invoked using \u201cimport\u201d, while CASA tools first need to be instantiated:\n\n```console\n(suncasaenv) $ ipython\nIn [1]: import suncasa\nIn [2]: help(suncasa)\nIn [3]: import casatasks\nIn [4]: help(casatasks)\n```\n\nThe use of python3 venv is a simple built-in method of containerizing the pip install such that multiple versions of\nsuncasa can be kept on a single machine in different environments. In addition, suncasa is built and tested using\nstandard python 3.8 libraries (backward compatible) which can be replicated with a fresh venv, keeping the libraries\nneeded for suncasa isolated from other libraries which may already be installed on your machine.\n\n**Add EOVSA to CASA observatories list**\n\nThe following command creates a configuration file to define the EOVSA instrument so that CASA is aware of it. We plan\nto add EOVSA officially to the CASA distribution in the future, after which this step is unnecessary.\n\n```bash\nprintf \"import sys \\nimport os \\nimport sysconfig \\nimport casatools \\nimport casadata \\nimport time \\nlogfile='casalog-{}.log'.format(time.strftime('%%Y%%m%%d-%%H',time.localtime())) \\ntelemetry_enabled = False \\ncrashreporter_enabled = True \\ntb=casatools.table() \\nospathsep = os.path.sep \\nlibpath = sysconfig.get_paths()['purelib'] \\nobsdict = {'MJD': 57447.0, 'Name': 'EOVSA', 'Type': 'WGS84', 'Long': -118.287, \\n 'Lat': 37.2332, 'Height': 1207.13, 'X': 0.0, 'Y': 0.0, 'Z': 0.0, \\n 'Source': 'Dale Gary'} \\nobstable = os.path.join(casadata.datapath,'geodetic','Observatories') \\ntb.open(obstable, nomodify=True) \\nif 'EOVSA' not in tb.getcol('Name'): \\n print('Adding EOVSA to the Observatories') \\n tb.close() \\n tb.open(obstable, nomodify=False) \\n nrows = tb.nrows() \\n tb.addrows(1) \\n for k in obsdict.keys(): \\n tb.putcell(k, nrows, obsdict[k]) \\ntb.close() \\n\" > $HOME/.casa/config.py\n```\n\n***Last but not least, add the `site-packages` path where the suncasa and its dependent packages installedd to the\nMonolithic CASA***\n\n```bash\necho \"sitepackagepath = '$HOME/suncasaenv/lib/python3.8/site-packages'\" >> $HOME/.casa/config.py\necho \"if sitepackagepath not in sys.path:\" >> $HOME/.casa/config.py\necho \" sys.path.append(sitepackagepath)\" >> $HOME/.casa/config.py\n```\n\n> **_note:_** The `sitepackagepath` may varies for python versions on different platforms.\n\n\n**Note for Mac M1 users**: For macOS 12 on an ARM-based M1 chip, users will need to install the wheels of CASA version\n11 for intel architecture. For that, we recommend to install [Apple Rosetta](https://support.apple.com/en-us/HT211861) to enable a Mac with Apple silicon to use\napps made for an Intel processor ([How-to](https://medium.com/mkdir-awesome/how-to-install-x86-64-homebrew-packages-on-apple-m1-macbook-54ba295230f)). \n\nBy now you can use the following command to pip install the CASA wheels:\n\n```bash\narch -x86_64 python3.8 -m pip install ...\n```\n\n\n\n",
"bugtrack_url": null,
"license": "BSD 2-Clause",
"summary": "\"SunCASA: CASA-based Python package for reducing, analyzing, and visualizing solar dynamic spectroscopic imaging data at radio wavelengths\"",
"version": "1.0.5",
"project_urls": {
"Homepage": "https://github.com/suncasa/suncasa"
},
"split_keywords": [
"solar physics",
"solar",
"science",
"sun",
"wcs",
"coordinates"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "14dae9d7195d1f89a38a38cf1c59824028ad58741dd25a65f11de08c6331f6e7",
"md5": "4c645df4096bcebcf9b13c031b835904",
"sha256": "f92332895ac019454137d8789eef4a88a229dc71d8706337bf961e27af067064"
},
"downloads": -1,
"filename": "suncasa-1.0.5-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "4c645df4096bcebcf9b13c031b835904",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": "!=3.7.*,<3.9,>=3.6",
"size": 747156,
"upload_time": "2023-11-22T21:33:38",
"upload_time_iso_8601": "2023-11-22T21:33:38.668171Z",
"url": "https://files.pythonhosted.org/packages/14/da/e9d7195d1f89a38a38cf1c59824028ad58741dd25a65f11de08c6331f6e7/suncasa-1.0.5-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dac4f13780f5ab1febdcd4ad87ee845e00c0c30918d077cf2fee380847901bca",
"md5": "50afadf93ee12c74e52b9a49120ebe20",
"sha256": "e3a283c24b33dda64df6ce5befcc658139f6ca261a3ed92d74d6c6c49830799c"
},
"downloads": -1,
"filename": "suncasa-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "50afadf93ee12c74e52b9a49120ebe20",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "!=3.7.*,<3.9,>=3.6",
"size": 2047904,
"upload_time": "2023-11-22T21:33:41",
"upload_time_iso_8601": "2023-11-22T21:33:41.211467Z",
"url": "https://files.pythonhosted.org/packages/da/c4/f13780f5ab1febdcd4ad87ee845e00c0c30918d077cf2fee380847901bca/suncasa-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-22 21:33:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "suncasa",
"github_project": "suncasa",
"github_not_found": true,
"lcname": "suncasa"
}
JSON
