Skip to content

Commit

Permalink
update documenation
Browse files Browse the repository at this point in the history
  • Loading branch information
sophiamaedler committed Jun 1, 2023
1 parent 84a2c44 commit a334b72
Show file tree
Hide file tree
Showing 86 changed files with 32,465 additions and 0 deletions.
1,705 changes: 1,705 additions & 0 deletions docs/doctrees/nbsphinx/pages/notebooks/example_sparcspy_project 2.ipynb

Large diffs are not rendered by default.

Binary file added docs/doctrees/pages/ecosystem 2.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added docs/doctrees/pages/module/ml 2.doctree
Binary file not shown.
Binary file not shown.
Binary file not shown.
11 changes: 11 additions & 0 deletions docs/html/_sources/pages/ecosystem.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
SPARCSpy Ecosystem
==================

This section will give you an overview of the SPARCSpy Ecosystem and make you familar with our datastructure.

.. toctree::
:maxdepth: 2
:caption: Ecosystem:

ecosystem/installation
notebooks/example_sparcspy_project.ipynb
62 changes: 62 additions & 0 deletions docs/html/_sources/pages/ecosystem/installation.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
.. _installation:

*******************
Installation
*******************

SPARCSpy has been tested with **Python 3.8 and 3.9**. We recommended installing the library within a conda environment.

To install the SPARCSpy library clone the Github repository and use pip to install the library in your current environment.
Please make sure that the package is installed editable (with the `-e` flag). Otherwise pretrained models might not be available.

We recommend installing the non-python dependencies with conda before installing SPARCSpy (especially if running on an M1 Silicon Mac):

.. code::

git clone https://github.com/MannLabs/SPARCSpy
cd SPARCSpy

conda create -n "SPARCSpy"
conda activate SPARCSpy
conda install python=3.9 scipy 'scikit-image>=0.19' scikit-fmm cellpose opencv numba -c conda-forge


In case you wish to utilize the ML capabilities of SPARCSpy (either for segmentation or classification) please follow the instructions `here <https://pytorch.org/get-started/locally/>`_ to install pytorch correctly for your operating system. Once this has been installed you can verify that pytorch is installed correctly by executing the following python code:

.. code:: python

import torch
x = torch.rand(5, 3)
print(x)

You can access the python console by typing `python` and exit it when you are finished by entering `exit()`.
The output should look something like this:

.. code:: python

tensor([[0.3380, 0.3845, 0.3217],
[0.8337, 0.9050, 0.2650],
[0.2979, 0.7141, 0.9069],
[0.1449, 0.1132, 0.1375],
[0.4675, 0.3947, 0.1426]])

Once you have installed pytorch according to the instructions we still need to install pytorch lightning. To do this run:

.. code::

conda install -c conda-forge pytorch-lightning

Currently SPARCSpy depends on a developer version of alphabase so please install the package from source by doing the following:

.. code::

pip install git+https://github.com/MannLabs/alphabase

Once these steps are completed you can proceed to install the SPARCSpy package via pip:

.. code::

pip install -e .

In case you wish to export shapes for excision on a Leica LMD please also install the `py-lmd <https://github.com/MannLabs/py-lmd>`_ library into the same conda environment
following the installation instructions `here <https://mannlabs.github.io/py-lmd/html/pages/quickstart.html#installation-from-github>`_.
5 changes: 5 additions & 0 deletions docs/html/_sources/pages/guides/basic_workflow.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
*******************
Basic Workflows
*******************

This will be the folder where we put tutorials
12 changes: 12 additions & 0 deletions docs/html/_sources/pages/module.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
Module Documentation
=====================

Documentation for all functions included in the SPARCSpy module.

.. toctree::
:maxdepth: 4
:caption: Module Documentation:

module/processing
module/pipeline
module/ml
59 changes: 59 additions & 0 deletions docs/html/_sources/pages/module/ml.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
*******************
ml
*******************

.. toctree::
:maxdepth: 3

datasets
########

.. automodule:: sparcscore.ml.datasets
:members:

metrics
########

.. automodule:: sparcscore.ml.metrics
:members:

models
########

.. autoclass:: sparcscore.ml.models.VGGBase
:members:
:show-inheritance: False

.. autoclass:: sparcscore.ml.models.VGG1
:members:
:show-inheritance:

.. autoclass:: sparcscore.ml.models.VGG2
:members:
:show-inheritance:


plmodels
########

.. autoclass:: sparcscore.ml.plmodels.MultilabelSupervisedModel
:members:
:show-inheritance: False

pretrained_models
#################

.. automodule:: sparcscore.ml.pretrained_models
:members:

transforms
###########

.. automodule:: sparcscore.ml.transforms
:members:

utils
###########

.. automodule:: sparcscore.ml.utils
:members:
107 changes: 107 additions & 0 deletions docs/html/_sources/pages/module/pipeline.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
*******************
pipeline
*******************

.. toctree::
:maxdepth: 3

base
#######

Logable
==============
.. autoclass:: sparcscore.pipeline.base.Logable
:members:

ProcessingStep
==============
.. autoclass:: sparcscore.pipeline.base.ProcessingStep
:members:
:show-inheritance:

project
#######

Project
=========
.. autoclass:: sparcscore.pipeline.project.Project
:members:
:show-inheritance:


TimecourseProject
=================
.. autoclass:: sparcscore.pipeline.project.TimecourseProject
:members:
:show-inheritance:


segmentation
#############

Segmentation
==============
.. autoclass:: sparcscore.pipeline.segmentation.Segmentation
:members:
:show-inheritance:

ShardedSegmentation
=====================
.. autoclass:: sparcscore.pipeline.segmentation.ShardedSegmentation
:members:
:show-inheritance:

TimecourseSegmentation
======================
.. autoclass:: sparcscore.pipeline.segmentation.TimecourseSegmentation
:members:
:show-inheritance:

MultithreadedTimecourseSegmentation
===================================
.. autoclass:: sparcscore.pipeline.segmentation.MultithreadedSegmentation
:members:
:show-inheritance:


workflows
##########
.. automodule:: sparcscore.pipeline.workflows
:members:

extraction
###########

HDF5CellExtraction
===================
.. autoclass:: sparcscore.pipeline.extraction.HDF5CellExtraction
:members:
:show-inheritance:

TimecourseHDF5CellExtraction
============================
.. autoclass:: sparcscore.pipeline.extraction.TimecourseHDF5CellExtraction
:members:
:show-inheritance:


classification
##############

MLClusterClassifier
===================
.. autoclass:: sparcscore.pipeline.classification.MLClusterClassifier
:members:
:show-inheritance:

.. automethod:: __call__

selection
###########

LMDSelection
==============
.. autoclass:: sparcscore.pipeline.selection.LMDSelection
:members:
:show-inheritance:

18 changes: 18 additions & 0 deletions docs/html/_sources/pages/module/processing.rst 2.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
*******************
processing
*******************

utils
######
.. automodule:: sparcscore.processing.utils
:members:

preprocessing
#############
.. automodule:: sparcscore.processing.preprocessing
:members:

segmentation
############
.. automodule:: sparcscore.processing.segmentation
:members:
Loading

0 comments on commit a334b72

Please sign in to comment.