Added 4 Sphinx gallery python tutorials #43
Draft
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Thank you. Are you sure the PNG static files should be versioned? |
|
@iosonofabio Hi Fabio, yes these PNG files in _static folder are manually added for gallery thumbnails and should be versioned :3 |
|
I disagree
…On Mon, Jun 23, 2025, at 16:02, Amber-Xu914 wrote:
*Amber-Xu914* left a comment (fabilab/cell_atlas_approximations_API#43)
<#43 (comment)>
@iosonofabio <https://github.com/iosonofabio> Hi Fabio, yes these PNG
files in _static folder are manually added for gallery thumbnails and
should be versioned :3
—
Reply to this email directly, view it on GitHub
<#43 (comment)>,
or unsubscribe
<https://github.com/notifications/unsubscribe-auth/AAJFEACORS3DCEJWM5UNCCD3FACF7AVCNFSM6AAAAAB75OUUFOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDSOJWGYZDIOBSGM>.
You are receiving this because you were mentioned.Message ID:
***@***.***>
|
iosonofabio
requested changes
Jun 23, 2025
| @@ -149,4 +149,11 @@ dmypy.json | |||
| # Files generated during package build and CMD check, unnecessary for the package | |||
| atlasapprox.Rcheck/ | |||
| .Rhistory | |||
| .RData | |||
| @@ -2,7 +2,8 @@ | |||
| Quickstart | |||
| ========== | |||
|
|
|||
| This example shows a quick and easy example of how to use atlasapprox to get and plot the expression of some gees in a specific organ of a specific organism. | |||
| This example shows a quick and easy example of how to use atlasapprox to get and plot the expression of some gees in a | |||
| @@ -19,3 +20,5 @@ | |||
| fig, ax = plt.subplots(figsize=(7, 4)) | |||
| sns.heatmap(expression, ax=ax) | |||
| fig.tight_layout() | |||
|
|
|||
| # sphinx_gallery_thumbnail_path = '_static/quickstart.png' | |||
| # ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
| # It's recommended to use a virtual environment to manage dependencies. Run the following command: | ||
| # | ||
| # ``python -m venv venv`` |
There was a problem hiding this comment.
Actually people typically put it into .venv - with a dot
|
|
||
| # List available organisms | ||
| available_organisms = api.organisms() | ||
| print(available_organisms) |
There was a problem hiding this comment.
Why not just printing the API call directly?
| # %% | ||
| # Visualizing the data | ||
| # -------------------- | ||
| # Visualization reveals patterns hidden by raw numbers. Organs vary in sampled cell totals, so raw counts can be misleading—those with more samples may appear to have higher cell type numbers, even if the type is rare. |
There was a problem hiding this comment.
Please cut the first clause, it sounds condescending
| # %% | ||
| # The bar chart indicates macrophages are highly abundant in the lung, comprising | ||
| # nearly 35% of sampled cells. This suggests the lung is a primary site for | ||
| # macrophage activity, while other organs like liver and bladder show moderate |
| # nearly 35% of sampled cells. This suggests the lung is a primary site for | ||
| # macrophage activity, while other organs like liver and bladder show moderate | ||
| # proportions, and many, such as pancreas and colon, exhibit minimal presence. | ||
| # The variation highlights the diverse roles macrophages play across the body's tissues. |
There was a problem hiding this comment.
Not sure what this means
| # | ||
| # For more detailed information, please refer to the `official documentation <https://atlasapprox.readthedocs.io/en/latest/python/index.html>`_. | ||
|
|
||
| # sphinx_gallery_thumbnail_path = '_static/cell_type.png' |
There was a problem hiding this comment.
Please let's make these dynamic
There was a problem hiding this comment.
Don't you already have a section on marker genes above? It feels like this tutorial might be redundant?
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Hi Fabio,
As discussed in the previous lab meeting, I’ve added 4 new tabs to the Sphinx gallery following the existing infrastructure. The source .py files are located in docs/gallery/python.
The gallery includes four Python tutorials now:
• Quickstart
• Beginner guide
• Explore average expression
• Explore cell type
• Explore marker genes
I followed Sphinx documentation conventions for file naming with numbered prefixes to ensure proper display order.
To generate the Sphinx gallery, simply run the make html command.
Please let me know if you have any feedback or require further adjustments.