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:

• [x] rail_gpz_v1 added_examples
• [x] rail_flexzboost docs/notebooks
• [x] rail_cmnn examples
• [x] 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:

• [x] rail_gpz_v1: examples/estimation_examples/GPz_estimation_example.ipynb

  • 73

  • 89

• [x] rail_flexzboost: examples/estimation_examples/Fzboost_PDF_Representation_Comparison.ipynb

  • 73

• [x] rail_cmnn: examples/estimation_examples/CMNN_Demo.ipynb

  • LSSTDESC/rail_cmnn#11

  • 72

• [x] rail_fsps src/rail/added_examples

  • [x] Pending LSSTDESC/rail_fsps#17 thanks Eric for the fix!
  • [x] LSSTDESC/rail#118

• rail_bpz examples

  • [x] (See Sam's comment for data details) #78
  • [x] Initial tarfile download via get_data cli:
  • LSSTDESC/rail_bpz#38
  • LSSTDESC/rail_base#55
  • [x] Move in notebooks #109
  • [x] Add remaining bpz files to get_data cli LSSTDESC/rail_base#76
  • [x] LSSTDESC/rail#113

Pending:

Removing:

Removed:

• [x] rail_gpz_v1 added_examples
  • LSSTDESC/rail_gpz_v1#13
• [x] rail_flexzboost docs/notebooks
  • LSSTDESC/rail_flexzboost#40
• [x] rail_cmnn examples
  • LSSTDESC/rail_cmnn#13
• [x] rail_fsps src/rail/added_examples
  • LSSTDESC/rail_fsps#19

Currently removing:

• [ ] rail_bpz examples
  • LSSTDESC/rail_bpz#41

Notes

• [x] Want to make sure I'm putting bpz data in logical places per Sam's comment on #78
• [x] Need to copy over recent changes to CMNN notebook