{"_id":"5667486332dd550d00f39263","project":"55faeacad0e22017005b8265","category":{"_id":"566710a36819320d000c2e93","__v":8,"pages":["566726616819320d000c2edd","5667486332dd550d00f39263","5667494aee53940d005162a8","566749c832dd550d00f39266","56674a155d00370d00ede700","5681826b9de23c0d00c5476f","56a2830ed15dd70d008d8288","56a93422bd92180d00e1fc4f"],"project":"55faeacad0e22017005b8265","version":"55faeacad0e22017005b8268","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-12-08T17:17:23.555Z","from_sync":false,"order":12,"slug":"web-application","title":"Web Application"},"version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":35,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"user":"55fae9d4825d5f19001fa379","__v":39,"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2015-12-08T21:15:15.465Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"# Supported browsers\nGoogle Chrome, Firefox, and Safari are the supported browsers for the GBDX web application. Internet Explorer is not supported.\n\n# Sign up for GBDX\nIf you're new to GBDX, you'll need to create an account. If you receive an email invitation to GBDX from your company, follow the instructions to activate your user account. Otherwise, start here. \n\nStep 1: Go to the [GBDX home page](https://gbdx.geobigdata.io/login). \n\nStep 2: Select \"Sign up\" from the login box. Enter the email name and password you want to use for this account, then click \"SIGN UP.\n\n![Sign up](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-signup3.png)\n\nStep 3: Fill in your personal information and account information. Choose \"Register GBDX Account.\" \n\nStep 4: Activate your account. \nAfter you register, you'll get an email message from DigitalGlobe asking you to activate your account. Open the message and click on \"Confirm my account.\" An account confirmation will appear. Now you're ready to start using the web application. \n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Remember the email name and password you create for this account.\",\n  \"body\": \"You'll need it to log into the web application later and to use GBDX APIs\"\n}\n[/block]\n\n## Sign in using your account credentials\nTo sign into the web application again, enter the email address and the password you created to log in to your account.\n\n\n# Web Application Components\n\nThese are the four main components of the GBDX web application. This navigation bar appears on each page. When you choose an icon, it will be highlighted and the corresponding page will open. \n\n![Left Navigation](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-LeftNav.png)\n\n# ![Dashboard](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-dashboard2.png) Dashboard\n\nThe Dashboard is a list view of the projects you've created in the web application.\n\n\n# ![Projects](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-projects-icon2.png) Projects\nA project is a container for saving one or more Areas of Interest.  \n\nThe projects page displays all the projects the user has created. Click on a project to see Areas of Interest that are stored within it, or to add an Area of Interest.\n\n## Create a New Project\n\nThe only required field for a project is \"Project Name\". Be sure to click \"optional settings\" before saving to add additional information to the project's description. \n\nField | Required? | Description\n--- | --- | ---\nProject Name | Required | Enter a name to identify your project.\nProject Tags | Optional | Add tags to categorize your project. Separate tags by a space.\nProject Cover Photo | Optional | Use an existing photo or add your own.\nProject Description | Optional | Add a project description to help you identify the project later. \n\nChoose \"save\" to create the project. \n\n## Add to an Existing Project\nTo save an area of interest to an existing project, click the down arrow next to the name box. Choose an existing project name from the dropdown list.\n![existing project](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-SavetoProject.png)\n\n# ![Task Library](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-task-library-icon.png) Task Library\n\nThe task library shows a subset of algorithms available on GBDX. Click a task to see more information about it.\n\nThe task library is displayed for informational purposes only. Tasks cannot be executed from within the web application. \n\n# ![Areas of Interest](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-areasofinterest-icon.png) Areas of Interest \n\nWhether you want to use our tools to create an Area of Interest or you'd prefer to upload your own file, you'll do this from the Areas of Interest page. \n\n## Upload a File\nIf you already have a file that defines your area of interest, you can upload it to the web application.\nAccepted file types are GML, KML, WKT, SHP, or GEOJSON. \n\nTo upload a shapefile, place all associated files in one .zip directory, then upload the .zip file. The .zip directory must include a .shp file, .shx file, and .dbf file.\n\nThere are two ways to upload a file:\n\n![upload files](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-drag_drop.png)\n\n1. Select a file, then drag and drop it over the the \"upload\" symbol. \n\n2. Click the \"or browse to upload\" link, then select \"choose file.\" Select the file to upload.\n\n## Draw an Area of Interest\n\nUse the following tools to narrow your search area and draw the boundaries for your area of interest. \n\nSymbol | Name | Description \n--- | --- | --- \n![search](https://s3.amazonaws.com/gbdx-doc-images/webapp2course_searchbox.png) | Search | Narrow your search by typing in the name of a specific area. For example: Denver, Colorado.\n![zoom in](https://s3.amazonaws.com/gbdx-doc-images/zoom_in_75-percent.png) | Zoom in |  Use \"zoom in\" to make an area appear larger with more detail.\n![zoom out](https://s3.amazonaws.com/gbdx-doc-images/zoom_out_125-percent.png) | Zoom out | Use \"zoom out\" for a more distant view of an area.\n![polygon](https://s3.amazonaws.com/gbdx-doc-images/draw_a_polygon_80-percent.png) | Draw a polygon | Click to draw the polygon's borders. Click the first point to close the shape.\n![select area](https://s3.amazonaws.com/gbdx-doc-images/select_an_area_80-percent.png)| Select an area | Click and drag the mouse to select an area. Release the mouse to finish drawing.\n![edit layers](https://s3.amazonaws.com/gbdx-doc-images/edit_layers.png) | Edit layers | Click \"edit layers\", then drag the handles or marker to edit a drawn area's borders.Select \"save\" to save changes.\n![delete layers](https://s3.amazonaws.com/gbdx-doc-images/delete_layers.png)| Delete layers |  Click \"delete layers\", then click the drawn area you want to remove. Select \"save\" to save changes.\n\n## Mouse Controls \nYou can use your mouse to zoom in and out, and to move the map around on your screen. Double-click to zoom in, or use the mouse wheel to zoom in and out. To move the map around, click and hold, then drag the mouse around the screen.\n\n## Additional Controls\nChoose the \"filter\" icon to filter your results. Select the \"page\" icons to minimize or maximize the \"Areas of Interest\" box. Minimizing the box  provides a full view of the map screen. To select filters, the box must be maximized.\n\n![filter results](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-filter_results.png).\n\n## Filter your Results\n\n Use filtering to further refine your results set. You can filter by:\n\nFilter Name | Description | Values\n--- | --- | ---\nSatellite | The satellite that acquired the image. For example, Worldview 3, GeoEye 1. Use the dropdown to see the available options | Select 1 or more satellites, then click \"apply\".\nDate | The date the satellite acquired the image | Select a \"from\" and \"to\" date range.\nImage Band | The image bands for the image. For example: Pan, MS1 | Use the dropdown to see available options. \nOff Nadir Angle | The spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired. |0 to 90\nSun Azimuth | Azimuth angle of the sun measured from north clockwise, in degrees, at the time the strip or substrip was acquired.| 0 to 90\nSun Elevation | The angle of the sun above the horizon.| 0 to 90\nMulti Resolution | |0 to 90\nCloud Coverage | Estimate of the max cloud-covered fraction of the delivery. | 0 to 90\n\n## New Area List Page\nWhen you create an area of interest, it's displayed in a list with other areas you've created. Uploaded files appear in this list as new areas. New areas can't be renamed at this time, but they are given a number. For example, New Area 1 and New Area 2.\n![New Area](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-newArea.png)\n\nIn the list view, you can:\n* Clear the existing list of areas\n* Upload a new file\n* Click the area name or the image icon to view the images in the area\n* See the number of images in the area\n* Click the circle icon to view the area on the map\n* Click the trash can icon to delete the area.\n\nClicking on either the new area name or the \"image\" icon next to the number of images shows the thumbnail images for all acquisitions in the area.  The thumbnail image shows the order status (see below), the catalog ID, and the acquisition date for the image.\n\n## New Area Image Thumbnail View and List View\nYou can view the thumbnails  in a two column image display or in a list view. The 9-square icon highlighted in blue is the image display. This is the default display mode. You can click the list icon to change to a list view. \n\n![New area list view](https://s3.amazonaws.com/gbdx-doc-images/webapp2Course-newarea2.png)\n\nOn the image thumbnails, the icon in the upper left corner of the image represents the order status of the image. \n\nIcon | Order status\n--- | ---\n![not ordered](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-NotOrdered.png) | images need to be ordered\n![ordered](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-ordered.png) | Image has been delivered and is available         \n\n## Image Metadata\nTo see an image's metadata, click the arrow in the top right corner of the thumbnail image, or switch to the list view. The following will be displayed:\n\nName | Description\n--- | ---\nImage ID | The image ID for the acquisition (also referred to as the catalog ID).\nVendor | The provider of the image. For example, DigitalGlobe is the vendor for all acquisitions from DigitalGlobe satellites.\nSatellite | The name of the satellite that acquired the image.\nImage Band | The image bands for the image. For example: Pan, MS1 \nCloud Coverage | the percentage of cloud cover in the image\nOff Nadir Angle | See filter descriptions above\nSun Azimuth | see filter descriptions above\nSun Elevation | see filter descriptions above\nPan Resolution | see filter descriptions above\nMulti Resolution | see filter descriptions above\n\n## Remove images from your Area of Interest\nUse the trash can icon to remove the image from the New Area list. Remove any images you don't want to order or process using a task.\n\n##Save Area of Interest to a Project\nNow you're ready to save your Area of Interest to a Project. Click the \"Save Areas to Project\" button. Type in a new name for your project, or choose an existing task from the dropdown menu. Fill in the optional settings (described below) and save.\n\n----------\n\n# ![User Profile](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-profile.png) User Profile\n\nThe \"profile\" image in the bottom left corner lets you log out of the web application or view your profile. If you are an account administrator, \"user management is available here too.\n\n## User Profile\nThe user profile includes the following user data:\n\nItem | Description\n--- | ---\nName | The username you registered for GBDX with. For most people, this is your email address\nE-mail | The email address you registered with. \nClient ID | The Client ID assigned to your account. This is occasionally used in operations performed outside of the web application.\nClient Secret | The Client Secret key assigned to your account. This is occasionally used in operations performed outside of the web application.\nAPI Key | The API key is a required to generate a token for accessing GBDX APIs. \n\n## User Management\nIf you are an account administrator, go to \"User Management\" to invite users to your account. \n\nFrom the \"profile\" icon, click on \"user management.\"\nLog in to the management portal with your GBDX username and password. For most people, username is your email address. \nTo invite a user to your account, click \"invite user\" in the upper right corner.\nTo change the user's access, click the three vertical dots on the right-hand side of the user's listing. You can make the user an administrator, deactivate the user, or permanently delete the user.","excerpt":"The GBDX web application is a tool for evaluating what GBDX has to offer. The web application lets you sign up for an evaluation account, search or browse our extensive imagery catalog, and browse the task library.","slug":"web-application-course","type":"basic","title":"Web Application Course"}

Web Application Course

The GBDX web application is a tool for evaluating what GBDX has to offer. The web application lets you sign up for an evaluation account, search or browse our extensive imagery catalog, and browse the task library.

# Supported browsers Google Chrome, Firefox, and Safari are the supported browsers for the GBDX web application. Internet Explorer is not supported. # Sign up for GBDX If you're new to GBDX, you'll need to create an account. If you receive an email invitation to GBDX from your company, follow the instructions to activate your user account. Otherwise, start here. Step 1: Go to the [GBDX home page](https://gbdx.geobigdata.io/login). Step 2: Select "Sign up" from the login box. Enter the email name and password you want to use for this account, then click "SIGN UP. ![Sign up](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-signup3.png) Step 3: Fill in your personal information and account information. Choose "Register GBDX Account." Step 4: Activate your account. After you register, you'll get an email message from DigitalGlobe asking you to activate your account. Open the message and click on "Confirm my account." An account confirmation will appear. Now you're ready to start using the web application. [block:callout] { "type": "warning", "title": "Remember the email name and password you create for this account.", "body": "You'll need it to log into the web application later and to use GBDX APIs" } [/block] ## Sign in using your account credentials To sign into the web application again, enter the email address and the password you created to log in to your account. # Web Application Components These are the four main components of the GBDX web application. This navigation bar appears on each page. When you choose an icon, it will be highlighted and the corresponding page will open. ![Left Navigation](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-LeftNav.png) # ![Dashboard](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-dashboard2.png) Dashboard The Dashboard is a list view of the projects you've created in the web application. # ![Projects](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-projects-icon2.png) Projects A project is a container for saving one or more Areas of Interest. The projects page displays all the projects the user has created. Click on a project to see Areas of Interest that are stored within it, or to add an Area of Interest. ## Create a New Project The only required field for a project is "Project Name". Be sure to click "optional settings" before saving to add additional information to the project's description. Field | Required? | Description --- | --- | --- Project Name | Required | Enter a name to identify your project. Project Tags | Optional | Add tags to categorize your project. Separate tags by a space. Project Cover Photo | Optional | Use an existing photo or add your own. Project Description | Optional | Add a project description to help you identify the project later. Choose "save" to create the project. ## Add to an Existing Project To save an area of interest to an existing project, click the down arrow next to the name box. Choose an existing project name from the dropdown list. ![existing project](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-SavetoProject.png) # ![Task Library](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-task-library-icon.png) Task Library The task library shows a subset of algorithms available on GBDX. Click a task to see more information about it. The task library is displayed for informational purposes only. Tasks cannot be executed from within the web application. # ![Areas of Interest](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-areasofinterest-icon.png) Areas of Interest Whether you want to use our tools to create an Area of Interest or you'd prefer to upload your own file, you'll do this from the Areas of Interest page. ## Upload a File If you already have a file that defines your area of interest, you can upload it to the web application. Accepted file types are GML, KML, WKT, SHP, or GEOJSON. To upload a shapefile, place all associated files in one .zip directory, then upload the .zip file. The .zip directory must include a .shp file, .shx file, and .dbf file. There are two ways to upload a file: ![upload files](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-drag_drop.png) 1. Select a file, then drag and drop it over the the "upload" symbol. 2. Click the "or browse to upload" link, then select "choose file." Select the file to upload. ## Draw an Area of Interest Use the following tools to narrow your search area and draw the boundaries for your area of interest. Symbol | Name | Description --- | --- | --- ![search](https://s3.amazonaws.com/gbdx-doc-images/webapp2course_searchbox.png) | Search | Narrow your search by typing in the name of a specific area. For example: Denver, Colorado. ![zoom in](https://s3.amazonaws.com/gbdx-doc-images/zoom_in_75-percent.png) | Zoom in | Use "zoom in" to make an area appear larger with more detail. ![zoom out](https://s3.amazonaws.com/gbdx-doc-images/zoom_out_125-percent.png) | Zoom out | Use "zoom out" for a more distant view of an area. ![polygon](https://s3.amazonaws.com/gbdx-doc-images/draw_a_polygon_80-percent.png) | Draw a polygon | Click to draw the polygon's borders. Click the first point to close the shape. ![select area](https://s3.amazonaws.com/gbdx-doc-images/select_an_area_80-percent.png)| Select an area | Click and drag the mouse to select an area. Release the mouse to finish drawing. ![edit layers](https://s3.amazonaws.com/gbdx-doc-images/edit_layers.png) | Edit layers | Click "edit layers", then drag the handles or marker to edit a drawn area's borders.Select "save" to save changes. ![delete layers](https://s3.amazonaws.com/gbdx-doc-images/delete_layers.png)| Delete layers | Click "delete layers", then click the drawn area you want to remove. Select "save" to save changes. ## Mouse Controls You can use your mouse to zoom in and out, and to move the map around on your screen. Double-click to zoom in, or use the mouse wheel to zoom in and out. To move the map around, click and hold, then drag the mouse around the screen. ## Additional Controls Choose the "filter" icon to filter your results. Select the "page" icons to minimize or maximize the "Areas of Interest" box. Minimizing the box provides a full view of the map screen. To select filters, the box must be maximized. ![filter results](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-filter_results.png). ## Filter your Results Use filtering to further refine your results set. You can filter by: Filter Name | Description | Values --- | --- | --- Satellite | The satellite that acquired the image. For example, Worldview 3, GeoEye 1. Use the dropdown to see the available options | Select 1 or more satellites, then click "apply". Date | The date the satellite acquired the image | Select a "from" and "to" date range. Image Band | The image bands for the image. For example: Pan, MS1 | Use the dropdown to see available options. Off Nadir Angle | The spacecraft elevation angle measured from nadir to the image center as seen from the spacecraft at the time the strip or substrip was acquired. |0 to 90 Sun Azimuth | Azimuth angle of the sun measured from north clockwise, in degrees, at the time the strip or substrip was acquired.| 0 to 90 Sun Elevation | The angle of the sun above the horizon.| 0 to 90 Multi Resolution | |0 to 90 Cloud Coverage | Estimate of the max cloud-covered fraction of the delivery. | 0 to 90 ## New Area List Page When you create an area of interest, it's displayed in a list with other areas you've created. Uploaded files appear in this list as new areas. New areas can't be renamed at this time, but they are given a number. For example, New Area 1 and New Area 2. ![New Area](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-newArea.png) In the list view, you can: * Clear the existing list of areas * Upload a new file * Click the area name or the image icon to view the images in the area * See the number of images in the area * Click the circle icon to view the area on the map * Click the trash can icon to delete the area. Clicking on either the new area name or the "image" icon next to the number of images shows the thumbnail images for all acquisitions in the area. The thumbnail image shows the order status (see below), the catalog ID, and the acquisition date for the image. ## New Area Image Thumbnail View and List View You can view the thumbnails in a two column image display or in a list view. The 9-square icon highlighted in blue is the image display. This is the default display mode. You can click the list icon to change to a list view. ![New area list view](https://s3.amazonaws.com/gbdx-doc-images/webapp2Course-newarea2.png) On the image thumbnails, the icon in the upper left corner of the image represents the order status of the image. Icon | Order status --- | --- ![not ordered](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-NotOrdered.png) | images need to be ordered ![ordered](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-ordered.png) | Image has been delivered and is available ## Image Metadata To see an image's metadata, click the arrow in the top right corner of the thumbnail image, or switch to the list view. The following will be displayed: Name | Description --- | --- Image ID | The image ID for the acquisition (also referred to as the catalog ID). Vendor | The provider of the image. For example, DigitalGlobe is the vendor for all acquisitions from DigitalGlobe satellites. Satellite | The name of the satellite that acquired the image. Image Band | The image bands for the image. For example: Pan, MS1 Cloud Coverage | the percentage of cloud cover in the image Off Nadir Angle | See filter descriptions above Sun Azimuth | see filter descriptions above Sun Elevation | see filter descriptions above Pan Resolution | see filter descriptions above Multi Resolution | see filter descriptions above ## Remove images from your Area of Interest Use the trash can icon to remove the image from the New Area list. Remove any images you don't want to order or process using a task. ##Save Area of Interest to a Project Now you're ready to save your Area of Interest to a Project. Click the "Save Areas to Project" button. Type in a new name for your project, or choose an existing task from the dropdown menu. Fill in the optional settings (described below) and save. ---------- # ![User Profile](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-profile.png) User Profile The "profile" image in the bottom left corner lets you log out of the web application or view your profile. If you are an account administrator, "user management is available here too. ## User Profile The user profile includes the following user data: Item | Description --- | --- Name | The username you registered for GBDX with. For most people, this is your email address E-mail | The email address you registered with. Client ID | The Client ID assigned to your account. This is occasionally used in operations performed outside of the web application. Client Secret | The Client Secret key assigned to your account. This is occasionally used in operations performed outside of the web application. API Key | The API key is a required to generate a token for accessing GBDX APIs. ## User Management If you are an account administrator, go to "User Management" to invite users to your account. From the "profile" icon, click on "user management." Log in to the management portal with your GBDX username and password. For most people, username is your email address. To invite a user to your account, click "invite user" in the upper right corner. To change the user's access, click the three vertical dots on the right-hand side of the user's listing. You can make the user an administrator, deactivate the user, or permanently delete the user.