Skip to content

Commit

Permalink
📝 [documentation] updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
vishalpaudel committed Jun 19, 2024
1 parent 35f7932 commit 4ab1aab
Show file tree
Hide file tree
Showing 2 changed files with 29 additions and 8 deletions.
33 changes: 25 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,36 @@ https://github.com/gyanantaran/searchViz/assets/95016059/8a3eab8e-1456-48a5-a91c

<img width="709" alt="Screenshot 2024-04-09 at 12 57 55 AM" src="https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1">

## Contributions

## A Nice Demo Video
All contributions/suggestions are welcome!

## Introduction

Search methods are boring and fruitless untill they are visualised. Depth first search feels like a random walker on a lonely island. Breadth first search is like a stow but steady fire burning through a dense forestry. Don't believe me? See for your selves! Also, feel free to try writing your very own search methods, with the current API (not documented, only examples available inside searchViz/src/searchViz/Search.py::DFS and BFS).

## Instructions to build the project

```sh
cd searchViz # cd into the cloned directory
pip install -r requirements.txt # basically installs numpy and pygame
python src/main.py # run the entry-point file

# now just press spacebar to play or pause the search for the current search-method. DFS is the default.
```

## Some Demo examples

A nice and long, demo video:

[![A long Walkthrough Video -- searchViz](https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1)](https://youtu.be/BKF-PEgd1PA?t=393)

<!-- https://user-images.githubusercontent.com/95016059/273106123-19ccd387-f563-4078-825d-e62327bfdde7.mp4 -->

A short Walkthrough:

[![Short Walkthrough Video -- searchViz](https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1)](https://youtu.be/kNGsOoWh9fM?t=2)

## Features

1. Nodes distributions can be one of a few options (gaussian, unifrom)
Expand All @@ -20,10 +43,4 @@ https://github.com/gyanantaran/searchViz/assets/95016059/8a3eab8e-1456-48a5-a91c

1. Using vectorized functions in numpy

Contributions and feedbacks are welcome!

## A short Walkthrough

[![Short Walkthrough Video -- searchViz](https://github.com/gyanantaran/searchViz/assets/95016059/0de525e8-0363-47e3-87e7-8591f35fecb1)](https://youtu.be/kNGsOoWh9fM?t=2)

@vishalpaudel
creative commons License, copyright, gyanantaran aka vishalpaudel 2022.
4 changes: 4 additions & 0 deletions requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
numpy==2.0.0
pygame==2.5.2
setuptools==70.0.0
wheel==0.43.0

0 comments on commit 4ab1aab

Please sign in to comment.