Skip to content

Commit 5613440

Browse files
committed
Add README.md
1 parent 391b44c commit 5613440

1 file changed

Lines changed: 150 additions & 0 deletions

File tree

README.md

Lines changed: 150 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,150 @@
1+
# Image Processing
2+
3+
![python]
4+
![pyqt]
5+
![opencv]
6+
![numpy]
7+
![windows]
8+
[![license]][license-url]
9+
10+
This is a python raster graphics editor.<br>
11+
General-purpose of the project is to manipulate and edit images.<br>
12+
Additionally, you can [download](#download) a desktop application for Windows.
13+
14+
![demo-hist]
15+
![demo-profile]
16+
![demo-norm]
17+
18+
---
19+
20+
## Table of content
21+
22+
- [Features](#features)
23+
- [Installation](#installation)
24+
- [Build Process](#build-process)
25+
- [Download](#download)
26+
- [Documentation](#documentation)
27+
- [License](#license)
28+
29+
---
30+
31+
## Features
32+
33+
* Open/Save images in common extensions
34+
* Type changing
35+
* Rename/Duplicate
36+
* Zoom in/out
37+
* Histogram
38+
- Graphical
39+
- Table representation
40+
* Profile Line
41+
* Object Features
42+
* Histogram Operations
43+
- Normalization
44+
- Equalization
45+
* Point Operations
46+
- Negation
47+
- Posterize
48+
- Image Calculator
49+
* Local Operations
50+
- Smooth
51+
- Sharpen
52+
- Convolve
53+
- Gray Morphology
54+
- Edge Detection
55+
* Segmentation
56+
- Threshold
57+
- Watershed
58+
* SVM Classification among rice, beans, lentils
59+
* Images stitching (panorama)
60+
* Windows platform-oriented
61+
* Shortcuts
62+
63+
---
64+
65+
## Installation
66+
67+
Clone the project from GitHub, then you'll need [Git](https://git-scm.com/)
68+
installed on your computer:
69+
70+
```
71+
# Clone this repository
72+
$ git clone https://github.com/vmariiechko/python-image-processing
73+
```
74+
75+
---
76+
77+
## Build Process
78+
79+
To run this application, you'll need [Python 3.6+](https://www.python.org/) installed on your computer.<br>
80+
In your [working environment][venv-url] from the command line:
81+
82+
```
83+
# Go into the repository
84+
$ cd python-image-processing
85+
86+
# Install dependencies
87+
$ pip3 install -r requirements.txt
88+
```
89+
90+
Once you've installed all the dependencies, use the custom 'pythonpath.bat'
91+
file to run the application from the terminal:
92+
93+
```
94+
# Navigate to src folder
95+
$ cd src
96+
97+
# Run app
98+
$ pythonpath.bat .. main.py
99+
```
100+
101+
That's it! After all the actions, the app's main window must show up.
102+
103+
---
104+
105+
## Download
106+
107+
Get the executable desktop version for Windows from [here][download-url].
108+
109+
There are available images in the 'Test Images' folder inside the root app folder.
110+
111+
---
112+
113+
## Documentation
114+
115+
For technical documentation, see [readthedocs.io][readthedocs-url]
116+
117+
For user documentation in Polish, see [pdf file][pdf-docs-url].
118+
119+
---
120+
121+
## License
122+
123+
>You can check out the full license [here][license-url].
124+
125+
This project is licensed under the terms of the **MIT** license.
126+
127+
---
128+
129+
> Gmail [vmariiechko@gmail.com](mailto:vmariiechko@gmail.com) &nbsp;&middot;&nbsp;
130+
> GitHub [@vmariiechko](https://github.com/vmariiechko) &nbsp;&middot;&nbsp;
131+
> LinkedIn [@mariiechko](https://www.linkedin.com/in/mariiechko/)
132+
133+
<!-- Markdown links and images -->
134+
[python]: https://img.shields.io/badge/Python-14354C?style=for-the-badge&logo=python&logoColor=white
135+
[pyqt]: https://img.shields.io/badge/pyqt5-%2341CD52.svg?&style=for-the-badge&logo=qt&logoColor=white
136+
[opencv]: https://img.shields.io/badge/OpenCV-27338e?style=for-the-badge&logo=OpenCV&logoColor=white
137+
[numpy]: https://img.shields.io/badge/Numpy-777BB4?style=for-the-badge&logo=numpy&logoColor=white
138+
[windows]: https://img.shields.io/badge/windows-0078D6?logo=windows&logoColor=white&style=for-the-badge
139+
[license]: https://img.shields.io/badge/license-MIT-%2341CD52.svg?&style=for-the-badge
140+
141+
[license-url]: https://github.com/vmariiechko/python-image-processing/blob/main/LICENSE.txt
142+
[venv-url]: https://docs.python.org/3/tutorial/venv.html
143+
[readthedocs-url]: https://python-image-processing.readthedocs.io/en/latest/
144+
[pdf-docs-url]: https://github.com/vmariiechko/python-image-processing/blob/main/docs/docs-pl.pdf
145+
[download-url]: https://github.com/vmariiechko/python-image-processing/releases/tag/v1.0.0
146+
147+
[demo-hist]: https://imgur.com/P6r42jD.png
148+
[demo-profile]: https://imgur.com/wWMA5Q9.png
149+
[demo-norm]: https://imgur.com/ak3KJxw.png
150+

0 commit comments

Comments
 (0)