Skip to content

docs: updating tutorial for ismb#469

Open
ntalluri wants to merge 20 commits into
Reed-CompBio:mainfrom
ntalluri:tutorial-update
Open

docs: updating tutorial for ismb#469
ntalluri wants to merge 20 commits into
Reed-CompBio:mainfrom
ntalluri:tutorial-update

Conversation

@ntalluri

Copy link
Copy Markdown
Collaborator

My current plan is to update the intermediate code to include evaluation / parameter selection. I will be leaving parameter tuning in the advanced capabilities section. I will also be editing the tutorial based on the comments from when Tony I presented at COMBINE.

@read-the-docs-community

read-the-docs-community Bot commented Apr 23, 2026

Copy link
Copy Markdown

Documentation build overview

📚 spras | 🛠️ Build #33167587 | 📁 Comparing 46f3594 against latest (87b314c)

  🔍 Preview build  

4 files changed
± tutorial/advanced.html
± tutorial/beginner.html
± tutorial/intermediate.html
± tutorial/introduction.html

@tristan-f-r tristan-f-r added the documentation Improvements or additions to documentation label Apr 25, 2026
@ntalluri

Copy link
Copy Markdown
Collaborator Author

Still need to add the information about running dev containers, but other than that, everything else is ready.

@ntalluri ntalluri marked this pull request as ready for review May 22, 2026 19:37
@ntalluri ntalluri requested review from agitter and annaritz May 22, 2026 19:37
Comment thread docs/_static/images/hac-vertical.png
Comment thread docs/tutorial/introduction.rst Outdated
Comment thread docs/tutorial/introduction.rst Outdated
Comment thread docs/tutorial/beginner.rst
Comment thread docs/tutorial/intermediate.rst Outdated
Comment thread docs/tutorial/intermediate.rst Outdated
Comment thread docs/tutorial/beginner.rst Outdated
Comment thread docs/tutorial/intermediate.rst Outdated
Comment thread docs/tutorial/intermediate.rst Outdated
Comment thread docs/tutorial/intermediate.rst Outdated
ntalluri and others added 4 commits May 28, 2026 16:53
Co-authored-by: Anthony Gitter <agitter@users.noreply.github.com>
@ntalluri ntalluri requested a review from agitter May 28, 2026 22:36

@agitter agitter left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just about ready. A few more minor comments.

# then myAlg will be run on (a=1,b=0.5),(a=1,b=0.75),(a=2,b=0.5), and (a=2,b=0,75). Pretty neat, but be
# careful: too many parameters might make your runs take a long time.

# TODO: get rid of the algorithms that will take too long to run

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we remove this TODO?

Comment thread docs/tutorial/introduction.rst Outdated
Comment thread docs/tutorial/introduction.rst Outdated
Comment on lines +124 to +135
.. note::

You may see the following error during installation:

.. code:: text

ERROR: pip's dependency resolver does not currently take into account all the packages that are installed. This behaviour is the source of the following dependency conflicts.
dsub 0.4.13 requires tenacity<=8.2.3, but you have tenacity 9.1.4 which is incompatible.

This is safe to ignore. We do not use dsub as a container option in
this tutorial, and a fix is currently in progress. SPRAS and this
tutorial will run correctly without a working dsub installation.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we remove this now? If you check the GitHub Actions build in #485, we can approve and merge that fix.

Co-authored-by: Anthony Gitter <agitter@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants