update docs about runtime errors with numpy

.gitignore

@@ -14,6 +14,9 @@ cesium_app/Source/SampleData/eosim_data.czml
 core
 *.csv
 
+# files
+debug.log
+
 # compiled Python
 *.pyc
 

Makefile

@@ -18,7 +18,9 @@ help:
 
 all: bare install
 
-install:
+install: 
+# cartopy installation to be done prior to this. If using conda, can be done using the command `conda install -c conda-forge cartopy`
+# In case of Runtime errors involving numpy (after installation), try the following command: `pip install numpy --upgrade --ignore-installed`
 	pip install -e .
 
 clean: docs_clean

README.md

@@ -21,6 +21,19 @@ Run the application using the following command from terminal:
 python bin/eosimapp.py
 ```
 
+### Known Issues
+In some cases, *runtime* errors involving the numpy package such as the one below may ensue:
+```
+module compiled against API version 0xf but this version of numpy is 0xe
+```
+
+This may be due to incompatile numpy package installation.
+Please run the below command to fix it:
+```
+pip install numpy --upgrade --ignore-installed
+```
+
+
 ## Cesium App 
 The Cesium JavaScript app is based on the showcased example of Cesium features in the *cesium-workshop* repository. It is contained in the `.\cesium_app\` folder. 
 

setup.py

@@ -13,5 +13,9 @@ def readme():
     packages=['eosim'],
     scripts=[ 
     ],
+    # Cartopy installation may not work due to additional dependencies it requires. 
+    # CartoPy dependencies must be installed before running this setup.
+    # If using conda, cartopy along with its dependencies can be installed using the command `conda install -c conda-forge cartopy`
+    # In case of Runtime errors involving numpy, try the following command: `pip install numpy --upgrade --ignore-installed`
     install_requires=['numpy', 'pandas', 'scipy', 'lowtran', 'astropy', 'cartopy'] 
 )