Giter VIP home page Giter VIP logo

imageprocessors18's Introduction

ImageProcessorS18 · GitHub license · Build Status · Documentation Status

ONLINE Read-The-Docs README: Read-The-Docs

ONLINE RFC Document: RFC

ONLINE Demo: Video Demonstration

APP Link: Deployed App

Description

The Crunchwrap Pizza Image Processor can be used to take in one or more .jpg images or a .zip archive of .jpg images in order for the user to run histogram equalization, log compression, constrast stretching, or reverse video operations on the image(s) they upload. This repository includes starter code for a ReactJSX app frontend that allows image upload, download, and display; starter code for a Mongo Database to store user information; and server code that processes the selected images and returns them to the frontend.

User InputOutput

Initial Setup

First you will need to clone this repository to your local machine. Install all of the required python dependencies using:

pip install -r requirements.txt

and make sure to activate your virtual environment before continuing. source venv/bin/activate

NOTE: if Tkinter throws a Not Found error, you will need to use this command: apt-get install python-tk. This may happen if the server is being run on a VCM being accessed through a command line window.

Database

To get started running the database (if you want to run your own database), use the below command in the same directory as the ProcessServer.py file (~/ImageProcessorS18/server)

sudo docker run -v $PWD/db:/data/db -p 27017:27017 mongo

and on line 33 in the ProcessServer.py file edit

connect("mongodb://vcm-3594.vm.duke.edu:27017/image_process_app")

with the name you want assigned to your database:

connect("mongodb://vcm-3594.vm.duke.edu:27017/<your_database_name_here>")

Server

In order to run the server, make sure that you are within the server folder before starting

cd ~/ImageProcessorS18/server

You can run the server on your local computer using gunicorn:

gunicorn --bind 0.0.0.0:5000 ProcessServer:app

App

Use this link to simply utilize the already deployed version of the app. However, if you wish to make edits and run the app locally, follow the next steps:

To run the app locally first make sure you are within the frontend folder

cd frontend

Make sure you have Node.JS installed on your machine. Use this link to install it if you haven't already. Then, run

npm install

this will install all necessary dependencies. Run

npm start

to launch the app and use it within your browser.

NOTE: Make sure that the server and database are running, as well, and that you have edited lines 156 and 196 in the App.js file to reflect where you're running your server.

License

ImageProcessorS18 is MIT licensed.

imageprocessors18's People

Contributors

pcg15 avatar kjans123 avatar ml273 avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.