Collect Earth Online (CEO)

Usage

To run this web application, you will need:

1. Sun’s JDK 1.8+
2. Boot 2.5.5+
3. Postgresql 9.5+
4. PostGIS 2.2+

Begin by following the Database Initialization instructions at the end of this file to create a new database for your CEO installation.

Then simply enter the toplevel project directory (the same one containing this README file), and instruct Boot to run the web application as follows:

In development mode: $ boot dev

In production mode: $ boot site

Both commands will start a web server running the CEO website. Connect to it by pointing your web browser at http://localhost:8080.

In development mode, connect to the local nrepl server with your IDE or using boot from the command-line:

$ boot repl –client

Then run (start-repl) from the Clojure prompt and refresh your browser to activate a browser-backed ClojureScript repl.

Contact

Authors: Gary W. Johnson and David S. Saah

Emails: [email protected], [email protected]

License

Copyright © 2016 Spatial Informatics Group, LLC.

CEO is distributed by Spatial Informatics Group, LLC. under a restricted use license. Please contact the authors at the above-listed emails for a copy of this license.

Database Initialization

1. Install the latest versions of Postgresql and PostGIS.
2. Start the Postgresql database server running on your machine on the default port (5432).
3. From your shell, run “psql -U postgres” to connect as the database superuser.
4. At the psql prompt, run these commands:

   CREATE ROLE ceo WITH LOGIN CREATEDB;
   CREATE DATABASE ceo WITH OWNER ceo;
   \c ceo
   CREATE EXTENSION postgis;
       

   This will create a new database called “ceo” owned by user “ceo” and add the PostGIS spatial extensions to it.

5. From your shell, run “psql -U ceo -f build_ceo_tables.sql -d ceo” to populate the new ceo database with the table schema expected by the website code. This SQL file can be found under resources/sql in the toplevel project directory.
6. Launch the CEO website by running “boot dev” from within the CEO directory that you cloned from GitHub.
7. Point your web browser at http://localhost:8080 to access the site.
8. Register a new user administrator account with whatever email and password you like.
9. From your shell, run “psql -U ceo -d ceo” to connect to the ceo database as the ceo user.
10. At the psql prompt, run this command to elevate your new email address (in this case, we use “[email protected]”) to the admin role.

    UPDATE ceo.users
      SET role='admin'
      WHERE email='[email protected]';
        

11. Logout and back in as your new administrator account on the CEO website. You should now see the Account, Dashboard, and Admin links added to the navigation bar.
12. Visit the Admin link and create a new project. All fields must be filled in. To input the bounding box coordinates, use ctrl+drag on the map interface. You can repeat this as many times as you would like, and it will always save the last bounding box drawn this way. Remember to enter several sample value categories (try 6-8 to start with) along with sensible colors.

    Here are some examples for a few test projects:

    Name

    Mekong River Region

    Description

    Laos, Cambodia, Vietnam, Thailand, Myanmar

    Number of plots

    10000

    Plot radius in meters

    100

    Samples per plot

    15

    Latitude Max

    22.5

    Longitude Min

    95

    Longitude Max

    107

    Latitude Min

    10.5

    Sample Values

    • Forest
    • Grassland
    • Bare Surface
    • Impervious Surface
    • Agriculture
    • Urban
    • Water
    • Cloud
    • Unknown

    Name

    California, USA

    Description

    The most populous state in the United States.

    Number of plots

    1000

    Plot radius in meters

    50

    Samples per plot

    5

    Latitude Max

    42.0

    Longitude Min

    -124.6

    Longitude Max

    -114.0

    Latitude Min

    32.3

    Sample Values

    • Rock/Sand
    • Grasses
    • Crops
    • Shrubs
    • Trees
    • Roads/Parking Lots
    • Buildings
    • Water
    • Unknown

    Name

    Mongolia

    Description

    The land of yurt-dwelling pastoral nomads.

    Number of plots

    5000

    Plot radius in meters

    200

    Samples per plot

    20

    Latitude Max

    52.5

    Longitude Min

    87.0

    Longitude Max

    120.5

    Latitude Min

    41.5

    Sample Values

    • Settlement
    • Road
    • Rock/Sand
    • Grasses
    • Trees
    • Water
    • Snow
    • Unknown

13. Visit the Dashboard page, select a project, press the Analyze New Plot button, and have fun!