catalystneuro / roiextractors

Python-based module for extracting from, converting between, and handling optical imaging data from several file formats. Inspired by SpikeInterface.
https://roiextractors.readthedocs.io/en/latest/index.html
BSD 3-Clause "New" or "Revised" License
12 stars 7 forks source link

Update Docs #282

Closed pauladkisson closed 8 months ago

pauladkisson commented 9 months ago

Update documentation with new info previously found in the readme, and some style/CI changes.

CodyCBakerPhD commented 9 months ago

OK goal here is to get the docs to build successfully on the PR with the pydata theme

pauladkisson commented 9 months ago

Is there a way for me to get access to the readthedocs account associated with roiextractors?

CodyCBakerPhD commented 9 months ago

Is there a way for me to get access to the readthedocs account associated with roiextractors?

I'd need your RTD username

pauladkisson commented 9 months ago

I'd need your RTD username

It's pauladkisson

CodyCBakerPhD commented 9 months ago

Out of curiosity, are you unable to see the details from the log build without admin access? https://readthedocs.org/projects/roiextractors/builds/23351775/

pauladkisson commented 9 months ago

Out of curiosity, are you unable to see the details from the log build without admin access? https://readthedocs.org/projects/roiextractors/builds/23351775/

Yeah, turns out I could see pretty much all the details without full access, I just wanted to be sure I wasn't missing anything.

pauladkisson commented 9 months ago

This is now successfully building the docs but throws out a bunch of (non-breaking) import errors when I build locally, so the API documentation seems like it still needs some work. Nevertheless, I think I would like to merge this PR here, and later swing back around to fix the API documentation (see #184).

CodyCBakerPhD commented 9 months ago

Indeed looks as if the API docs will take some work to cleanup; could you at least suppress them here so they don't show up that way on main, then polish in follow-up?

pauladkisson commented 9 months ago

Indeed looks as if the API docs will take some work to cleanup; could you at least suppress them here so they don't show up that way on main, then polish in follow-up?

Done

CodyCBakerPhD commented 9 months ago

It might be kind of petty, but I'd prefer to have the section numbering removed - I don't think it really adds much here; what do you think?

CodyCBakerPhD commented 9 months ago

Ahhh, just noticed this as well on the front page

ROI Stands for Region Of Interest, which is the region in a set of acquired fluorescence images which the segmentation software has determined as a neuron.

Not entirely true; perhaps change to

"which is the set of pixels from acquired fluorescence images which the segmentation software has determined to follow a particular cellular structure." or something similar? Maybe @alessandratrapani can improve description even more

We've seen cases in last years of ROIs being (i) glia, not neurons, (ii) dendritic branches or axon trajectories, (iii) segmentation by cell type based on morphology, (iv) edge case of considering neurotransmitter densities as the ROI of fibre photometry

CodyCBakerPhD commented 9 months ago

Also on main page, what are STK and FLI formats? Have I forgotten about those extractors?

CodyCBakerPhD commented 9 months ago

Also on main page, we don't save to NWB format with this package (which is only for reading) so I'd remove that or potentially add a cross link to NeuroConv to let people know they can use that to write to NWB

alessandratrapani commented 8 months ago

Ahhh, just noticed this as well on the front page

ROI Stands for Region Of Interest, which is the region in a set of acquired fluorescence images which the segmentation software has determined as a neuron.

Not entirely true; perhaps change to

"which is the set of pixels from acquired fluorescence images which the segmentation software has determined to follow a particular cellular structure." or something similar? Maybe @alessandratrapani can improve description even more

We've seen cases in last years of ROIs being (i) glia, not neurons, (ii) dendritic branches or axon trajectories, (iii) segmentation by cell type based on morphology, (iv) edge case of considering neurotransmitter densities as the ROI of fibre photometry

I agree with you. I think the description it's already very good.