ADMIT Installation Notes

From CARMA
(Difference between revisions)
Jump to: navigation, search
(For users:)
(Enhancing your CASA with extra tools)
Line 44: Line 44:
 
=== Enhancing your CASA with extra tools ===
 
=== Enhancing your CASA with extra tools ===
  
For reasons beyond our control, CASA comes with its own python, which in a default installation isn't even accessible to mortal users. You will need to enhance your shell to see and work with that python.  Installing ADMIT will take care of this last part, but if you don't have write permission into your version of CASA, there is only a limited number of things you can do as a developer. You would not be able to build the documentation.
+
For reasons beyond our control, CASA comes with its own python, which in a default installation isn't even accessible to mortal users. You will need to enhance your shell to see and work with that python.  Installing ADMIT will take care of this last part, but if you don't have write permission into your version of CASA, there is only a limited number of things you can do as a developer. You would not be able to build the documentation. See also
 +
[https://github.com/radio-astro-tools/casa-python  casa-python] and [https://github.com/timstaley/drive-casa drive-casa]
  
 
== ADMIT for users: ==
 
== ADMIT for users: ==
  
 
A user installation is expected to be using conda or egg based. We have experimented some with this, but nothing stable is available at the time.
 
A user installation is expected to be using conda or egg based. We have experimented some with this, but nothing stable is available at the time.

Revision as of 13:29, 10 May 2015

ADMIT for developers:

You will need to know where CASA is installed on your machine. The following (csh) commands get your started on installing ADMIT (use USER = anonymous to get a read-only version, developers should know their USER name). bash users use the .sh variant.

  cvs -d :pserver:$USER@cvs.astro.umd.edu:/home/cvsroot checkout admit
  cd admit
  autoconf
  ./configure --with-casa-root=/astromake/opt/casa/stable
  source admit_start.csh

This will define the $ADMIT environment variable. There is also a top level INSTALL file, which contains more hints to install ADMIT with advanced options, most of which you will not need to get started.

The command

  admit

will remind you that ADMIT has been installed, it doesn't do anything other than that right now. The top level Makefile also has some useful reminders what can do now and to do some very basic testing of ADMIT in a CASA environment. For example

  make python0
  make python1
  make pdf
  make html
  make doc

and to simulate the buildbot

  make buildbot

For beginning developers this may not work if you don't have sphinx added to your CASA, in that case use

  make unit

although that currently does very little testing.

We do have some **rogue testing** installed, these are basically python (pure python as well as casarun-python) scripts that run through some Flow*_AT's. You can run them via

  make unit0_clean
  make unit0
  make unit0


and they should not fail. The 2nd run will re-run an existing test and should also not fail. Those test_Flow* scripts are instructive to see how basic Flow's can be created using ADMIT.

Enhancing your CASA with extra tools

For reasons beyond our control, CASA comes with its own python, which in a default installation isn't even accessible to mortal users. You will need to enhance your shell to see and work with that python. Installing ADMIT will take care of this last part, but if you don't have write permission into your version of CASA, there is only a limited number of things you can do as a developer. You would not be able to build the documentation. See also casa-python and drive-casa

ADMIT for users:

A user installation is expected to be using conda or egg based. We have experimented some with this, but nothing stable is available at the time.

Personal tools