Add public API skeletons and export ml module (#1081)

* Add public API skeletons and export ml module

* Make modifications according to new specs, add shared assertions and internel helper placeholders

* Add tests for private functions

* Modify data types and function usage

Author: lyraluoyu

docs/api.rst

@@ -242,6 +242,27 @@ all NiMARE workflows.
    transforms.z_to_t
    transforms.z_to_p
 
+.. _api_ml_ref:
+
+:mod:`nimare.ml`: Machine-learning helpers
+-----------------------------------------------------
+
+.. automodule:: nimare.ml
+   :no-members:
+   :no-inherited-members:
+
+.. currentmodule:: nimare
+
+.. autosummary::
+   :toctree: generated/
+   :template: class.rst
+
+   ml.MAFeatureDataset
+   ml.MAFeatureExtractor
+   :template: function.rst
+
+   ml.make_map_reducer
+
 
 .. _api_extract_ref:
 

nimare/__init__.py

@@ -17,6 +17,7 @@
         decode,
         io,
         meta,
+        ml,
         reports,
         resources,
         stats,
@@ -29,6 +30,7 @@
     __all__ = [
         "base",
         "dataset",
+        "ml",
         "meta",
         "correct",
         "annotate",