Gather demo notebooks from older standalones

[aimalz]

Some of the rail* repos created before the recent refactoring have single-estimator demos in nonuniformly named directories, but the recently made rail* repos had their demos moved to this repo. This issue is for gathering the single-estimator demos from the following places and sorting them into the demo directories under examples here:

• rail_gpz_v1 added_examples
• rail_flexzboost docs/notebooks
• rail_cmnn examples
• rail_bpz examples
• rail_fsps src/rail/added_examples

To document this change, @alice-crafford has made the helpful suggestion to add explanatory text in each subdirectory of rail/examples describing what can be found in each of the demos so users asking "Where should I look to see how to do X?" can answer their own questions rather than asking a developer every time. All the rail/examples subdirectories except for estimation_examples actually have a starting point in a README.md, so this is mostly about making sure those all exist, are complete, and have sufficient detail for a user to determine which they need.

(I think it's fine for this issue to just get the descriptions into READMEs until #42 is resolved, but the next step would be to ensure this content gets rendered on ReadTheDocs, which may entail moving their contents to other .rst files within rail/docs/source.)

[OliviaLynn]

My running notes -

Moving in:

Moved in:

• rail_gpz_v1: examples/estimation_examples/GPz_estimation_example.ipynb

  • Gather demos #73
  • Remove duplicate notebook #89

• rail_flexzboost: examples/estimation_examples/Fzboost_PDF_Representation_Comparison.ipynb

  • Gather demos #73

• rail_cmnn: examples/estimation_examples/CMNN_Demo.ipynb

  • Removing two outdated tests, changing pylint commands rail_cmnn#11
  • Fix utilities notebook and add cmnn #72

• rail_fsps src/rail/added_examples

  • Pending Notebook pipeline initialization issue rail_fsps#17 thanks Eric for the fix!
  • Adding fsps demo; adding fsps set-up to smoke test #118

• rail_bpz examples

  • (See Sam's comment for data details) Draft: Gather fsps, bpz, and cmnn demos #78
  • Initial tarfile download via get_data cli:
    • Download tarfile from NERSC rail_bpz#38
    • Add bpz-demo-data option to get-data command rail_base#55
  • Move in notebooks Move in bpz notebooks, update paths; copy over cmnn nb changes #109
  • Add remaining bpz files to get_data cli Add bpz files; reduce duplicated logic in if/else rail_base#76
  • Uncomment data download/untar commands; update writing to match #113

Pending:

Removing:

Removed:

• rail_gpz_v1 added_examples
  • Delete added_examples directory rail_gpz_v1#13
• rail_flexzboost docs/notebooks
  • Delete docs/notebooks directory rail_flexzboost#40
• rail_cmnn examples
  • Delete examples directory rail_cmnn#13
• rail_fsps src/rail/added_examples
  • Delete examples/creation_examples directory rail_fsps#19

Currently removing:

• rail_bpz examples
  • Delete examples directory rail_bpz#41

Notes

• Want to make sure I'm putting bpz data in logical places per Sam's comment on Draft: Gather fsps, bpz, and cmnn demos #78
• Need to copy over recent changes to CMNN notebook