MPENN is a simple software solution designed to transform the way we process and edit large volumes of images.
Go to file
Falko Victor Habel 832c0997fa removed accidentally added file 2024-05-21 21:27:12 +02:00
MPENNconfigs added better Linux Support. With Font Manager 2024-05-10 22:07:54 +02:00
data added better Linux Support. With Font Manager 2024-05-10 22:07:54 +02:00
icons added better Linux Support. With Font Manager 2024-05-10 22:07:54 +02:00
scripts added better Linux Support. With Font Manager 2024-05-10 22:07:54 +02:00
.gitignore Initial commit 2024-03-05 14:54:08 +00:00
LICENSE Unicode error fixed. 2024-03-10 16:47:30 +01:00
README.md added better Linux Support. With Font Manager 2024-05-10 22:07:54 +02:00
main.py removed accidentally added file 2024-05-21 21:27:12 +02:00
requirements.txt added requirements file 2024-05-05 21:16:53 +02:00

README.md

MPENN - Massive Picture Editing for Neural Networks

MPENN is a simple software solution designed to transform the way we process and edit large volumes of images, particularly in applications involving neural networks. This versatile tool combines video-to-picture conversion capabilities with an advanced image editor, enabling users to manage and manipulate images efficiently at scale. Whether you are working on machine learning datasets, enhancing digital media assets, or require a robust tool for bulk image editing, MPENN is the ideal solution for your needs.

--Support--

Currently only working on Windows! Linux Support is WIP!

Features

MPENN provides a comprehensive set of features designed to streamline the process of converting, editing, and managing large sets of images. Here's what you can expect:

  • Video Conversion: Effortlessly convert videos into sequences of high-quality images, ready for further processing or analysis.

  • Fast Image Resizing: Quickly adjust the sizes of your images to meet specific requirements without compromising on quality.

  • Customizable Bounding Boxes: Annotate your images with bounding boxes and customize their appearance with various colors and thicknesses to suit your needs.

  • Data Tracking and Management: For each output folder, MPENN generates a detailed .json file that contains important information about each image, including bounding box details. This helps you manage and analyze your data more efficiently.

With these features, MPENN significantly simplifies the workflow for users who need to process and analyze images at scale, especially those working with neural networks and AI applications.

Getting Started with MPENN

Welcome to MPENN, a comprehensive tool designed to streamline massive picture editing tasks for neural networks. Follow these steps to get started with MPENN and begin transforming your videos and images into machine learning-ready datasets.

1. Downloading and Using MPENN

To begin using MPENN, download the software from its Gitea repository. You can choose between two options for download:

  1. Source code: Download the source code and build the application yourself. This option is recommended if you have experience with programming and want to modify or extend MPENN's functionality.

  2. Precompiled binary (.exe): Download the precompiled binary for your operating system. This will allow you to quickly start using MPENN without needing to build it from source. Please note that, upon executing the .exe, a folder will be created in the directory of the .exe containing some configuration files.

No environment setup is necessary when using the binary. You can run the .exe directly after downloading and it will function as intended.

2. Dependencies (Applicable for source code only)

If you have chosen to download the source code, we recommend setting up a virtual environment (venv) for running the software. This ensures that your Python environment remains clean and organized. Open your terminal or command prompt and navigate to the MPENN directory. Then, run the following commands:

# Create a virtual environment named 'mpenn-env'
python -m venv mpenn-env

# Activate the virtual environment
# On Windows
mpenn-env\Scripts\activate
# On Unix or MacOS
source mpenn-env/bin/activate

# Install MPENN dependencies
pip install -r requirements.txt

# run main.py to run mpenn
python main.py

With these steps, your environment will be prepared for running MPENN using the source code.

1. Converting Video to Picture Sequence

If you're starting with a video, MPENN makes it easy to convert it into a sequence of images. Use the video-to-picture feature to specify your video file and the output directory for the images.

2. Processing Image Sequences

Whether you've generated your images from a video or already have a sequence of images, you can start editing them with MPENN. You can: - Resize Images: Quickly adjust the resolution of your images to fit your requirements. - Create Bounding Boxes: Annotate your images with bounding boxes for object detection tasks.

Documentation

In-depth documentation on using MPENN will be available soon.

License

MPENN is made available under the Attribution-NonCommercial-ShareAlike 4.0 license. For more details, please refer to the LICENCE file included in the distribution.

Connect with Me

Stay updated on the latest news and updates about MPENN by following us on our social media channels: