README

****************
* Requirements *
****************
  + Python 2.7 release series (http://www.python.org/download/releases/)
  + NumPy (http://www.numpy.org/)
  + Astropy (http://www.astropy.org/)
  + Mechanize (http://wwwsearch.sourceforge.net/mechanize/download.html)
  + Beautiful Soup 4 (http://www.crummy.com/software/BeautifulSoup/)
  + Internet access

If you have pip installed then run:
 $ sudo pip install numpy astropy mechanize beautifulsoup4
to install all of the dependencies.

*********
* Usage *
*********
Firstly set the executable bit:
 $ chmod +x ned.py

The script can be invoked on the command-line:
 $ ./ned.py data.dat
where data.dat is a newline-separated file of whitespace-separated custom input data (see Configuration).
Sample input data files are provided.

Running the script without any file input:
 $ ./ned.py
will wait for manual data input. To indicate the end of a line of entry hit Return and then Ctrl+D.
To indicate the end of input hit Ctrl+D again.

If an output filename is specified:
 $ ./ned.py --file out.dat data.dat
then results will be written to that file. Otherwise results are displayed.

To output a single .dat file per input source in plot-ready format use:
 $ ./ned.py --plot dirname data.dat
where dirname is the output directory for the .dat files. The output format is:
<rest-frame freq> <NED luminosity> <WISE luminosity> <2MASS luminosity> <GALEX luminosity>
with luminosities in W/Hz.

For quick-reference refer to:
 $ ./ned.py --help

*****************
* Configuration *
*****************
The input format can be specified as a space-separated sequence of field names.
The output format can be specified as a Python format string.

See ned.conf for details.