Merge pull request #8 from tzdwi/iraf

Iraf

.gitignore

@@ -35,6 +35,7 @@ docs/_build
 
 # Packages/installer info
 *.egg
+.eggs/*
 *.egg-info
 dist
 build

docs/getting_started.rst

@@ -1,7 +1,7 @@
-.. _getting_started:
-
 .. include:: references.txt
 
+.. _getting_started:
+
 ***************
 Getting started
 ***************
@@ -17,6 +17,8 @@ Contents
 Opening example spectra
 -----------------------
 
+If you want to do this with your own data, make sure it is reduced by following the steps in :ref:`iraf`
+
 Example ARCES spectra are available online for you to work with. You can
 download them via Python like this:
 

docs/index.rst

@@ -17,6 +17,7 @@ You can view the
    :caption: Contents:
 
    install
+   iraf
    getting_started
    api
 

docs/iraf.rst

@@ -0,0 +1,69 @@
+.. include:: references.txt
+
+.. _iraf:
+
+****
+IRAF
+****
+
+Contents
+========
+
+* :ref:`iraf-down`
+* :ref:`iraf-prep`
+* :ref:`iraf-reduce`
+
+.. _iraf-down:
+
+Downloading and installing AstroConda with IRAF
+-----------------------------------------------
+Go to the `AstroConda installation page <http://astroconda.readthedocs.io/en/latest/installation.html?highlight=iraf#legacy-software-stack-with-iraf>`_,
+and follow the instructions to download AstroConda with IRAF. Unfortunately this only works with Python 2.7.
+
+.. _iraf-prep:
+
+Preparing your data
+-------------------
+
+``ReduceARCES`` will expect your flats in the red to start with "redflat",
+your flats in the blue to start with "blueflat", your biases to start with "bias", and your ThAr lamp exposures to start
+with "ThAr".
+
+.. _iraf-reduce:
+
+Reducing your data
+------------------
+First, make sure your iraf27 (or whatever you named it when installing AstroConda with IRAF) environment is activated by
+doing ::
+
+    source activate iraf27
+
+from a bash terminal.
+
+Copy all of the files in the ``aesop/iraf`` directory into the directory where your raw data and cals are. From that
+directory, do ::
+
+    mkiraf
+
+which will create ``login.cl`` in that directory. If prompted to specify a terminal, say ``xgterm``.
+Edit ``login.cl`` to include the following imports ::
+
+    imred
+    ccdred
+    echelle
+    crutil
+    astutil
+    images
+    imgeom
+    twodspec
+    apextract
+    onedspec
+
+Next, open an xgterm by doing ``xgterm``, and do ::
+
+    cl
+    cl < ReduceARCES.cl
+
+This will extract the spectrum from your data.
+
+Now in order to use ``aesop``, follow the tutorial in :ref:`getting_started`