Updated simulator notebook, fix for single pitch, protections for bad conditions.

[scfleming]

This PR:

• Fixes #43 where in case of single value will return center pitch.
• Updates simulator notebook to produce better sounds in transit cases by using better choices of zero point (doesn't rely on default median value, which is a poor choice in the simple case of two values). This effecively closes #42, at least for now.
• Fixes small bug when creating output directory in sim_lc.py.
• pitch_mapper() did not protect against a center pitch value that didn't fall within the pitch range. It now will check and if the center_pitch value is outside or equal to the bounds of the pitch_range, will fall back to define the center_pitch to be the middle of the range. May want to inform the user in some manner as a future PR if so?
• In rare cases (e.g., array of two flux values where median() is also the lowest of the two values) the default algorithm parameter choices result in a zero_point that is 0.0, which then results in an error divide by zero. To protect against this, pitch_mapper() will instead set the zero_point value to a small number (currently 1E-6) to avoid the division by zero. Normally this is because the user made a poor choice of sonification parameters, we should consider giving them more diagnostics in the case where their data+parameters result in bad distributions of pitches? Something to consider for the future perhaps?
• Minor style changes to satisfy pylint to the code I touched.

[scfleming]

@ceb8 I updated the .pynb but don't know the steps to convert to HTML for RTD (do you just run nbconvert on them?) Would you be able to take care of that part?

[ceb8]

@scfleming This looks great! I'm going to run the ipynb->rst before merging. Unfortunately right now it's more manual than I would like.

[codecov[bot]]

Codecov Report

Merging #44 (a65ffc2) into main (e74802a) will decrease coverage by 0.39%. The diff coverage is 54.54%.

@@            Coverage Diff             @@
##             main      #44      +/-   ##
==========================================
- Coverage   67.44%   67.05%   -0.40%     
==========================================
  Files          16       16              
  Lines         341      346       +5     
==========================================
+ Hits          230      232       +2     
- Misses        111      114       +3     

Impacted Files	Coverage Δ
astronify/series/series.py	77.95% <0.00%> (ø)
astronify/simulator/sim_lc.py	44.26% <0.00%> (ø)
astronify/utils/pitch_mapping.py	93.47% <66.66%> (-6.53%)	:arrow_down:

---

Continue to review full report at Codecov.

Legend - Click here to learn more Δ = absolute <relative> (impact), ø = not affected, ? = missing data Powered by Codecov. Last update e74802a...a65ffc2. Read the comment docs.

[ceb8]

@scfleming Remember to clear the output before commiting jupyter notebooks. (I'm going to deal with it by squashing when I merge this PR).

[scfleming]

Oh, I thought it needed to be there so nbconvert would display things like the plots in the rendered HTML. My bad.

[ceb8]

Thanks @scfleming !