Skip to content

[MRG]: Update and include BatchSimulate documentation #1019

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Conversation

asoplata
Copy link
Collaborator

@asoplata asoplata commented Mar 18, 2025

This PR does the following:

  1. Promotes BatchSimulate to a top-level class befitting its status as a member of the public API. This means that its import is analogous to other public classes: just like from hnn_core import Network, you can now from hnn_core import BatchSimulate without having to import it strictly from its own module. This puts it on equal footing with the other classes described in the public API https://jonescompneurolab.github.io/hnn-core/stable/api.html . The example script for BatchSimulate has been updated to include this new import way.
  2. Moves around the docstrings of BatchSimulate so they display properly on the sphinx build (i.e. the code website).
  3. Adds a WARNING to the docstring of any backend options which indicate that only loky should be used right now (since the other backends do not work out of the box, see updates to BUG: Re-evaluate BatchSimulate backends #955).
  4. Minor text polishing of docstrings.

@asoplata asoplata added the docs Documentation and tutorials label Mar 18, 2025
@asoplata asoplata requested a review from ntolley March 18, 2025 15:34
@asoplata
Copy link
Collaborator Author

@ntolley What do you think of the backend WARNING here: 0889616#diff-f2780322abf4ffe47adb1211d552f3809ea8e151a810b91230a42a945f08104aR198-R200 ?

@dylansdaniels
Copy link
Collaborator

Reviewed and looks good. No code changes, just some reordering and improvements to the documentation. Will merge

@dylansdaniels dylansdaniels merged commit ca8c89c into jonescompneurolab:master Mar 27, 2025
12 checks passed
carolinafernandezp pushed a commit to carolinafernandezp/hnn-core that referenced this pull request Jun 4, 2025
…rolab#1019)

* api: promote BatchSimulate to top-level import

* doc: clean and publish BatchSimulate api docs

* fix: linkcheck broken build with BatchSimulate
@asoplata asoplata deleted the doc-remove-batch-backend-docstrings branch June 18, 2025 21:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Documentation and tutorials
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants