Skip to content

Spatial notebook 1: intro text#950

Merged
sjspielman merged 18 commits intomasterfrom
sjspielman/944-expand-intro-text
Mar 17, 2026
Merged

Spatial notebook 1: intro text#950
sjspielman merged 18 commits intomasterfrom
sjspielman/944-expand-intro-text

Conversation

@sjspielman
Copy link
Member

@sjspielman sjspielman commented Mar 11, 2026

Closes #944
Stacked on #949 (gha will run once unstacked, and I can catch any lingering typos then)

This PR fleshes out text for the intro, import, and intro viz sections. While I was here, I referred somewhat to our scRNA-seq 04 notebook and caught a couple tiny things to fix there along the way.

Please let me know about:

  • content to emphasize further
  • content to de-emphasize
  • any reorganization
    • Something I went back and forth about is where to introduce aspects of the spatial technologies like spots, slide size, comparison to cytassist... I ended up integrating that into text where it came up rather than as part of a larger intro since I figure our slides will cover this as a larger intro already.

@sjspielman sjspielman marked this pull request as ready for review March 11, 2026 15:28
@sjspielman sjspielman requested review from allyhawkins and jashapiro and removed request for jashapiro March 11, 2026 15:28
Base automatically changed from sjspielman/923-924-normalize-and-pretty-plots to master March 11, 2026 21:32
Copy link
Member

@allyhawkins allyhawkins left a comment

Choose a reason for hiding this comment

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

Overall I think this looks pretty good. I just had some minor wording suggestions throughout, but I think most of the content is there.

Comment on lines +299 to +300
By default, this function only plot spots that overlay tissue (i.e. where `in_tissue` is 1) and ignore spots that do not overlay tissue.
We can override this if we want, but again, what we really want to do is actually remove those spots entirely.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
By default, this function only plot spots that overlay tissue (i.e. where `in_tissue` is 1) and ignore spots that do not overlay tissue.
We can override this if we want, but again, what we really want to do is actually remove those spots entirely.
By default, this function only plots spots that overlay tissue and ignores spots that do not overlay tissue.
`Space Ranger` determines which spots overlay tissue using the fiducial alignment frame, which we saw in the `"aligned_fiducials.jpg"` image.
Any spots that do not overlay tissue are indicated with a `0` in the `in_tissue` column of the `colData`.
We can override this if we want, but we really want to remove those spots entirely.

An alternate suggestion for when to talk bout the tissue overlay. I think this makes more sense since you're about to go into it in the next section.

Copy link
Member Author

Choose a reason for hiding this comment

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

I like this idea generally, but I still think I'll point out the in_tissue column just with fewer details before.

Copy link
Member

@jashapiro jashapiro left a comment

Choose a reason for hiding this comment

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

The overall content here looks good. My suggestions are mostly minor and formatting related, but a few wording suggestions too.

@sjspielman sjspielman requested a review from allyhawkins March 16, 2026 19:39
Copy link
Member

@allyhawkins allyhawkins left a comment

Choose a reason for hiding this comment

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

LGTM

@sjspielman sjspielman merged commit 81fd673 into master Mar 17, 2026
5 checks passed
@sjspielman sjspielman deleted the sjspielman/944-expand-intro-text branch March 17, 2026 18:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Spatial instruction notebook 1: Expand introduction section text

3 participants