Metadata-Version: 2.4
Name: rationalize_sqrt
Version: 0.7.2
Summary: command-line app for finding multipliers of square roots
License-File: LICENSE.md
Author: K1CE
Author-email: 6kouman@gmail.com
Requires-Python: >=3.9
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Project-URL: GitHub, https://github.com/K1CE/Square-Root_rationalizer
Description-Content-Type: text/markdown

<p align="center"><img width="462" height="100" src="https://github.com/user-attachments/assets/1c3ab3bb-cb59-48ff-8c06-b01d2a2a24a2"></p>

<div align="center" markdown="1">
  
  [![pypi version](https://img.shields.io/pypi/v/rationalize-sqrt)](https://pypi.org/project/rationalize-sqrt/#description)
  [![python version](https://img.shields.io/pypi/pyversions/rationalize-sqrt)](https://www.python.org/)
  [![issues](https://img.shields.io/github/issues-raw/K1CE/Square-Root_rationalizer)](https://github.com/K1CE/Square-Root_rationalizer/issues)
  [![GitHub License](https://img.shields.io/github/license/K1CE/Square-Root_rationalizer)](https://github.com/K1CE/Square-Root_rationalizer/blob/main/LICENSE.md)
 ![Repo Stars](https://img.shields.io/github/stars/K1CE/Square-Root_rationalizer)
</div>

# △
  A way to rationalize a square root to a whole number. make your square root whole.

  This project is intended to be used as a simple calculator for bruteforcing and displaying different variations of irrational square-roots. 
  I quickly built this for myself in a couple hours to fix an issue with my design work. By using this app I found a strong candidate for the 
  side lengths of my hexagon's broken down model. When splayed out into triangles and squares each side length could be approximately represented
  in whole numbers. 

<img width="300" height="300" alt="reasexample" src="https://github.com/user-attachments/assets/c49c86e3-8bbc-4029-8a7b-e3e87ca28e8a" />       |  <img width="793" height="300" alt="image" src="https://github.com/user-attachments/assets/f538403e-96d3-43c9-9081-020b89cf1f37" />
:-------------------------:|:-------------------------:
Example from game: Reassembly <br/> Unable to connect the two parts on the right together; the structure loses overall stability | Example from Roblox studio: making a hexagon with walls results in stubborn seams which can be mitigated by choosing a better scale
<sub> 
*Although it's useful for design work where exact precision isn't necessary, this may not be the solution if you're looking to replace the irrational numbers within a 30/60/90 or 45/45/90 triangle
with exact whole ones.
</sub>

## The Problem

<img width="381" height="381" alt="rationalizing1" src="https://github.com/user-attachments/assets/af2f8025-3369-4324-a13b-dd82ce8c7e56" />

A simple issue may be encountered when arranging equally sized squares onto triangle faces. They will not align back onto the standard grid ever again.
Image above shows a case where an attempt is made to align the squares back with the grid using another 45 degree right triangle.


## Getting The Solution

<img width="381" height="381" alt="rationalizing2" src="https://github.com/user-attachments/assets/77692b77-aad4-4713-9a49-53dbca9d0c96" />

The previous example can be broken down into a function that solves for the marked distance:

### $y=\frac{3}{2}\cdot x\sqrt{2}-\ 2\cdot x$ 

where x is the width of a square.

Substituting x with `58` (which I hand picked from a list my app generated), we can simplify $58\sqrt{2}$ into 82 because the real result is only two 
hundredths of a unit away:

### $y=\frac{3}{2}\cdot82-\ 2\cdot58$

the equation then quietly resolves to 7

## applying the solution

<img width="381" height="381" alt="rationalizing3" src="https://github.com/user-attachments/assets/8a75cb72-a79d-4bb5-9d19-0675583615ef" />

Finally, we can fill the gap left by the odd geometry with a rectangle that's exactly 65 units in length.

---
## Installation
1. Install [Python 3.14](https://www.python.org/downloads/)
2. Download and extract the repository into a folder
3. Run `run.cmd`, `run advanced.cmd`, or `rationalize_sqrt.py` through a CLI


## Command-Line Arguments (WIP)
| Flag | Description |
|-----|-----|
| `--version` | Show app version |
| `--help` | Shows argument list |
| `--advanced`| Runs app with extra options |
| `--checkupdate` | Check for available updates from GitHub |
| `--no_log` | Only show best output |
| `--save_results` | Save results to file |
| `--save_folder` | Set result save folder |

