Updated readme

README.md

@@ -1,4 +1,31 @@
-strf
-====
+# STRF
+=========
 
-RF Satellite Tracking
+**strf** is the satellite tracking toolkit for radio observations (RF). The software is designed to allow tracking of satellites from radio observations, using Doppler curves to identify satellites and/or determine their orbits.
+
+The software is designed for *linux* operating systems, and will work with most software defined radios (SDRs), certainly those that are supported by http://www.gnuradio.com. The software comes with tools for data acquisition, performing FFTs to generate timestamped spectrograms (waterfall plots), and analysis, to extract and analyse Doppler curves.
+
+Install
+------
+* Clone locally the code repository
+* Install common dependencies
+  * gfortran
+  * gcc
+  * libpng-dev
+  * libx11-dev
+  * libjpeg-dev
+  * libexif-dev
+* Build & install required libraries
+  * pgplot-5.2.2: http://www.astro.caltech.edu/~tjp/pgplot/
+  * gsl-2.4: ftp://ftp.gnu.org/gnu/gsl/gsl-2.4.tar.gz
+* Run `make` on the **strf** folder
+
+Run notes
+---------
+* You will need to set the following environment variables to run **strf**.
+	`ST_COSPAR` COSPAR number
+	`ST_DATADIR` path to **strf** directory
+	`ST_TLEDIR` path to TLE directory
+	`ST_OBSDIR` path to observations directory
+* You should install NTP support on the system and configure time/date to automatically
+  sinchronize to time servers.