Sorting-Algorithms-Blender
==========================
Sorting algorithms visualized using the Blender Python API.
Table of contents
=================
<!--ts-->
* [Introduction](#introduction)
* [Description](#description)
* [Getting Started](#getting-started)
* [Possible Updates](#possible-updates)
* [Sorting Algorithms](#sorting-algorithms)
* [Bubble Sort](#bubble-sort)
* [Insertion Sort](#insertion-sort)
* [Selection Sort](#selection-sort)
* [Shell Sort](#shell-sort)
* [Merge Sort](#merge-sort)
* [Quick Sort](#quick-sort)
* [Big O](#big-o)
* [What is Big O Notation?](#what-is-big-o-notation)
* [Time Complexity Notations](#time-complexity-notations)
* [Table of Sorting Algorithms](#table-of-sorting-algorithms)
<!--te-->
Introduction
============
## Description
Running one of the scripts in this project generates primitive meshes in Blender, wich are animated to visualize various sorting algorithms.<br>
The three folders <strong>(sort_color, sort_combined, sort_scale)</strong> contain three different types of visualisation.
<ul>
<li><a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color" target="_blank"><strong>sort_color: </strong></a>2D array of planes arragned into a square sorted based on color </li>
<li><a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_combined" target="_blank"><strong>sort_combined: </strong></a>multiple 2D arrays of planes arragned into a cube sorted based on color</li>
<li><a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale" target="_blank"><strong>sort_scale: </strong></a>array of cuboids sorted based on height + array access and comparison counter</li>
</ul>
## Getting Started
<ol>
<li>Download, install and start <a href="https://www.blender.org/">Blender<a>.</li>
<li>Open the .py file in the <a href="https://docs.blender.org/manual/en/latest/editors/text_editor.html"> Text Editor</a>.</li>
<li>Click the play button to run the script.</li>
</ol>
## Possible Updates
Below I compiled a list of features that could be implemented in the future.
<ul>
<li>increase efficienty of the setup_array() function, to allow greater object count</li>
<li>adding audio <a href= "https://www.youtube.com/watch?v=kPRA0W1kECg&t=57s">"Audibilization"</a> </li>
<li>adding more sorting algorithms</li>
<li>adding more types of visualisations e.g.
<a href="https://www.youtube.com/watch?v=_bxWi1sxRWA&t=194s">Sphere Agitation<a>,
<a href="https://www.youtube.com/watch?v=ohn_NwAQZtE">Cube Amalgam<a>,
<a href="https://www.youtube.com/watch?v=S0RtR2Yllzk">Dynamic Hoops<a></li>
<li>auto generate camera with correct transforms based on the count of sorted objects</li>
<li>create panel were you can choose different options like colors, sorting algorithms and count of objects</li>
<li>improve merge sort visualisation so there are no gaps and overlapping objects</li>
</ul>
Contributions to this project with either ideas from the list or your own are welcome.
Sorting Algorithms
==================
## Bubble Sort
<p>
Bubble sort is one of the most straightforward sorting algorithms, it makes multiple passes through a list.<br>
<ul>
<li>Starting with the first element, compare the current element with the next element of the array.</li>
<li>If the current element is greater than the next element of the array, swap them.</li>
<li>If the current element is less than the next element, move to the next element.</li>
</ul>
In essence, each item “bubbles” up to the location where it belongs.
</p>
| <a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale/bubble_sort_scale.py" target="_blank">bubble_sort_scale.py</a>|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color/bubble_sort_color.py" target="_blank">bubble_sort_color.py</a>|
| ------------- |:-------------:|
| ||
## Insertion Sort
<p>Like bubble sort, the insertion sort algorithm is straightforward to implement and understand.<br>
<ul>
<li>Iterate from arr[1] to arr[n] over the array.</li>
<li>Compare the current element (key) to its predecessor.</li>
<li>If the key element is smaller than its predecessor, compare its elements before.</li>
<li>Move the greater elements one position up to make space for the swapped element.</li>
</ul>
It splits the given array into sorted and unsorted parts,
then the values from the unsorted parts are picked and placed at the correct position in the sorted part.</p>
| <a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale/insertion_sort_scale.py" target="_blank">insertion_sort_scale.py</a>|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color/insertion_sort_color.py" target="_blank">insertion_sort_color.py</a>|
| ------------- |:-------------:|
|||
## Selection Sort
The selection sort algorithm sorts an array by repeatedly finding the minimum element (considering ascending order) from unsorted part and putting it at the beginning.<br> The algorithm maintains two subarrays in a given array.
<ul>
<li>The subarray which is already sorted.</li>
<li>Remaining subarray which is unsorted.</li>
</ul>
<p>In every iteration of selection sort, the minimum element (considering ascending order) from the unsorted subarray is picked and moved to the sorted subarray.</p>
|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale/selection_sort_scale.py" target="_blank">selection_sort_scale.py</a>|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color/selection_sort_color.py" target="_blank">selection_sort_color.py</a>|
| ------------- |:-------------:|
|||
## Shell Sort
<p>
The shell sort algorithm extends the insertion sort algorithm and is very efficient in sorting widely unsorted arrays.<br>
The array is divided into sub-arrays and then insertion sort is applied.<br>
The algorithm is:
<ul>
<li>Calculate the value of the gap.</li>
<li>Divide the array into these sub-arrays.</li>
<li>Apply the insertion sort.</li>
<li>Repeat this process until the complete list is sorted.</li>
</ul>
This sorting technique works by sorting elements in pairs, far away from each other and subsequently reduces their gap.<br> The gap is known as the interval. We can calculate this gap/interval with the help of Knuth’s formula.
</p>
|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale/shell_sort_scale.py" target="_blank">shell_sort_scale.py</a>|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color/shell_sort_color.py" target="_blank">shell_sort_color.py</a>|
| ------------- |:-------------:|
|||
## Merge Sort
Merge sort uses the divide and conquer approach to sort the elements. It is one of the most popular and efficient sorting algorithm.<br>
It divides the given list into two equal halves, calls itself for the two halves and then merges the two sorted halves.<br>
We have to define the merge() function to perform the merging.
The sub-lists are divided again and again into halves until the list cannot be divided further.<br>
Then we combine the pair of one element lists into two-element lists, sorting them in the process.<br>
The sorted two-element pairs is merged into the four-element lists, and so on until we get the sorted list.
| <a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale/merge_sort_scale.py" target="_blank">merge_sort_scale.py</a>|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color/merge_sort_color.py" target="_blank">merge_sort_color.py</a>|
| ------------- |:-------------:|
|||
## Quick Sort
Like Merge Sort, QuickSort is a Divide and Conquer algorithm. It picks an element as pivot and partitions the given array around the picked pivot. There are many different versions of quickSort that pick pivot in different ways.
<ul>
<li>Always pick first element as pivot.</li>
<li>Always pick last element as pivot.</li>
<li>Pick a random element as pivot.</li>
<li>Pick median as pivot. (implemented below)</li>
</ul>
The key process in quickSort is partition(). Target of partitions is, given an array and an element x of array as pivot, put x at its correct position in sorted array and put all smaller elements (smaller than x) before x, and put all greater elements (greater than x) after x.<br>
All this should be done in linear time.
| <a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_scale/quick_sort_scale.py" target="_blank">quick_sort_scale.py</a>|<a href="https://github.com/ForeignGods/Sorting-Algorithms-Blender/blob/main/sort_color/quick_sort_color.py" target="_blank">quick_sort_color.py</a>|
| ------------- |:-------------:|
|||
Big O
=====
### What is Big O Notation?
Big O notation is the language we use for talking about how long an algorithm takes to run.<br>
It's how we compare the efficiency of different approaches to a problem.<br>
With Big O notation we express the runtime in terms of **how quickly it grows relative to the input, as the input gets arbitrarily large.**
Let's break that down:
<ul>
<li><strong>how quickly the runtime grows</strong>
It's hard to pin down the exact runtime of an algorithm.<br>
It depends on the speed of the processor, what else the computer is running, etc. So instead of talking about the runtime directly, we use big O notation to talk about how quickly the runtime grows.</li>
<li><strong>relative to the input</strong>
If we were measuring our runtime directly, we could express our speed in seconds.<br>
Since we're measuring how quickly our runtime grows, we need to express our speed in terms of...something else.<br>
With Big O notation, we use the size of the input, which we call "n".<br>
So we can say things like the runtime grows "on the order of the size of the input" (O(n)) or "on the order of the square of the size of the input" (O(n^2)).</li>
<li><strong>as the input gets arbitrarily</strong>
Our algorithm may have steps that seem expensive when "n" is small but are eclipsed eventually by other steps as "n" gets huge.<br>
For big O analysis, we care most about the stuff that grows fastest as the input grows, because everything else is quickly eclipsed as "n" gets very large.</li>
</ul>
### Time Complexity Notations
These are the asymptotic notations that are used for calculating the time complexity of the sorting algorithms:
<ul>
<li>Big O Notation, O:</li>
It measures the upper limit of an algorithm's running time or the worst-case time complexity. It is known by O(n) for input size 'n'.
<li>Omega Notation, Ω:</li>
It measures the minimum time taken by algorithms to execute, and calculates the best case time complexity in sorting. It is known by Ω(n) for input size 'n'.
<li>Theta Notation, θ:</li>
It measures the average time taken by an algorithm to execute. Or, the lower bound and upper bound of an algorithm's running time. It is known by θ(n) for input size 'n'.
</ul>
### Table of Sorting Algorithms
<table>
<tr>
<th>Algorithm</th>
<th colspan="3">Time Complexity</th>
<th>Space Complexity</th>
</tr>
<tr>
<th></th>
<th>Best Case</th>
<th>Average Case</th>
<th>Worst Case</th>
<th>Worst Case</th>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Quicksort">Quick Sort</a></td>
<td><code class="orange">Ω(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">Θ(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="red">O(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="yellow-green">O(log(n))</code><br><img src="./img/good.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Merge_sort">Merge Sort</a></td>
<td><code class="orange">Ω(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">Θ(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">O(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="yellow">O(n)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Timsort">Tim Sort</a></td>
<td><code class="yellow">Ω(n)</code><br><img src="./img/fair.png" align="left"></td>
<td><code class="orange">Θ(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">O(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="yellow">O(n)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Heapsort">Heap Sort</a></td>
<td><code class="orange">Ω(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">Θ(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">O(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="green">O(1)</code><br><img src="./img/excellent.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Bubble_sort">Bubble Sort</a></td>
<td><code class="yellow">Ω(n)</code><br><img src="./img/fair.png" align="left"></td>
<td><code class="red">Θ(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="red">O(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="green">O(1)</code><br><img src="./img/excellent.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Insertion_sort">Insertion Sort</a></td>
<td><code class="yellow">Ω(n)</code><br><img src="./img/fair.png" align="left"></td>
<td><code class="red">Θ(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="red">O(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="green">O(1)</code><br><img src="./img/excellent.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Selection_sort">Selection Sort</a></td>
<td><code class="red">Ω(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="red">Θ(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="red">O(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="green">O(1)</code><br><img src="./img/excellent.png" align="left"></td>
</tr>
<tr>
<td><a href="https://en.wikipedia.org/wiki/Tree_sort">Tree Sort</a></td>
<td><code class="orange">Ω(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">Θ(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="red">O(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="yellow">O(n)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
<tr>
<td><a href="http://en.wikipedia.org/wiki/Shellsort">Shell Sort</a></td>
<td><code class="orange">Ω(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="red">Θ(n(log(n))^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="red">O(n(log(n))^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="green">O(1)</code><br><img src="./img/excellent.png" align="left"></td>
</tr>
<tr>
<td><a rel="tooltip" title="Only for integers. k is a number of buckets" href="http://en.wikipedia.org/wiki/Bucket_sort">Bucket Sort</a></td>
<td><code class="green">Ω(n+k)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="green">Θ(n+k)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="red">O(n^2)</code><br><img src="./img/horrible.png" align="left"></td>
<td><code class="yellow">O(n)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
<tr>
<td><a rel="tooltip" title="Constant number of digits 'k'" href="http://en.wikipedia.org/wiki/Radix_sort">Radix Sort</a></td>
<td><code class="green">Ω(nk)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="green">Θ(nk)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="green">O(nk)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="yellow">O(n+k)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
<tr>
<td><a rel="tooltip" title="Difference between maximum and minimum number 'k'" href="https://en.wikipedia.org/wiki/Counting_sort">Counting Sort</a></td>
<td><code class="green">Ω(n+k)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="green">Θ(n+k)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="green">O(n+k)</code><br><img src="./img/excellent.png" align="left"></td>
<td><code class="yellow">O(k)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
<tr>
<td><a href="https://en.wikipedia.org/wiki/Cubesort">Cube Sort</a></td>
<td><code class="yellow">Ω(n)</code><br><img src="./img/fair.png" align="left"></td>
<td><code class="orange">Θ(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="orange">O(n log(n))</code><br><img src="./img/bad.png" align="left"></td>
<td><code class="yellow">O(n)</code><br><img src="./img/fair.png" align="left"></td>
</tr>
</table>