Giter Club home page Giter Club logo

osu_capstone_mafe's Introduction

Mobile Application for Forest Ecology Research


Table of Contents

You're sections headers will be used to reference location of destination.


Description

Data collection app for the Pacific Northwest Permanent Sample Plot Program.

http://pnwpsp.forestry.oregonstate.edu/

Technologies

  • ODK-X
  • JavaScript
  • HTML
  • CSS

Back To The Top


Installation

Dependencies

  1. Java Run Time Environment https://java.com/en/download/
  2. Node.js https://nodejs.org/en/
  3. Grunt npm install -g grunt-cli
  4. Android Studio https://developer.android.com/studio
  5. Android Debug Bridge (ADB) https://developer.android.com/studio/releases/platform-tools
  6. ODK-X app designer https://github.com/odk-x/app-designer/releases/tag/2.1.6

Install on Device

You will need to install the following apps on your Android Device.

  1. OI File Manager
  2. ODK-X tables
  3. ODK-X services

https://docs.odk-x.org/basics-install/

If you do not have a physical device you can use the Android Studio Emulator.

  • Open Android Studio and press configure on the bottom right of the screen.

  • From the dropdown menu select AVD manager
  • A window like this should open
  • If a device does not already exist, select Create Virtual Device... otherwise select a device from the given options and start it.
  • The rest of the instructions from here on will be the same as if installing on a physical device.
  • Install Application

    1. Download project git clone https://github.com/poliakosOSU/OSU_Capstone_MAFE.git

    2. Transfer files from app project repo to app-designer

      Copy the config file from

      OSU_Capstone_MAFE/odk_app/

      and replace the config file in

      app-designer-2.1.6/app/

    3. Enable Developer options on your Android Device

    4. Connect Android Device to computer

    5. Open your terminal and navigate to the root of the app-designer directory and run the following command

      grunt adbpush

    Using Appllication

    1. On your Android Device, open the previously installed ODK-X tables app
    2. In the top right corner select the Preferences tab
    3. Press the Reset Configuration Button
    4. Go back to the home menu of the application, you can now use the app.

    Syncing to a server

    1. Connect the Android device to OSU's VPN following their setup instructions.
    2. In ODK Services go to settings and enable user restrictions with "password" as the admin password in the next screen. (Temporary password for testing.)
    3. Go to the new "Manage ability to change server settings" screen and enable "unsafe/unsecure Authentication".
    4. In "server settings" set the server url to http://field.forestry.oregonstate.edu/
    5. Get to the sync screen and click change user. (Easiest way to get there is by clicking the icon of two arrows in a circle from the top bar in the landing page in Tables.)
    6. Use "guest" and "password" as the username and password then click authenticate.
    7. After having created some records through Tables you should now be able to click the big "sync now" button and have those records synced to the remote server.

    Back To The Top

    License

    MIT License

    Copyright (c) [2020] [Sergei Poliakov and Joseph Landreville]

    Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

    The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    Back To The Top


    Authors

    • Sergei Poliakov
    • Joseph Landreville

    Back To The Top

    osu_capstone_mafe's People

    Contributors

    poliakososu avatar landrevj avatar

    Watchers

     avatar

    Forkers

    robpabst sergei-p

    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.