Add tutorial notebook on CompaSO subsample particles

.gitignore

@@ -12,3 +12,4 @@ venv/
 *.code-workspace
 /env*
 abacusnbody/metadata/abacussummit_headers.asdf
+*-jvsc-*.ipynb

abacusnbody/data/compaso_halo_catalog.py

@@ -1,17 +1,12 @@
-"""
-"""
-
-"""
-The compaso_halo_catalog module loads halo catalogs from CompaSO, Abacus's
-on-the-fly halo finder. The module defines one class, CompaSOHaloCatalog,
-whose constructor takes the path to a halo catalog as an argument.
-Users should use this class as the primary interface to load and manipulate
-halo catalogs.
-
-A high-level overview of this module is given at
-https://abacusutils.readthedocs.io/en/latest/compaso.html
-or docs/compaso.rst.
-"""
+# The compaso_halo_catalog module loads halo catalogs from CompaSO, Abacus's
+# on-the-fly halo finder. The module defines one class, CompaSOHaloCatalog,
+# whose constructor takes the path to a halo catalog as an argument.
+# Users should use this class as the primary interface to load and manipulate
+# halo catalogs.
+
+# A high-level overview of this module is given at
+# https://abacusutils.readthedocs.io/en/latest/compaso.html
+# or docs/compaso.rst.
 
 import gc
 import os

docs/index.rst

@@ -38,6 +38,7 @@ and new features!
    :maxdepth: 2
    :caption: Tutorials
 
+   tutorials/compaso
    tutorials/light_cones
 
 .. toctree::

docs/tutorials/compaso.rst

@@ -0,0 +1,8 @@
+CompaSO
+-------
+
+.. toctree::
+   :maxdepth: 1
+   :caption: CompaSO
+
+   compaso/halo_subsample_particles