Metadata-Version: 2.1
Name: nqueens
Version: 1.0.4
Summary: A package to get nqueens.
Home-page: https://github.com/toshihiroryuu/nqueens---PyPI-Package
Author: Athul Mathew Konoor
Author-email: athulmathewkonoor@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: gtts (>=2.2.0)

# N-Queen Problem

The "N-Queens Problem" is a classical problem of chess. Here N Queens are to be placed on an N * N chessboard in such a way that no queens attack each other. A Queen can  attack other Queens if its placed on the  same row, column or on its diagonals. We use Backtracking in the backend to solve this problem .
# Usage

To Install this package. Use :
```
  pip install nqueens
  ```

# Class Definition

```
class Queen:
     def __init__(self, n = 0, algo = "backtrack", pos = []):
          self.n = int(n)
          self.algo = algo
          self.pos = []
          self.count = 0
          self.queen_data = []
```

<b>Use the below snippit to start using the package.</b>
```
 from nqueens import * 
```

<b>NQueens Possible Solution Space </b>
   ```
   qq = Queen(5)
   qq.pprint()
   ```

<b>Use scan_queen() class function to solve NQueens problem with image input.</b>

   ![image](https://github.com/toshihiroryuu/nqueens---PyPI-Package/blob/main/tests/q4b.PNG)
   ```
   qq = Queen(4, algo = "backtrack")
   qq.scan_queen("q5.PNG")
   ```

<b>NQueens Solution space as Voice output </b>
  ```
    qq = Queen(4)
    qq.alexa()
   ```

<b>NQueens Solution space as image output </b>

  ```
    qq = Queen(4, algo = "backtrack")
    qq.display()
   ```

<b>NQueens Solution space as PNG File output </b>

  ```
    qq = Queen(4)
    qq.save()
   ```


<dl>Special Credits: https://python-packaging-tutorial.readthedocs.io/en/latest/setup_py.html </dl>
<dl>References: https://www.geeksforgeeks.org/printing-solutions-n-queen-problem/ </dl>

<dl>Visit our GitHub Repository for more information: https://github.com/toshihiroryuu/nqueens---PyPI-Package</dl>


