Skip to content

Commit

Permalink
last push before submit to joss
Browse files Browse the repository at this point in the history
  • Loading branch information
cudmore committed Jul 17, 2023
2 parents d55e65b + e961521 commit 95997cd
Show file tree
Hide file tree
Showing 11 changed files with 118 additions and 119 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ A Python package of path-finding algorithms to find the brightest path between p

## Getting Started

To install and get started with using this `brightest-path-lib`, please visit the [documentation website](https://mapmanager.net/brightest-path-lib/installation/).
To install and get started with the `brightest-path-lib`, please visit the [documentation website](https://mapmanager.net/brightest-path-lib/installation/).

For more detailed instructions on how to use the `brightest-path-lib`, please see the [API documentation](https://mapmanager.net/brightest-path-lib/api_docs/).

Expand Down
3 changes: 3 additions & 0 deletions docs/about.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
The brightest-path-tracing Python package was developed by [Vasudha Jha](https://github.com/VasudhaJha) as a Computer Science Masters project in collaboration with [Robert Cudmore](https://github.com/cudmore) in the [Cudmore lab](https://cudmorelab.github.io/) at the University of California at Davis.

Please get in touch if you would like to use any of our tools.
Binary file removed docs/assets/images/a-star.mov
Binary file not shown.
Binary file added docs/assets/images/astar-v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/images/nbastar-v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/assets/images/tracing-plugin.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
16 changes: 13 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,26 @@ The `brightest-path-lib` is a Python library which allows users to efficiently f
<figcaption>Finding Brightest Path using NBA* Search</figcaption>
</figure> -->

![Finding Brightest Path using A* Search](./assets/images/astar.gif)
## Examples

In these examples, a search is performed from the user specified start (green) and stop (red) points. The progress of the search is animated as cyan fill color and the final brightest-path is shown in yellow.

Finding Brightest Path using A* Search
![Finding Brightest Path using A* Search](./assets/images/astar-v2.gif)

![Finding Brightest Path using NBA* Search](./assets/images/nbastar.gif)
Finding Brightest Path using NBA* Search
![Finding Brightest Path using NBA* Search](./assets/images/nbastar-v2.gif)

## Capabilities

With its efficient implementation and intuitive API, this library is a valuable tool for anyone working with 2D or 3D images who needs to identify the path with the maximum brightness.

- The library provides easy-to-use functions that take the image data and start and end points as input and return the path with the maximum brightness as output.
- It supports both grayscale and color images and can handle images of arbitrary sizes.
- The library also provides support for users to know which points in the image are being considered for the brightest path in real-time so that they display them on the original image.

With its efficient implementation and intuitive API, this library is a valuable tool for anyone working with 2D or 3D images who needs to identify the path with the maximum brightness. We are using it for neuronal tracing to identify the path of a neuron or a set of neurons through a stack of images in our Napari Plugin.
## Napi Plugin

We have also created a [Napari Tracing Plugin](https://github.com/mapmanager/napari-tracing) to provide an intuititive graphical-user-interface that uses the `brightest-path-lib`` package. We are using this to trace neuronal dendrites and axons.

![Napari Tracing Plugin](./assets/images/tracing-plugin.png)
16 changes: 13 additions & 3 deletions docs/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,16 +9,26 @@ The `brightest-path-lib` is a Python library which allows users to efficiently f
<figcaption>Finding Brightest Path using NBA* Search</figcaption>
</figure> -->

![Finding Brightest Path using A* Search](./assets/images/astar.gif)
## Examples

In these examples, a search is performed from the user specified start (green) and stop (red) points. The progress of the search is animated as cyan fill color and the final brightest-path is shown in yellow.

Finding Brightest Path using A* Search
![Finding Brightest Path using A* Search](./assets/images/astar-v2.gif)

![Finding Brightest Path using NBA* Search](./assets/images/nbastar.gif)
Finding Brightest Path using NBA* Search
![Finding Brightest Path using NBA* Search](./assets/images/nbastar-v2.gif)

## Capabilities

With its efficient implementation and intuitive API, this library is a valuable tool for anyone working with 2D or 3D images who needs to identify the path with the maximum brightness.

- The library provides easy-to-use functions that take the image data and start and end points as input and return the path with the maximum brightness as output.
- It supports both grayscale and color images and can handle images of arbitrary sizes.
- The library also provides support for users to know which points in the image are being considered for the brightest path in real-time so that they display them on the original image.

With its efficient implementation and intuitive API, this library is a valuable tool for anyone working with 2D or 3D images who needs to identify the path with the maximum brightness. We are using it for neuronal tracing to identify the path of a neuron or a set of neurons through a stack of images in our Napari Plugin.
## Napi Plugin

We have also created a [Napari Tracing Plugin](https://github.com/mapmanager/napari-tracing) to provide an intuititive graphical-user-interface that uses the `brightest-path-lib`` package. We are using this to trace neuronal dendrites and axons.

![Napari Tracing Plugin](./assets/images/tracing-plugin.png)
104 changes: 40 additions & 64 deletions docs/simple_notebook.ipynb

Large diffs are not rendered by default.

95 changes: 47 additions & 48 deletions docs/threading_notebook.ipynb

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -37,4 +37,5 @@ nav:
- Tutorials:
- simple_notebook.ipynb
- threading_notebook.ipynb
- About: about.md

0 comments on commit 95997cd

Please sign in to comment.