{"_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":11,"slug":"web-application","title":"Web Application"},"version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":34,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"user":"55fae9d4825d5f19001fa379","__v":38,"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":"# What's new? \n\n## Organize your work in Projects\nA project is a container for your work. Projects let you organize your work in a way that makes sense to you. You can add as many Areas of Interest (AOI) and tasks to a project as you choose. \n\n## Upload a file to define your Area of Interest \n You can now upload Area of Interest files in these formats: .shp, .kml, .wkt, .gml or .geojason files. \n\n## Run a task from our extensive Task Library\nAll tasks in the Task Library have been tested, documented, and certified by our Algorithm Curation team. Click on the task's detail page to learn more about it. \n\n## You decide where to start  \nAll paths lead to the same place. You decide how to get there. You can start by creating a Project, choosing a task from the Task Library, or defining your Area of Interest. Each path will walk you through the same steps to the end. \n\n## Easily find and download the output file(s) from your task\nWhen a task is complete, we'll link you to the S3 Browser where you can download the output file(s) from your task. \n\n## Use the Dashboard to track your work\nView the status of all tasks you're running, and see your list of projects. \n\n---------\n# Get Started\n\n## Supported browsers\nGoogle Chrome, Firefox, and Safari are the supported browsers. The GBDX web application is not supported on any version of Internet Explorer.\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 create 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\nEnter your email address and the password you created to log in to your account.\n\n## Watch the video tour\nThe first time you log in, you'll see a splash screen with an option to \"take a tour.\" We recommend you watch this short video that walks you through the web application.\n\n## Choose your Starting Point\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. \nUse the left navigation to decide where to start. These are the process flows for each starting point.\n\n![Left Navigation](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-LeftNav.png)\n\n**If you start on the Areas of interest page**: Create your Area of Interest(AOI) >add it to a new or existing project > choose a task > choose \"save and run.\"\n\n**If you start in the Task Library**: Choose a task > add it to a new or existing project > define your AOI > choose \"save and run.\"\n\n**If you start with a project:** Create a new project or choose an existing one > define your AOI > choose a task > choose save and run.\n\n\n\n---------\n# ![Projects](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-projects-icon2.png) Projects\nA project is a container for your work. You'll save Areas of Interest and Tasks to a project. \n\n## Create a Project\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 or a task 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##Projects Page\nThe projects page displays all the projects the user has created. Click on a project to see the tasks and areas of interest that are stored in the project. From this view, click \"add task\" to run another task using the areas of interest that are stored here.\n\n## Task Outputs\nView the status of tasks in this project. If a task is complete, click \"view result\" to see the results of the task run and download the output files. \n\nTo delete running tasks in this view, click the box next to the task, then select the trash can icon at the top of the list. \n\n## Areas of Interest\nSee the areas of interest that are stored in this project. You can add areas of interest to the project from here. \n\n## Add Task \nClicking \"add task\" from within a project opens the task library. Select a task, then choose \"save and run\". Choose the filters you want to apply, and then choose \"run task with selected filters.\" These results will be saved in the project. \n\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# ![Task Library](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-task-library-icon.png) Task Library\nThe task library is a set of tasks, or alogrithms, that have been certified by our Algorithm Curation team to run on the GBDX platform and in the web application. \n\nWe've done the pre-processing work for you. Each task is a pre-defined workflow that runs the required pre-processing tasks before running the selected task. For example, the \"8Band_Cloud_Mask\" task runs AOP_Strip_Processor with AComp to create an atmospherically compensated image in the correct format. The cloud mask is then run, using that image as the input. \n\n## Select a Task\nClick a task to see its description. If you want to use this task, choose \"Add to Project.\" See the Projects section above if you need help creating a project or saving work to an existing project. \n\n## Add an Area of Interest\nSee \"Areas of Interest section if you need help creating or uploading an AOI.\n\n## Save and Run\nOnce a task and an area of interest have been selected, the \"save and run\" button will appear. Click the button to start the task.\n\n## Task Filters\nSome tasks have the option to set task filters. When you choose \"save and run\" a task, you'll see a list of filters to choose from. If there are two choices for a filter, the first choice is the filter value you set for your area of interest, and the second choice is the the value you can set for the task. If you choose the task filter option, it overrides the filter value you selected when creating your area of interest. \n\n## Task Status\nSelecting \"save and run\" will bring you to the task status page. Here you'll see a list of tasks running within your project. To delete a running task from here, check the box next to the task, and select the trash can icon at the top of the list.\n\nColumn name | Description\n--- | ---\n%Complete | Shows the progress of the running task\nTask Name | The name of the running task\nLast updated | Shows when the task status was most recently updated\nImages in Task Run | The number of images in the AOI the task was run on\nTask Status | The status of the running task\n\n\n## Task States\n\nState | Description\n--- | ---\nNot started | Task has not started running yet. This could be because selecting a task was interrupted or an AOI was not selected. \nIn Progress | The task has started, but has not completed. Click on \"In Progress\" for more details.\nView Results | The task has completed. Results from the task run can be viewed by clicking the \"view results\" box. \nFailed | The task did not run successfully. Select the arrow at the far right to retry the task.\n\n## Task Progress\nWhen a task is \"in progress\", you can click the status box get more information. On the task progress page, a status bar tells you what step the task run is on.\n\n![Task progress](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-task-progress.png)\n\nStep | Description\n--- | ---\nSearching catalog | Searching the catalog for the requested images\nOrdering Acquisitions | Ordering any images that aren't already available from the DG Factory\nRunning Task | The requested task is running. This can take awhile. Processing times depend on the task itself and the number of size of images selected.\n\n## View Results\nWhen a task is complete, the blue status bar will be filled in completely, and the status will say \"View Result.\" Click the \"View Result\" link to get status details. The results page shows:\n\nItem | Description\n--- | ---\nStatus bar | All steps on the status bar will turn blue\nTask Status | Task status will show \"Complete\"\nTime Stamps | Start and Completed time stamps for the task\nImages in Project | The number of images in the selected AOI for the task run\nImages Processed | The number of images processed by the task\nImages Failed | The number of images that could not be processed in the task run\nTask Filters Applied | Filters that were applied when the AOI was defined or when the task was selected.\nAncillary Data | Coming soon -- There is no ancillary data to apply at this time\nImages Processed | Visual output of the original images that were part of the AOI. \n\n## Download the output of the Task\nTo see and download the output files from the task, choose \"Download Output\" from the \"View Results\" page. \n\nChoosing \"Download Output\" opens the login screen for the GBDX S3 Crawler.Log in with the email address and password you use to sign in to the web application. \n\nThe Directory structure looks like this:\n\nTask name > Output > Image ID > Output files\n\nSome tasks create an additional directory between the Image ID and the Output files. \n\nIn this example, the completed task was \"ENVI_ISOClassification. The directory is given the same name as the task that was run. \n\n![S3browser](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course+-+S3+browser.png)\n\nAt each directory level, there are options to \"Download Selected\" or \"Delete Selected\" files. \n\nNote: Output files cannot be opened or visualized in the web application. \n\n---------\n# ![Dashboard](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-dashboard2.png) Dashboard\n\nThe Dashboard is a list view of your tasks and projects. From the dashboard view you can:.\n* See a list of all tasks running in all projects\n* Access a task's description\n* See status of each task\n* View the result of the task run\n* See a list of all your projects \n* See a project's created date and last updated time stamp\n* Open a project\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":"Welcome to the all new GBDX web application. We've made it easier to find the tasks that meet your business needs, to define your Area of Interest, and to organize your work and track your progress.","slug":"web-application-course","type":"basic","title":"Web Application V2 Course"}

Web Application V2 Course

Welcome to the all new GBDX web application. We've made it easier to find the tasks that meet your business needs, to define your Area of Interest, and to organize your work and track your progress.

# What's new? ## Organize your work in Projects A project is a container for your work. Projects let you organize your work in a way that makes sense to you. You can add as many Areas of Interest (AOI) and tasks to a project as you choose. ## Upload a file to define your Area of Interest You can now upload Area of Interest files in these formats: .shp, .kml, .wkt, .gml or .geojason files. ## Run a task from our extensive Task Library All tasks in the Task Library have been tested, documented, and certified by our Algorithm Curation team. Click on the task's detail page to learn more about it. ## You decide where to start All paths lead to the same place. You decide how to get there. You can start by creating a Project, choosing a task from the Task Library, or defining your Area of Interest. Each path will walk you through the same steps to the end. ## Easily find and download the output file(s) from your task When a task is complete, we'll link you to the S3 Browser where you can download the output file(s) from your task. ## Use the Dashboard to track your work View the status of all tasks you're running, and see your list of projects. --------- # Get Started ## Supported browsers Google Chrome, Firefox, and Safari are the supported browsers. The GBDX web application is not supported on any version of Internet Explorer. ## 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 create 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 Enter your email address and the password you created to log in to your account. ## Watch the video tour The first time you log in, you'll see a splash screen with an option to "take a tour." We recommend you watch this short video that walks you through the web application. ## Choose your Starting Point 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. Use the left navigation to decide where to start. These are the process flows for each starting point. ![Left Navigation](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course-LeftNav.png) **If you start on the Areas of interest page**: Create your Area of Interest(AOI) >add it to a new or existing project > choose a task > choose "save and run." **If you start in the Task Library**: Choose a task > add it to a new or existing project > define your AOI > choose "save and run." **If you start with a project:** Create a new project or choose an existing one > define your AOI > choose a task > choose save and run. --------- # ![Projects](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-projects-icon2.png) Projects A project is a container for your work. You'll save Areas of Interest and Tasks to a project. ## Create a Project 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 or a task 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) ##Projects Page The projects page displays all the projects the user has created. Click on a project to see the tasks and areas of interest that are stored in the project. From this view, click "add task" to run another task using the areas of interest that are stored here. ## Task Outputs View the status of tasks in this project. If a task is complete, click "view result" to see the results of the task run and download the output files. To delete running tasks in this view, click the box next to the task, then select the trash can icon at the top of the list. ## Areas of Interest See the areas of interest that are stored in this project. You can add areas of interest to the project from here. ## Add Task Clicking "add task" from within a project opens the task library. Select a task, then choose "save and run". Choose the filters you want to apply, and then choose "run task with selected filters." These results will be saved in the project. -------- # ![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. ------------ # ![Task Library](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-task-library-icon.png) Task Library The task library is a set of tasks, or alogrithms, that have been certified by our Algorithm Curation team to run on the GBDX platform and in the web application. We've done the pre-processing work for you. Each task is a pre-defined workflow that runs the required pre-processing tasks before running the selected task. For example, the "8Band_Cloud_Mask" task runs AOP_Strip_Processor with AComp to create an atmospherically compensated image in the correct format. The cloud mask is then run, using that image as the input. ## Select a Task Click a task to see its description. If you want to use this task, choose "Add to Project." See the Projects section above if you need help creating a project or saving work to an existing project. ## Add an Area of Interest See "Areas of Interest section if you need help creating or uploading an AOI. ## Save and Run Once a task and an area of interest have been selected, the "save and run" button will appear. Click the button to start the task. ## Task Filters Some tasks have the option to set task filters. When you choose "save and run" a task, you'll see a list of filters to choose from. If there are two choices for a filter, the first choice is the filter value you set for your area of interest, and the second choice is the the value you can set for the task. If you choose the task filter option, it overrides the filter value you selected when creating your area of interest. ## Task Status Selecting "save and run" will bring you to the task status page. Here you'll see a list of tasks running within your project. To delete a running task from here, check the box next to the task, and select the trash can icon at the top of the list. Column name | Description --- | --- %Complete | Shows the progress of the running task Task Name | The name of the running task Last updated | Shows when the task status was most recently updated Images in Task Run | The number of images in the AOI the task was run on Task Status | The status of the running task ## Task States State | Description --- | --- Not started | Task has not started running yet. This could be because selecting a task was interrupted or an AOI was not selected. In Progress | The task has started, but has not completed. Click on "In Progress" for more details. View Results | The task has completed. Results from the task run can be viewed by clicking the "view results" box. Failed | The task did not run successfully. Select the arrow at the far right to retry the task. ## Task Progress When a task is "in progress", you can click the status box get more information. On the task progress page, a status bar tells you what step the task run is on. ![Task progress](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-task-progress.png) Step | Description --- | --- Searching catalog | Searching the catalog for the requested images Ordering Acquisitions | Ordering any images that aren't already available from the DG Factory Running Task | The requested task is running. This can take awhile. Processing times depend on the task itself and the number of size of images selected. ## View Results When a task is complete, the blue status bar will be filled in completely, and the status will say "View Result." Click the "View Result" link to get status details. The results page shows: Item | Description --- | --- Status bar | All steps on the status bar will turn blue Task Status | Task status will show "Complete" Time Stamps | Start and Completed time stamps for the task Images in Project | The number of images in the selected AOI for the task run Images Processed | The number of images processed by the task Images Failed | The number of images that could not be processed in the task run Task Filters Applied | Filters that were applied when the AOI was defined or when the task was selected. Ancillary Data | Coming soon -- There is no ancillary data to apply at this time Images Processed | Visual output of the original images that were part of the AOI. ## Download the output of the Task To see and download the output files from the task, choose "Download Output" from the "View Results" page. Choosing "Download Output" opens the login screen for the GBDX S3 Crawler.Log in with the email address and password you use to sign in to the web application. The Directory structure looks like this: Task name > Output > Image ID > Output files Some tasks create an additional directory between the Image ID and the Output files. In this example, the completed task was "ENVI_ISOClassification. The directory is given the same name as the task that was run. ![S3browser](https://s3.amazonaws.com/gbdx-doc-images/Webapp2Course+-+S3+browser.png) At each directory level, there are options to "Download Selected" or "Delete Selected" files. Note: Output files cannot be opened or visualized in the web application. --------- # ![Dashboard](https://s3.amazonaws.com/gbdx-doc-images/webapp2course-dashboard2.png) Dashboard The Dashboard is a list view of your tasks and projects. From the dashboard view you can:. * See a list of all tasks running in all projects * Access a task's description * See status of each task * View the result of the task run * See a list of all your projects * See a project's created date and last updated time stamp * Open a project ---------- # ![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.