From 407d23c85989cbabbd7cf3b4bee2d53aeeb050ea Mon Sep 17 00:00:00 2001 From: alpha2320 <58825698+alpha2320@users.noreply.github.com> Date: Tue, 24 Dec 2019 14:25:42 +0530 Subject: [PATCH] Update README.md --- labellab_mobile/README.md | 89 +++++++++++++++++++++++++++++++++------ 1 file changed, 75 insertions(+), 14 deletions(-) diff --git a/labellab_mobile/README.md b/labellab_mobile/README.md index b7ec14655..e2a9361a2 100644 --- a/labellab_mobile/README.md +++ b/labellab_mobile/README.md @@ -1,18 +1,79 @@ -LabelLab Web App +label lab +what is label lab? +Label lab is an image labeling tool designed for researchers. It is an open-source project, so basically using Machine learning it helps in labeling the real-world objects. -S1: Login through google , github or filling out the information -S2: now u will be approached to a dashboard and see projects and can even build a new one. +User Guide -[Starting a New Project-] -1 ) You can create a new project by clicking start a new project button in the dashboard where you will have to fill out the name of the project and then the app will prepare some files making the project for you. After setting up the project you can add the project members and their respective roles by adding their emails. +How to Setup +Clone the repository. +git clone https://github.com/scorelab/Labellab.git +Set up react server +Run npm install in labellab-client folder. + cd labellab-client/ + npm install -[Adding Images ] -1 ) By selecting Project Images in the left bar you will be able to add images. 2 ) You will be able to choose the images from your system and submit the images on the app. - - - - - - [Creating a New Label ] -You can make multiple new labels by typing the name of the label. Furthermore, selecting the label type for eg a polygon sphere, etc. +How to Use +Use two terminals, one for labellab-server and the other for labellab-client. +Run the Node server in the labellab-server folder: +$ npm start +Run the Nodemon server in the labellab-server folder: +$ npm run dev +NOTE: Before starting the server create a file named .env same as .env.example and add your OAUTH and DATABASE credentials in the file. +start the npm server in labellab-client directory. +npm start +And use localhost:3000 to browse. +NOTE: This version is only supporting for Chrome and Firefox browser. And make sure to instal the extension -> Redux Dev Tools in chrome extension library. + +How to Use (Mobile) +Run the Node server in the labellab-server directory (if not already done): +npm start +In a new terminal navigate to labellab_mobile directory. +Configure the lib/config.dart using the format provided in lib/config_example.dart.

Application needs google-services.json issue from firebase to run google sign in option.To obtain the file, +1. Sign in to https://console.firebase.google.com/. +2. Click Add Project and necessary information about the project. +3. Agree to the terms and click Create Project. +4. After creating the project, click Add Firebase to your android app. +5. Go to project location and open android/app/src/main/AndroidManifest.xml.Copy the package name(org.scorelab.labellab_mobile) and paste in the package name field +6. Get the SHA1 fingerprint by following the instruction and paste it in the SHA1 fingerprint field. +7. click next and download the google-services.json. +8. paste the file in location android/app/ folder. +Build flutter the application +flutter build apk +NOTE: Use 'ios' instead of 'apk' to build for iOS +or run the flutter application +flutter run +NOTE: A device with USB debugging enabled or virtual device is required + +[ HOW TO CREATE A NEW PROJECT ] + +* UPON SIGN IN U WILL BE GUIDED TO A PAGE WHERE THERE WILL BE A OPTION TO CLICK PHOTO OR UPLOAD THROUGH GALLERY . +* ON SWIPING FROM LEFT TO RIGHT YOU CAN SEE HISTORY/ YOUR PAST CLASSIFICATION. +* ON SWIPING FROM RIGHT TO LEFT YOU CAN SEE YOUR PROJECTS +* TO CREATE A PROJECT TAP ON THE ADD PROJECT ICON ON RIGHT BOTTOM +* ADD PROJECT SCREEN WILL APPEAR ASKING CREDENTIALS i.e PROJECT NAME & DESCRIPTION +* UPON FILLING THE CREDENTIALS CLICK “CREATE “ BUTTON +* PROJECTED WILL BE CREATED AND YOU WILL BE DIRECTED TO “ PROJECTS “ MENU. + +[ HOW TO ADD IMAGES TO PROJECT ] + +* OPEN YOUR PROJECT FROM PROJECT MENU SCREEN. +* YOU WILL BE SHOWN DETAILS ABOUT YOUR PROJECT. +* CLICK ON IMAGES +* YOU WILL ASKED TO UPLOAD IMAGE VIA CAMERA OR GALLERY . CHOOSE YOUR PREFERRED OPTION. +* IMAGE WILL BE UPLOADED + +[ HOW TO LABEL IMAGES ] + +* OPEN YOUR PROJECT FROM PROJECT MENU SCREEN +* YOU WILL BE SHOWN DETAILS ABOUT YOUR PROJECT +* CLICK ON “ +ADD” BUTTON ON THE RIGHT SIDE OF THE LABELS +* ADD LABEL NAME THEN SELECT “CREATE” +* THEN FROM IMAGES SELECT OR UPLOAD AN IMAGE +* THEN OPEN THE IMAGE AND SELECT “+” THEN SELECT THE DESIRED LABEL . + + +[ HOW TO ORGANISE LABEL ] + +* ALWAYS TRY TO LABEL ( RECTANGLE) LABEL FOR BIGGER CATEGORY i.e animals , books , furniture etc. +* LABEL ( POLYGON) LABELS FOR SMALLER CATEGORY i.e elephant , R.D SHARMA MATHEMATICS , chair etc .