{"_id":"5857c79c3ed9a719000c123e","version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":33,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"__v":0,"category":{"_id":"57e2bd9d1e7b7220000d7fa5","version":"55faeacad0e22017005b8268","__v":0,"project":"55faeacad0e22017005b8265","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-09-21T17:04:29.273Z","from_sync":false,"order":14,"slug":"answerfactory-web-application","title":"AnswerFactory Application"},"parentDoc":null,"user":"56267741db1eda0d001c3dbb","project":"55faeacad0e22017005b8265","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-12-19T11:42:20.249Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"settings":"","results":{"codes":[]},"auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"This page guides you through project creation and viewing. If you are looking for a guide to the parts of AnswerFactory, view the [AnswerFactory Web Application Course](doc:answerfactory-web-application-course).\n\n| Contents |\n| --- |\n| [Create New Project](#section-create-new-project) |\n| [View Existing Project](#section-view-existing-project) |\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"You must have GBDX credentials to create or view projects!\"\n}\n[/block]\nWhen you first log in to AnswerFactory, you will be on the View Project homepage.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"If you are ever uncertain of anything during project creation or viewing...\",\n  \"body\": \"...AnswerFactory provides tooltips for nearly every component; hover over an object for additional information to pop up in the GUI to assist you in the process.\"\n}\n[/block]\n#Create New Project#\nTo create a new project, follow these steps:\n\n##Step 1. Click on the New Project button at the top of the page##\nThis will take you to the Create New Project homepage with the Project Information Panel to the left of the screen.\n\n##Step 2. Add one or more Areas of Interest (aois)##\nThere are two ways to accomplish this:\n - In the Project Information Panel, click Draw, and create your aois yourself by clicking on the map to drop vertices. An aoi must be a polygon, and thus must have at least 3 vertices. To close an aoi, click on top of the first vertex or double click as you drop your final vertex. Create as many aois as you need. You can name each drawn aoi to tailor the project for easy reference.\n - In the Project Information Panel, click Upload shapefile, and upload a zip file containing the necessary components of .dbf, .prj, .shp, and .shx. Once the shapefile is uploaded, the **Feature Name Field** will appear, and you must select the field that aois will be grouped by.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"You can mix and match uploading shapefiles and drawing aois.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"If your shapefile is linestrings or points...\",\n  \"body\": \"...you will need to add a buffer or the project will not save. For more information on buffers, check out [create project details](answerfactory-web-application-course#section-create-project-details).\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Once you have at least one active aoi...\",\n  \"body\": \"...the rest of the project creation capabilities become available. Prior to adding an aoi, you will not be able to take any other actions in project creation.\"\n}\n[/block]\n##Step 3. Name your project##\nThe project name will be checked against existing names to prevent multiple projects from having the same name. If you are attempting to name your project a name that already exists, you will be unable to save your project.\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"You cannot save an unnamed project.\"\n}\n[/block]\n##Step 4. Add the Answers you want to your project##\nClick on the Add Answers button to bring up the modal for selecting answers. Click in the field to open the dropdown list of currently available answers. You can dynamically filter for answers by typing into the field. Once you have found an answer you want to add to your project, click on the answer. It will appear on the right side of the screen when added successfully.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Not sure what the answers mean?\",\n  \"body\": \"Check out the [answer types](doc:answerfactory-answer-types) page for definitions of each answer.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Can't find the answer you're looking for?\",\n  \"body\": \"Click on \\\"*Can't find an answer you're looking for? Click here to request a new one.*\\\" in the Add Answers modal, enter a description of the answer you want in the text field, and submit your request for an answer better suited to your needs.\\nOr...\\nIf you can code and have access to the GBDX tasks, you can click \\\"*Or click here to create your own answer!*\\\" instead and [build your own recipe](doc:answerfactory-web-application-course#section-recipe-builder).\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"danger\",\n  \"title\": \"You cannot save a project unless there is at least one answer added.\"\n}\n[/block]\n##Step 5 (the optional step). Add additional configuration information to your project##\nYou can add further detail to your project by clicking on Project Details to expand that section of the Project Information Panel. To see the specifics of what is in this section, check [create project details](doc:answerfactory-web-application-course#section-create-project-details).\n\n##Step 6. Save project##\nOnce your project is set up to your specifications and all requirements are met, click on the Create Project button at the bottom of the Project Information Panel. Once the project has saved, you will automatically be redirected to the View Project page for that project. If saving fails, you will be notified on screen, along with the reason for the failure.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"If at any point you need to start over during project creation...\",\n  \"body\": \"...simply click the Reset Project button and everything will be cleared, allowing you to start fresh.\"\n}\n[/block]\n#View Existing Project#\nTo view an existing project, follow these steps:\n\n##Step 1. Find the project you want to view##\nIn the View Project homepage, you will have access to the Project List. In the Project List, you can search through the pages of projects, jump to a specific page of projects, or filter down the projects in the list. You can filter down to only projects you have created by checking the toggle for Show Only My Projects, filter to only projects with aois that fall within the current viewport by checking the toggle for Show Only Projects in Current Viewport, and/or simply type into the search box to dynamically filter down the projects.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"The dynamic project filter only filters on project name.\"\n}\n[/block]\n##Step 2. Select your project##\nOnce you find the project you want, click on it. The map will snap to the correct view to encompass all of your aois and project-level IDAHO imagery will overlay on the map to cover your aois.\n\nYou will be presented with the base View Project page for your project, which contains the Project Information Panel to the left and the Answer List to the right. Note that the Project Details section contains all of the information found when you are creating a project **with exception to the buffer**, along with the additional information of the project creator, the date and time of project creation, and the date and time that the project was last modified. The Configured Answers section shows all of the answers that have been run for the project, along with any answer-specific information, such as which types of Roads were selected for an Extract Roads run.\n\nThe Answer List contains each of the answers that have been run for the project, along with the states of each answer. For more detail on answer states, [go here](doc:answerfactory-web-application-course#section-answer-list).\n\n##Step 3. View an Answer##\nIn the Answer List, choose an answer you would like to view and click on it once. A table will appear coming up from the bottom of the screen. The table will display a row for each aoi, with the aoi names under the column titled Name, and any columns to the right of the Name column will contain the number of vector results for the specified answer and be titled with the acquisition dates of the images that the answer was run against.\n\nAt the top of the table, under the words \"Filter by:\", you can specify the item type and filter the table, which will adjust the information in each of the cells accordingly. From here, you can also right click on a cell in the table and select **Download as GeoJson** to download all of the vectors in that cell, including vector metadata. If you would prefer all of the vectors, at the bottom of the table is a **Download All Results** button - click on that to save all of the vectors in GeoJson format.\n\n###Step 3.1. View Vectors###\nClick on a cell in the table to view the vector results on the map. You can hover over vectors on the map to view some basic metadata. Right click on a vector to tag the vector with a thumb up or a thumb down, if you so choose.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"If you are viewing vectors and then change the item type filter above...\",\n  \"body\": \"...you must click on the cell again to get the updated vectors on the map.\"\n}\n[/block]\n###Step 3.2. Dig into an Answer###\nEither double click on a table cell or right click on the table cell and select **Details** to load a table of the individual vectors for that cell, including metadata. In this new table, you can search for a specific vector by typing into the dynamic filter, which updates both the table and the vectors on the map, you can double click on a row or click on the magnifying glass next to the row to pan/zoom to a specific vector, you can thumb up or thumb down a specific vector, you can change which columns are viewed in the table, and you can copy/print or download the table as a PDF or a CSV file.\n\n##Step 4 (optional step). Update Project##\nIf you want to add more answers to your project or change other project settings, back out of the details if you have dug in, and minimize the table or, in the Answer List, click on the answer you have open to close it. Now that the Project Information Panel is more readily accessible, make any alterations to your project that you want, including deleting your project altogether.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"If you change certain project settings, you will need to remove and re-add your answers\",\n  \"body\": \"Changing any of the following, AnswerFactory will not automatically kick off a new answer run.\\n- Start Date\\n- End Date\\n- Comparison Count\\n\\nTo rerun your project after these have been updated, you will need to first remove your current answers from the Configured Answers list, update your project, add the answers you would like to run, and update your project again. If you want to keep your current results and alter any of the above, it is recommended that you create a new project instead of updating your existing project.\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Updating your project with Catalog IDs\",\n  \"body\": \"If you:\\n- add cat id(s) to a project that had none, your old answer results will be removed and new answer runs will take place, adding new answer results\\n- add cat id(s) to a project with existing cat id(s), your old answer results will remain and new runs will take place, adding new answer results\\n- remove some but not all cat id(s) from a project, the results that related to the old cat ids will be removed but nothing new will be kicked off\\n- remove all cat id(s) from a project, your old answer results will be removed and new answer runs will take place, adding new answer results\"\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"If you delete your project...\",\n  \"body\": \"...you are not deleting the resulting vectors from the vector archive. The vectors your project extracted can still be queried.\"\n}\n[/block]","excerpt":"Welcome to DigitalGlobe's GBDX AnswerFactory Web Application Project Course Guide","slug":"answerfactory-web-project-course","type":"basic","title":"AnswerFactory Web Project Course"}

AnswerFactory Web Project Course

Welcome to DigitalGlobe's GBDX AnswerFactory Web Application Project Course Guide

This page guides you through project creation and viewing. If you are looking for a guide to the parts of AnswerFactory, view the [AnswerFactory Web Application Course](doc:answerfactory-web-application-course). | Contents | | --- | | [Create New Project](#section-create-new-project) | | [View Existing Project](#section-view-existing-project) | [block:callout] { "type": "warning", "title": "You must have GBDX credentials to create or view projects!" } [/block] When you first log in to AnswerFactory, you will be on the View Project homepage. [block:callout] { "type": "info", "title": "If you are ever uncertain of anything during project creation or viewing...", "body": "...AnswerFactory provides tooltips for nearly every component; hover over an object for additional information to pop up in the GUI to assist you in the process." } [/block] #Create New Project# To create a new project, follow these steps: ##Step 1. Click on the New Project button at the top of the page## This will take you to the Create New Project homepage with the Project Information Panel to the left of the screen. ##Step 2. Add one or more Areas of Interest (aois)## There are two ways to accomplish this: - In the Project Information Panel, click Draw, and create your aois yourself by clicking on the map to drop vertices. An aoi must be a polygon, and thus must have at least 3 vertices. To close an aoi, click on top of the first vertex or double click as you drop your final vertex. Create as many aois as you need. You can name each drawn aoi to tailor the project for easy reference. - In the Project Information Panel, click Upload shapefile, and upload a zip file containing the necessary components of .dbf, .prj, .shp, and .shx. Once the shapefile is uploaded, the **Feature Name Field** will appear, and you must select the field that aois will be grouped by. [block:callout] { "type": "info", "title": "You can mix and match uploading shapefiles and drawing aois." } [/block] [block:callout] { "type": "warning", "title": "If your shapefile is linestrings or points...", "body": "...you will need to add a buffer or the project will not save. For more information on buffers, check out [create project details](answerfactory-web-application-course#section-create-project-details)." } [/block] [block:callout] { "type": "info", "title": "Once you have at least one active aoi...", "body": "...the rest of the project creation capabilities become available. Prior to adding an aoi, you will not be able to take any other actions in project creation." } [/block] ##Step 3. Name your project## The project name will be checked against existing names to prevent multiple projects from having the same name. If you are attempting to name your project a name that already exists, you will be unable to save your project. [block:callout] { "type": "danger", "title": "You cannot save an unnamed project." } [/block] ##Step 4. Add the Answers you want to your project## Click on the Add Answers button to bring up the modal for selecting answers. Click in the field to open the dropdown list of currently available answers. You can dynamically filter for answers by typing into the field. Once you have found an answer you want to add to your project, click on the answer. It will appear on the right side of the screen when added successfully. [block:callout] { "type": "info", "title": "Not sure what the answers mean?", "body": "Check out the [answer types](doc:answerfactory-answer-types) page for definitions of each answer." } [/block] [block:callout] { "type": "info", "title": "Can't find the answer you're looking for?", "body": "Click on \"*Can't find an answer you're looking for? Click here to request a new one.*\" in the Add Answers modal, enter a description of the answer you want in the text field, and submit your request for an answer better suited to your needs.\nOr...\nIf you can code and have access to the GBDX tasks, you can click \"*Or click here to create your own answer!*\" instead and [build your own recipe](doc:answerfactory-web-application-course#section-recipe-builder)." } [/block] [block:callout] { "type": "danger", "title": "You cannot save a project unless there is at least one answer added." } [/block] ##Step 5 (the optional step). Add additional configuration information to your project## You can add further detail to your project by clicking on Project Details to expand that section of the Project Information Panel. To see the specifics of what is in this section, check [create project details](doc:answerfactory-web-application-course#section-create-project-details). ##Step 6. Save project## Once your project is set up to your specifications and all requirements are met, click on the Create Project button at the bottom of the Project Information Panel. Once the project has saved, you will automatically be redirected to the View Project page for that project. If saving fails, you will be notified on screen, along with the reason for the failure. [block:callout] { "type": "info", "title": "If at any point you need to start over during project creation...", "body": "...simply click the Reset Project button and everything will be cleared, allowing you to start fresh." } [/block] #View Existing Project# To view an existing project, follow these steps: ##Step 1. Find the project you want to view## In the View Project homepage, you will have access to the Project List. In the Project List, you can search through the pages of projects, jump to a specific page of projects, or filter down the projects in the list. You can filter down to only projects you have created by checking the toggle for Show Only My Projects, filter to only projects with aois that fall within the current viewport by checking the toggle for Show Only Projects in Current Viewport, and/or simply type into the search box to dynamically filter down the projects. [block:callout] { "type": "info", "title": "The dynamic project filter only filters on project name." } [/block] ##Step 2. Select your project## Once you find the project you want, click on it. The map will snap to the correct view to encompass all of your aois and project-level IDAHO imagery will overlay on the map to cover your aois. You will be presented with the base View Project page for your project, which contains the Project Information Panel to the left and the Answer List to the right. Note that the Project Details section contains all of the information found when you are creating a project **with exception to the buffer**, along with the additional information of the project creator, the date and time of project creation, and the date and time that the project was last modified. The Configured Answers section shows all of the answers that have been run for the project, along with any answer-specific information, such as which types of Roads were selected for an Extract Roads run. The Answer List contains each of the answers that have been run for the project, along with the states of each answer. For more detail on answer states, [go here](doc:answerfactory-web-application-course#section-answer-list). ##Step 3. View an Answer## In the Answer List, choose an answer you would like to view and click on it once. A table will appear coming up from the bottom of the screen. The table will display a row for each aoi, with the aoi names under the column titled Name, and any columns to the right of the Name column will contain the number of vector results for the specified answer and be titled with the acquisition dates of the images that the answer was run against. At the top of the table, under the words "Filter by:", you can specify the item type and filter the table, which will adjust the information in each of the cells accordingly. From here, you can also right click on a cell in the table and select **Download as GeoJson** to download all of the vectors in that cell, including vector metadata. If you would prefer all of the vectors, at the bottom of the table is a **Download All Results** button - click on that to save all of the vectors in GeoJson format. ###Step 3.1. View Vectors### Click on a cell in the table to view the vector results on the map. You can hover over vectors on the map to view some basic metadata. Right click on a vector to tag the vector with a thumb up or a thumb down, if you so choose. [block:callout] { "type": "info", "title": "If you are viewing vectors and then change the item type filter above...", "body": "...you must click on the cell again to get the updated vectors on the map." } [/block] ###Step 3.2. Dig into an Answer### Either double click on a table cell or right click on the table cell and select **Details** to load a table of the individual vectors for that cell, including metadata. In this new table, you can search for a specific vector by typing into the dynamic filter, which updates both the table and the vectors on the map, you can double click on a row or click on the magnifying glass next to the row to pan/zoom to a specific vector, you can thumb up or thumb down a specific vector, you can change which columns are viewed in the table, and you can copy/print or download the table as a PDF or a CSV file. ##Step 4 (optional step). Update Project## If you want to add more answers to your project or change other project settings, back out of the details if you have dug in, and minimize the table or, in the Answer List, click on the answer you have open to close it. Now that the Project Information Panel is more readily accessible, make any alterations to your project that you want, including deleting your project altogether. [block:callout] { "type": "warning", "title": "If you change certain project settings, you will need to remove and re-add your answers", "body": "Changing any of the following, AnswerFactory will not automatically kick off a new answer run.\n- Start Date\n- End Date\n- Comparison Count\n\nTo rerun your project after these have been updated, you will need to first remove your current answers from the Configured Answers list, update your project, add the answers you would like to run, and update your project again. If you want to keep your current results and alter any of the above, it is recommended that you create a new project instead of updating your existing project." } [/block] [block:callout] { "type": "info", "title": "Updating your project with Catalog IDs", "body": "If you:\n- add cat id(s) to a project that had none, your old answer results will be removed and new answer runs will take place, adding new answer results\n- add cat id(s) to a project with existing cat id(s), your old answer results will remain and new runs will take place, adding new answer results\n- remove some but not all cat id(s) from a project, the results that related to the old cat ids will be removed but nothing new will be kicked off\n- remove all cat id(s) from a project, your old answer results will be removed and new answer runs will take place, adding new answer results" } [/block] [block:callout] { "type": "info", "title": "If you delete your project...", "body": "...you are not deleting the resulting vectors from the vector archive. The vectors your project extracted can still be queried." } [/block]