Adding contrast_sensitivity notebook (#324)

* Adding contrast_sensitivity notebook, updating toc.yml, README, and gitignore

* PEP 8 fixes

* syntax warnings

* fixing syntax errors with comparing literals

* fix styling/syntax

---------

Co-authored-by: gibsongreen <[email protected]>

_toc.yml

@@ -63,6 +63,7 @@ parts:
     - file: notebooks/STIS/view_data/view_data.ipynb
     - file: notebooks/STIS/extraction/1D_Extraction.ipynb
     - file: notebooks/STIS/low_count_uncertainties/Low_Count_Uncertainties.ipynb
+    - file: notebooks/STIS/contrast_sensitivity/STIS_Coronagraphic_Observation_Feasibility.ipynb
   - caption: WFC3
     chapters:
     - file: notebooks/WFC3/README.md

notebooks/.gitignore

@@ -36,3 +36,5 @@ MAST/Kepler/Kepler_TPF/mastDownload/
 !**/skyfile.txt
 !**/exclusions.txt
 !**/inclusions*.txt
+!STIS/contrast_sensitivity/ETC_example.jpg
+!STIS/contrast_sensitivity/TWHya.txt

notebooks/STIS/README.md

@@ -7,6 +7,8 @@ The current operational notebooks with a short description:
 
 ### STIS Coronagraphic Visualization Tool (CoronagraphyViz)
 Jupyter Notebook that assists users in planning and preparing STIS coronagraphic observations.
+### STIS Coronagraphic Observation Feasibility (constrast_sensitivity)
+A complimentary notebook to the Coronagraphic Visualization Tool, that acts as a guide to assess the feasibility of high-contrast imaging observations of point sources (i.e. exoplanets, brown dwarf companions) and/or disks around stars for a given expected contrast at the 1, 3 and 5 $\sigma$ level with STIS coronagraphy.
 ### STIS DrizzlePac Tutorial (drizpac_notebook)
 Jupyter Notebook for aligning and combining STIS images with [DrizzlePac](https://www.stsci.edu/scientific-community/software/drizzlepac.html). 
 ### Viewing STIS Data (view_data)

notebooks/STIS/contrast_sensitivity/GO12923raw.dat

@@ -0,0 +1,89 @@
+#r(")	Med.Contr/px	err_Med.Contr/px
+0.225	1.03801e-03	2.38558e-05
+0.275	5.99395e-04	1.16666e-04
+0.325	4.80774e-04	9.13354e-05
+0.375	3.41878e-04	7.79185e-05
+0.425	2.50762e-04	3.95687e-05
+0.475	2.02378e-04	1.83912e-05
+0.525	1.52907e-04	1.53782e-05
+0.575	1.18198e-04	1.47812e-05
+0.625	1.00455e-04	1.29091e-05
+0.675	8.47489e-05	1.00150e-05
+0.725	7.07549e-05	7.52194e-06
+0.775	5.84796e-05	6.26959e-06
+0.825	4.77119e-05	6.54608e-06
+0.875	4.22602e-05	6.76270e-06
+0.925	3.64204e-05	5.57618e-06
+0.975	3.22307e-05	4.76458e-06
+1.025	2.94713e-05	3.44906e-06
+1.075	2.66426e-05	3.74232e-06
+1.125	2.50548e-05	3.46150e-06
+1.175	2.29071e-05	2.79111e-06
+1.225	2.11947e-05	2.82655e-06
+1.275	2.05736e-05	2.92009e-06
+1.325	1.92578e-05	2.80669e-06
+1.375	1.77092e-05	2.80179e-06
+1.425	1.71141e-05	2.94597e-06
+1.475	1.54688e-05	2.86470e-06
+1.525	1.43795e-05	2.59273e-06
+1.575	1.34089e-05	2.38882e-06
+1.625	1.22792e-05	2.11045e-06
+1.675	1.12224e-05	1.99796e-06
+1.725	1.07173e-05	1.83143e-06
+1.775	1.00761e-05	1.73875e-06
+1.825	9.18950e-06	1.69094e-06
+1.875	8.28843e-06	1.54942e-06
+1.925	7.95552e-06	1.47887e-06
+1.975	7.35777e-06	1.45991e-06
+2.025	6.83176e-06	1.16803e-06
+2.075	6.35545e-06	1.16560e-06
+2.125	5.97843e-06	1.07451e-06
+2.175	5.21944e-06	9.50909e-07
+2.225	4.88599e-06	8.43229e-07
+2.275	4.47248e-06	8.56552e-07
+2.325	4.26545e-06	7.68433e-07
+2.375	3.86498e-06	7.04530e-07
+2.425	3.68502e-06	7.50332e-07
+2.475	3.46489e-06	6.73166e-07
+2.525	3.11345e-06	6.10878e-07
+2.575	2.97394e-06	6.63661e-07
+2.625	2.62476e-06	5.72699e-07
+2.675	2.60534e-06	5.28865e-07
+2.725	2.27288e-06	5.57298e-07
+2.775	2.17230e-06	5.49781e-07
+2.825	2.11770e-06	5.87420e-07
+2.875	1.89851e-06	5.62019e-07
+2.925	1.78394e-06	4.74542e-07
+2.975	1.73459e-06	5.47693e-07
+3.025	1.60458e-06	4.39815e-07
+3.075	1.51367e-06	4.01150e-07
+3.125	1.36585e-06	4.25254e-07
+3.175	1.23599e-06	4.12389e-07
+3.225	1.25606e-06	4.25395e-07
+3.275	1.14221e-06	3.67276e-07
+3.325	1.15169e-06	3.21721e-07
+3.375	9.89132e-07	3.30580e-07
+3.425	9.94492e-07	3.26285e-07
+3.475	8.20824e-07	3.04473e-07
+3.525	8.09533e-07	2.42627e-07
+3.575	7.80451e-07	2.91564e-07
+3.625	7.70439e-07	2.26328e-07
+3.675	7.38784e-07	2.03210e-07
+3.725	7.39050e-07	2.15530e-07
+3.775	6.87191e-07	2.63809e-07
+3.825	6.11774e-07	1.59172e-07
+3.875	5.84561e-07	1.77266e-07
+3.925	6.38652e-07	1.93614e-07
+3.975	5.97843e-07	1.95915e-07
+4.025	5.84100e-07	1.09034e-07
+4.075	5.99947e-07	2.38597e-07
+4.125	5.80897e-07	1.65232e-07
+4.175	5.64639e-07	2.90089e-07
+4.225	6.73398e-07	2.14404e-07
+4.275	6.20875e-07	1.68854e-07
+4.325	6.02270e-07	3.36094e-07
+4.375	6.11524e-07	1.62882e-07
+4.425	6.92455e-07	1.65320e-07
+4.475	4.82357e-07	2.12092e-07
+4.525	5.60784e-07	2.27414e-07
+4.575	1.09160e-06	6.84357e-08

notebooks/STIS/contrast_sensitivity/TWHya.txt

@@ -0,0 +1,92 @@
+      0.17748500   9.4961941e-05
+      0.22819500   3.9134884e-05
+      0.27890500   3.7806404e-05
+      0.32961500   2.5732803e-05
+      0.38032499   2.1022722e-05
+      0.43103501   1.7195870e-05
+      0.48174500   1.8721342e-05
+      0.53245503   1.7150865e-05
+      0.58316499   1.7409794e-05
+      0.63387501   1.7328167e-05
+      0.68458498   1.6596034e-05
+      0.73529500   1.5777759e-05
+      0.78600502   1.3946544e-05
+      0.83671498   1.2002959e-05
+      0.88742501   1.0549683e-05
+      0.93813503   9.2420608e-06
+      0.98884499   7.7750415e-06
+       1.0395550   6.3766956e-06
+       1.0902650   5.2624844e-06
+       1.1409750   4.5394760e-06
+       1.1916850   3.7611928e-06
+       1.2423950   3.1459261e-06
+       1.2931050   2.6827853e-06
+       1.3438150   2.2668047e-06
+       1.3945251   1.9497855e-06
+       1.4452350   1.8869374e-06
+       1.4959450   1.8461047e-06
+       1.5466551   1.7618986e-06
+       1.5973650   1.7224215e-06
+       1.6480750   1.6739355e-06
+       1.6987849   1.5989566e-06
+       1.7494950   1.5218027e-06
+       1.8002050   1.5041256e-06
+       1.8509150   1.4449528e-06
+       1.9016250   1.3928273e-06
+       1.9523350   1.3819503e-06
+       2.0030451   1.3790562e-06
+       2.0537550   1.3583481e-06
+       2.1044650   1.3204611e-06
+       2.1551750   1.2815851e-06
+       2.2058849   1.2077937e-06
+       2.2565949   1.1492777e-06
+       2.3073051   1.0991132e-06
+       2.3580151   1.0272134e-06
+       2.4087250   9.5226625e-07
+       2.4594350   8.9400578e-07
+       2.5101449   8.2594631e-07
+       2.5608549   7.3878621e-07
+       2.6115651   6.7769522e-07
+       2.6622751   6.3009099e-07
+       2.7129850   5.6106793e-07
+       2.7636950   5.0554406e-07
+       2.8144050   4.6169320e-07
+       2.8651149   4.1530910e-07
+       2.9158249   3.6785377e-07
+       2.9665351   3.3745402e-07
+       3.0172451   3.0162551e-07
+       3.0679550   2.6816432e-07
+       3.1186650   2.4291081e-07
+       3.1693749   2.2151768e-07
+       3.2200849   1.9685456e-07
+       3.2707951   1.7154107e-07
+       3.3215051   1.5480806e-07
+       3.3722150   1.3967088e-07
+       3.4229250   1.2633268e-07
+       3.4736350   1.1566265e-07
+       3.5243449   1.0685886e-07
+       3.5750551   9.6998079e-08
+       3.6257651   8.8894856e-08
+       3.6764750   8.7624288e-08
+       3.7271850   7.8627339e-08
+       3.7778950   7.0584967e-08
+       3.8286049   6.6097011e-08
+       3.8793149   6.3948648e-08
+       3.9300251   5.6056725e-08
+       3.9807351   5.2978680e-08
+       4.0314450   5.0336518e-08
+       4.0821552   4.4774931e-08
+       4.1328650   3.9992016e-08
+       4.1835752   4.0740287e-08
+       4.2342849   3.8832580e-08
+       4.2849951   3.3798415e-08
+       4.3357048   3.1803566e-08
+       4.3864150   3.0862933e-08
+       4.4371252   2.6617100e-08
+       4.4878349   2.5489222e-08
+       4.5385451   2.4753864e-08
+       4.5892549   2.0979992e-08
+       4.6399651   1.8804356e-08
+       4.6906748   1.7692472e-08
+       4.7413850   1.6520689e-08
+       4.7920952   1.4450005e-08

notebooks/STIS/contrast_sensitivity/requirements.txt

@@ -0,0 +1,2 @@
+numpy
+matplotlib