Added code to be able to interpolate both seeing and cloud data

modified:   .gitignore
    modified to keep ipython_notebook_checkpoints out of examples
modified:   obscond/__init__.py
    for new imports
new file:   MANIFEST.in
new file:   obscond/constants.py
    package wide constants
new file:   obscond/historicalWeatherData.py
    contains code to use historical data to provide interpolated values
of seeing and cloud fraction

	new file:   obscond/io.py
Helper module for io
	modified:   setup.py
Added statements

Author: rbiswas4

.gitignore

@@ -60,3 +60,4 @@ target/
 
 #Ipython Notebook
 .ipynb_checkpoints
+examples/.ipynb_checkpoints

MANIFEST.in

@@ -0,0 +1,3 @@
+include example_data/*.md
+include example_data/*.txt
+

obscond/__init__.py

@@ -1,2 +1,8 @@
 import palpy as pal
+import os
+from .io import *
+from .historicalWeatherData import *
+from .constants import *
 #from .version import __version__
+dirname = os.path.dirname(os.path.abspath(__file__))
+example_data_dir =  os.path.join(dirname, 'example_data')

obscond/constants.py

@@ -0,0 +1,5 @@
+import os
+__all__ = ['example_data_dir', 'DAY_IN_SEC']
+dirname = os.path.dirname(os.path.abspath(__file__))
+example_data_dir =  os.path.join(dirname, 'example_data')
+DAY_IN_SEC = 24.0 * 60. * 60

obscond/historicalWeatherData.py

@@ -0,0 +1,83 @@
+import os
+import pandas as pd
+import sys
+import numpy as np
+from .constants import *
+from .io import *
+
+__all__ = ['WeatherData']
+
+SeeingFile = os.path.join(example_data_dir, 'SeeingPachon.txt')
+CloudFile = os.path.join(example_data_dir, 'CloudTololo.txt')
+
+class WeatherData(object):
+    """
+    Class to provide Seeing and Cloud fraction as a function of time. 
+    """
+    def __init__(self,
+                 seeingHistory,
+                 cloudHistory,
+                 startDate=None,
+                 endDate=None):
+        """
+        Parameters
+        ----------
+        SeeingHistory : `pandas.DataFrame` with the following columns
+            'days', 
+        CloudHistory:
+        """
+
+        self.cloudHistory = None
+        self.seeingHistory = seeingHistory 
+        self.startDate = startDate
+
+    @classmethod
+    def fromTxtFiles(cls,
+                     SeeingTxtFile=SeeingFile,
+                     CloudTxtFile=CloudFile):
+        """
+        build the class from txt files that are being used in OpSim
+
+        Parameters
+        ----------
+
+        Returns
+        -------
+        """
+        seeingHistory = pd.read_csv(SeeingTxtFile, delim_whitespace=True)
+        stripLeadingPoundFromHeaders(seeingHistory)
+
+        # seeingHistory.rename(columns={seeingHistory.columns[0]:
+        #                              seeingHistory.columns[0][1:]},
+        #                              inplace=True)
+
+        seeingHistory['days'] = seeingHistory['s_date'] / DAY_IN_SEC
+        seeingColNames = ['days', 'seeing']
+
+        cloudHistory = pd.read_csv(CloudTxtFile, delim_whitespace=True)
+        stripLeadingPoundFromHeaders(cloudHistory)
+
+        cloudHistory['days'] = cloudHistory['c_date'] / DAY_IN_SEC
+        cloudHistory.rename(columns={'cloud', 'cloudFraction'}, inplace=True)
+        cloudColNames = ['days', 'cloud']
+
+        return cls(seeingHistory=seeingHistory[seeingColNames],
+                   cloudHistory=cloudHistory)
+
+    def seeing(self, times, startDate=None, method='linearInterp'):
+        """
+        """
+        if startDate is None:
+            startDate = self.startDate
+            if startDate is None:
+                raise ValueError('startDate must be provided as an attribute or\
+                                 as a parameter to the method\n')
+
+        native_times = self.seeingHistory.days.values - startDate
+        native_seeing = self.seeingHistory.seeing.values 
+
+        if method == 'linearInterp':
+            return np.interp(times, native_times, native_seeing, period=max(native_times))
+        else:
+            raise ValueError('method not implemented \n')
+

obscond/io.py

@@ -0,0 +1,18 @@
+
+__all__=['stripLeadingPoundFromHeaders']
+
+def stripLeadingPoundFromHeaders(df):
+    """
+    on using `pandas.read_csv` on csv files with the header commented out with
+    a '#', The '#' is often added to the name of the the first column. This
+    function removes this pound in place.
+
+    Parameters
+    ----------
+    df : `pandas.dataFrame`
+
+    Returns
+    -------
+    None
+    """
+    df.rename(columns={df.columns[0]:df.columns[0][1:]}, inplace=True)

setup.py

@@ -15,11 +15,11 @@
 # Assign to __version__
 __version__ =  versionRegExp.findall(s)[0]
 
-setup(name='ObsCond',
+setup(name='obscond',
       version=__version__,
       description='Interpolating Observing Conditions from historic data',
       packages=['obscond'],
       package_dir={'obscond': 'obscond'},
-      package_data={'obscond': ['obscond/example_data/*.txt', 'obscond/example_data/*.md']},
+      package_data={'obscond': ['example_data/*.txt', 'example_data/*.md']},
       include_package_data=True
      )