USDA Carbon Data Visualization Tool Software Users Manual Version 1.0 April 2012 Critigen and The catalyst to modernize critical infrastructure are trademarks of Critigen. All other trademarks used herein are the property of their respective owners. Copyright 2010 Critigen. All rights reserved.
Software Users Manual Contents INTRODUCTION... 2 1.1 PURPOSE... 2 1.2 SCOPE... 2 1.3 DEFINITIONS, ACRONYMS, AND ABBREVIATIONS... 2 1.4 REFERENCES... 3 SECTION 2. USDA CARBON DATA VISUALIZATION TOOL OVERVIEW... 4 2.1 SOFTWARE APPLICATION... 4 2.2 SOFTWARE INVENTORY... 4 2.3 SOFTWARE ENVIRONMENT... 4 2.4 SOFTWARE ORGANIZATION AND OVERVIEW OF OPERATION... 4 2.5 INTENDED USERS... 5 2.6 SECURITY AND PRIVACY... 5 2.7 ASSISTANCE AND PROBLEM REPORTING... 5 SECTION 3. GETTING STARTED... 6 3.1 CARBON DATA VISUALIZATION TOOL COMPONENTS... 6 3.2 FIRST TIME USERS... 7 3.3 RETURNING USERS... 10 3.4 RECOVER PASSWORD... 10 3.5 SIGN OUT... 12 SECTION 4. MANAGING YOUR ACCOUNT... 13 4.1 UPDATE ACCOUNT INFORMATION... 13 4.2 CHANGE PASSWORD... 14 4.3 REQUEST MANAGER PRIVILEGES... 16 SECTION 5. MODEL INFORMATION MODULE... 17 5.1 VIEWING MODEL INFORMATION... 17 SECTION 6. MAP LAYER INFORMATION MODULE... 20 6.1 VIEWING MAP LAYER INFORMATION... 20 SECTION 7. GIS MAPPING MODULE... 24 7.1 OPENING THE GIS MAPPING MODULE... 24 7.2 MAP DISPLAY CONTROLS... 25 7.2.1 Move the Map Using the Pan Button... 26 7.2.2 Pan around the Map... 26 7.2.3 Enlarge a Map segment using the Zoom-In to Selection button... 27 7.2.4 Reduce the Map size using the Zoom-Out to Selection button... 28 7.2.5 Enlarge the Map using the Zoom-In button... 29 7.2.6 Reduce the Map using the Zoom-Out button... 30 7.2.7 Using Zoom Slider... 30 7.2.8 Map Extent... 30 7.2.9 Previous Map Extents... 31 7.2.10 Clear Map... 31 7.2.11 Map Scale Bar... 31 7.2.12 Overview Window... 31 7.3 LAYERS... 33 7.3.1 Toggle themes on and off... 34 P a g e ii
Software Users Manual 7.3.2 Set Layer Transparency... 34 7.3.3 View Layer Metadata... 35 7.3.4 View Layer Legend... 36 7.4 MAP LEGEND TOOL... 38 7.5 COMPARISON SLIDER... 41 7.5.1 Enlarge the Map using the Zoom-In button... 44 7.5.2 Reduce the Map using the Zoom-Out button... 44 7.5.3 View Layer Metadata within the Comparison Slider... 44 7.5.4 View Layer Legend within the Comparison Slider... 45 7.6 TIME SERIES TOOL... 45 7.5.5 Enlarge the Map using the Zoom-In Button... 47 7.5.6 Reduce the Map using the Zoom-Out Button... 47 7.5.7 View Layer Metadata within the Time Series... 48 7.5.8 View Layer Legend within the Time Series... 48 7.6 FIND TOOL... 48 7.5.9... 50 7.6 CARBON/OTHER IDENTIFY TOOL... 51 7.5.10... 52 7.7 IDENTIFY TOOL... 52 7.8 PIE CHART TOOL... 55 7.9 BAR CHART TOOL... 59 7.10 MODEL/DATA AVAILABILITY VIEWER... 63 7.10.1 Indentifying Available Data from Availability List... 63 7.10.1 Indentifying Available Data from Map... 67 7.11 CARBON POOL RESULTS TOOL... 71 7.11.1 Toggle Carbon Composite Layer on and off... 72 7.11.2 Adding/Removing Model Data from the Composite Layer... 73 SECTION 8. ADMINISTRATION MODULE... 77 8.1 MANAGING USERS... 77 8.1.1 Managing Users... 77 8.1.2 Deleting Users... 79 8.1.3 Adding a New User... 80 8.1.4 Changing User Password... 83 8.1.5 Filtering the User Table... 84 8.2 MANAGING ROLES... 85 8.2.1 Managing Tool Roles... 85 8.2.2 Managing Layers Roles... 87 8.3 MANAGING WELCOME PAGE CONTENT... 89 8.3.1 Managing Contacts Content... 90 8.3.2 Managing Welcome Message for Authenticated Users... 92 8.3.3 Managing Welcome Message for Non-Authenticated Users... 94 8.4 MANAGING LINKS... 96 8.4.1 Editing Links... 97 8.4.2 Deleting Links... 98 8.4.3 Adding Links... 100 8.5 MANAGING LOOKUP TABLES... 102 8.5.1 Editing Lookup Tables... 102 8.5.2 Deleting Lookup Table Item... 103 8.5.3 Adding Lookup Item... 105 P a g e iii
SHARP Software User s Manual Critigen and The catalyst to modernize critical infrastructure are trademarks of Critigen. All other trademarks used herein are the property of their respective owners. Copyright 2010 Critigen. All rights reserved.
Introduction 1.1 Purpose This Software User Manual (SUM) provides general users with instructions on how to use the USDA Carbon Data Visualization Tool. It details the on-line data and tools used for and related to carbon modeling of agricultural, forest, and range lands. The data and tools will be accessible on-line through an application that facilitates access to and display of information. 1.2 Scope The intent of the USDA On-line Visualization and Mapping Application is to organize and make readily accessible carbon-related information owned or used by USDA via a single web site. The application information will include Geographic Information System (GIS) data layers, model information; model results, related information, and tools to improve access to and display of the information. Target users for the Application include USDA personnel, researchers and scientists from other agencies, and the public. The user of the application may vary by the type of user. Researchers, for example, may be interested in the data contained in the Application. USDA personnel may wish to compare model results. The public may wish to learn more about the features of the various carbon models and want to view the results of modeling scenarios. 1.3 Definitions, Acronyms, and Abbreviations Abbreviation Meaning ASP Active Server Pages ATLAS Aggregate Timberland Assessment System CBI Conservation Biology Institute CCT Carbon Calculation Tool COLE Carbon Online Estimator COMET-Farm Carbon Management Evaluation Tool for farms COMET-VR Carbon Management Evaluation Tool - Voluntary Reporting FIA Forest Inventory and Analysis National Program FORCARB2 Forest Carbon Budget Estimator FVS Forest Vegetation Simulator GHG Greenhouse Gas GIS Geographic Information System HUC Hydrologic Unit Code IIS Internet Information Services LRR Land Resource Region MLRA Major Land resource Area NAD27 North American Datum of 1927 [Version Number (0.1)] 2 [Version Date (10/08/2011)]
NAD83 North American Datum of 1983 NAVD29 North American Vertical Datum of 1929 NAVD88 North American Vertical Datum of 1988 NCDC National Climatic Data Center NCSS National Cooperative Soil Survey NED National Elevation Dataset NLCD National Land Cover Database NOAA National Oceanic and Atmospheric Administration NRCS Natural Resources Conservation Service NRI Natural Resources Inventory NWS National Weather Service PRISM Parameter-elevation Regressions on Independent Slopes Model SSURGO Soil Survey Geographic database STATSGO2 US General Soil Map (formerly State Soil Geographic database) TAMM Timber Assessment Market Assessment USDA United States Department of Agriculture USFS United States Forest Service USGS United States Geological Survey UTM Universal Transverse Mercator WGS84 World Geodetic System of 1984 WMS Web Mapping Service 1.4 References Document Date May 2011 May 2011 Nov 2011 Reference On-line Visual Mapping Work Plan Final.docx USDA On-line Visualization Requirements Final.docx Data Management Plan.docx [Version Number (0.1)] 3 [Version Date (10/08/2011)]
Section 2. USDA Carbon Data Visualization Tool Overview 2.1 Software Application The USDA Carbon Data Visualization Tool application includes the following major functions: Map Viewer Interactive display of Geographic Information System (GIS) data layers, model information; model results, related information, and analysis tools. Data - The On-line Visualization and Mapping Application will provide users with access to data related to carbon estimating models. Model Integration - Information for each model, including descriptions and a point of contact, will be provided for users to find out more about the models. The model integration portion of the application will allow the users to select a model and a scenario.. Tools - The tools include a Model/Data Availability Viewer, a Model Selection Decision Tree, Pie Chart, Bar Graphs, Identification, and Carbon Identify and Time Series. 2.2 Software Inventory USDA Carbon Data Visualization Tool uses Microsoft Internet Information Server (IIS), ASP.NET, ESRI s ArcGIS Server, Safe Software s Feature Manipulation Engine (FME) Workbench, and SQL Server technologies. 2.3 Software Environment Requirements for USDA Carbon Data Visualization Tool are: Web Server o Windows Server 2003 or above o IIS 7.01 or above o.net Framework 3.5 Database Server Windows Server 2003 or above; SQL Server 2005 o Windows Server 2003 or above o SQL Server 2005 Client o Windows XP, Vista, or Windows 7 o Internet Explorer 7.0 or above o Flash Player 10 or above 2.4 Software Organization and Overview of Operation The Portal is a hosted solution residing on a virtual server in the Amazon EC2 data center. This service provides a Service Level Agreement guaranteeing 99.95% system availability. The Page 4 of 109
Amazon environment can also be secured a number of ways to prevent unauthorized access to the systems and data backup capabilities to prevent data loss. 2.5 Intended Users Target users for the Application include USDA personnel, researchers and scientists from other agencies, and the public. The user of the application may vary by the type of user. Researchers, for example, may be interested in the data contained in the Application. USDA personnel may wish to compare model results. The public may wish to learn more about the features of the various carbon models and want to view the results of modeling scenarios. 2.6 Security and Privacy Web portal is an authentication method which authenticates users by requiring them to input username and password on web pages. This method needs no station configuration and minimal management of Carbon Data Visualization Tool. And one user s change about the username and password would not affect others, this minimize the Carbon Data Visualization Tool s administrator s work as well. 2.7 Assistance and Problem Reporting For technical support, please email carbontoolsupport@critigen.com with your questions or issues on using the site. For other questions, please email Carolyn Olson, PhD at Carolyn.Olson@wdc.usda.gov. Page 5 of 109
Section 3. Getting Started To access the Carbon Data Visualization Tool, open an internet browser and enter the URL http://www.carbonmodeldata.com/usda/default.aspx Figure 3: Carbon Data Visualization Tool Home Page 3.1 Carbon Data Visualization Tool Components The Carbon Data Visualization Tool site home page contains the following navigation and information areas: 1. Welcome returns users to the Carbon Data Visualization Tools home page. 2. Carbon Visualization Tool opens the carbon visualization tools GIS module. 3. Model Information The Model Information module allows for the storage and management of metadata for the data models represented within the Carbon Visualization Tool. Page 6 of 109
4. Map Layer Information- The Map Layer Information module allows for the storage and management of metadata for the GIS layers represented within the Carbon Visualization Tool. 5. Manage Your Account users have access to manage their own account and password information. 6. Contacts USDA and site contact information list. 7. Links relevant URL or folder links. Figure 3.1: Update Account Information Link 3.2 First Time Users Page 7 of 109
1. Select the Create New Account hyperlink within the User Login area or in main panel. Figure 3.2.1: Create New Account Links 2. Enter a user name, email address, password, first and last name. Page 8 of 109
Figure 3.2.2: Create a New Account Form Usernames must be unique. Duplicate usernames will be indentified on submittal of form data. Passwords must be a minimum of 7 characters in length and contain at least 1 special character. Required fields are indentified with asterisks. Providing organization, title and phone are optional contact items. 3. Select Create Account to submit form data. 4. Cancel button cancels form without saving. Page 9 of 109
3.3 Returning Users 1. Enter User Name and Password within the User Login area. Figure 3.3.1 User Login Area 2. Select the Log In button. 3.4 Recover Password Enter your User Name to receive your password via email. 1. Select the Forgot Password? link within the User Login area. Page 10 of 109
Figure 3.4.1: Forgot Password Hyperlink 2. Enter User Name and select the Recover Password button. Figure 3.4.2: Forgot Password Form 3. The password will be sent via email. Page 11 of 109
3.5 Sign Out 1. Select the Sign Out button located above the User Login area. 2. Closing the browser window will also sign out the user. Page 12 of 109
Section 4. Managing Your Account 4.1 Update Account Information Users are able to manage their own account information from the Manage Your Account module. 1. Select the Update Account Information hyperlink within the Manage Your Account area Figure 4.1.1: Update Account Information Link 2. Modify the Account Information fields. Page 13 of 109
Figure 4.1.2: Update Account Information Link 3. Select Update Account to submit form data. 4. Cancel button cancels form without saving. 4.2 Change Password Use the Change Password form to change your password. 1 Select the Change Password hyperlink within the Manage Your Account area Page 14 of 109
Figure 4.2.1: Change Password Link 2 Modify the Account Information fields. Passwords must be a minimum of 7 characters in length and contain at least 1 special character. Figure 4.2.2: Change Password Form 3 Select Change Password button to submit form data. 4 Cancel button cancels form without saving. Page 15 of 109
4.3 Request Manager Privileges Managers have edit privileges on the Carbon Visualization Tool site. With edit privileges managers are able to manage and maintain the data stored and shown on the site. 1. Select the Request Manager Privileges hyperlink within the Manage Your Account area. Figure 4.3.1: Request Manager Privileges Link 2. Selecting link will submit manager privilege request to the site administrator. Figure 4.3.2: Request Manager Privileges Email Page 16 of 109
Section 5. Model Information Module 5.1 Viewing Model Information The Model Information module allows for the storage and management of metadata for the data models represented within the Carbon Visualization Tool. 1. Select the Model Information tab from the top navigation bar. Figure 5.1.1: Model Information Tab The Model Information page displays the models used within the Carbon Data Visualization Mapping Module. The models are aligned in a list and a tabular format. Selecting either the model name from the left Model list or from the center table will open the model information specific to the selected model. Page 17 of 109
Figure 5.1.2: Model Information Page The Model information is read only for general users. Users with Administration rights will be able to modify the data shown. Page 18 of 109
Figure 5.1.3: Model Information Page Page 19 of 109
Section 6. Map Layer Information Module 6.1 Viewing Map Layer Information The Map Layer Information module allows for the storage and management of metadata for the GIS data and map layers represented within the Carbon Visualization Tool. 1. Select the Map Layer Information tab from the top navigation bar. Figure 6.1.1: Map Layer Information Tab The Map Layer Information page displays the models used within the Carbon Data Visualization Mapping Module. The layers are aligned in a tabular format. 2. Select the Model-Related tab to view active map layers. 3. Select the Model Output tab to view upcoming map layers. Page 20 of 109
4. Select the Reference Layers tab to view upcoming map layers. 5. Select the Composite Layers tab to view upcoming map layers. 6. Select the Upcoming Layers tab to view upcoming map layers. Selecting the map layer name from the center table will open the map layer information specific to the selected layer. Page 21 of 109
Figure 6.1.2: Map Layer Information Page The map layer information is read only for general users. Users with Administration rights will be able to modify the data shown. Page 22 of 109
Figure 6.1.3: Map layer Information Page Page 23 of 109
Section 7. GIS Mapping Module 7.1 Opening the GIS Mapping Module The Carbon Data Visualization provides advanced discovery, analysis and interaction tools through the use of GIS map module. A geographic information system (GIS) is a technology that makes it possible to make a map in minutes. Maps access mounds of useful information with just a simple click of the mouse. Users do not need any desktop or server software; all its capabilities are accessible within the web browser. 1. Select the Carbon Visualization Tool tab from the top navigation bar. Figure 7.1.1: Carbon Visualization Tool Tab Or select the Carbon Visualization Tool button from the Welcome page area. Figure 7.1.2: Carbon Visualization Tool Button Web maps contain a basemap; data layers; an extent; a legend; and navigation tools such as zoom, pan, place finders, and bookmarks. The web maps also contain Page 24 of 109
interactive elements such as a layer gallery, availability tool, time series, and comparison tools, plus pop-up windows that display attributes about a specific feature, and buttons for playing data over time. Figure 7.1.3: Carbon Visualization Tool GIS Map Module 7.2 Map Display Controls The Map Display Control Bar provides the user with the ability to pan about the map, toggle map extent, zoom in, zoom out, and open a magnification window. Page 25 of 109
Figure 7.2.1: Map Display Controls 7.2.1 Move the Map Using the Pan Button The Pan Button moves the map within the display window. 1. Click the Pan button. 2. Move the Mouse pointer over the map (the pointer will look like a hand). 3. Click and drag the map to the desired point within the display window. 7.2.2 Pan around the Map The Pan directional arrows allow you to move the map one extent at a time in the direction indicated by the arrow. Page 26 of 109
Figure 7.2.2: The Pan directional arrows 7.2.3 Enlarge a Map segment using the Zoom-In to Selection button The Zoom-In to selection button located below the Pan button, enlarges a defined section of the map 1. Click the Zoom-In to Selection button. The button will remain highlighted and active until you click it again. 2. Move your cursor to a point on the map.. 3. Click and drag your cursor sin any direction from the selected map point to define and highlight a rectangle. Page 27 of 109
Figure 7.2.3: Define the Map section to Magnify Repeat steps until you have defined the desired map section boundaries and the desired level of magnification. 7.2.4 Reduce the Map size using the Zoom-Out to Selection button The Zoom-Out to Selection button, located below the Zoom-In button, reduces the map after you have enlarged a section of the map. 1. Click the Zoom-Out to Selection button. The button will remain highlighted and active until you click it again. 2. Move your cursor to a point on the map. 3. Click and drag your cursor in any direction from the selected map point to define and highlight a rectangle. Page 28 of 109
Figure 7.2.4: Defined Zoom-Out Section 4. Release the cursor button. The defined rectangular map segment will be highlighted. 5. The entire map will be reduced in size in proportion to the size of the rectangle you defined. In other words, if you define a very small rectangle, the map will reduce to a very small size. If you define a larger rectangle, the map will reduce to a larger size. 7.2.5 Enlarge the Map using the Zoom-In button The Zoom-Out button reduces the size of the entire map when you click the button. Page 29 of 109
1. Click the Upper Zoom-Out button. 2. The entire map will be reduced in size. 3. Click the Upper Zoom-Out button again to reduce the map further. 4. Continue to click the Upper Zoom-Out button until the map is the desired size. 7.2.6 Reduce the Map using the Zoom-Out button The Zoom-In button is used you enlarge the entire map when you click the button. 1. Click the Zoom-In button. 2. The entire map will be enlarged. 3. Click the Zoom-In button again to enlarge the map further. 4. Continue to click the Zoom-In button until the map is the desired size. 7.2.7 Using Zoom Slider Drag the zoom slider up or down to zoom in or out incrementally using the zoom slider. Figure 7.2.7: Zoom Slider 7.2.8 Map Extent Map Extent is another term for a defined limit of a map view. The Map Extent button returns to the default view of the map from whatever configured view is currently being displayed. Page 30 of 109
1. Click the Map Extent button to return to the default map view from whatever expanded, magnified or reduced view you have configured as the current view. During your session, you can return to previously configured Map Extents by using the Previous Extent button. 7.2.9 Previous Map Extents 1. Click the Previous Extent button to page backward from the currently displayed Map Extent through Map Extents you have configured during the current session. 7.2.10 Clear Map 1. Click the Clear Map button to clear selections made during the current session. 7.2.11 Map Scale Bar The Scale Bar Control generates a bar representing a certain distance on the map. The scale bar is located at the bottom left corner of the map window. MapUnit is set to whatever unit the Map's Spatial Reference is using. Figure 7.2.11: Map Scale Bar 7.2.12 Overview Window The overview window provides you with a high level map perspective as you zoom in/out or pan across the map display. Page 31 of 109
Figure 7.2.12.1: Overview Window Button 1. Click the Overview Map to open the Overview Window Figure 7.2.12.2: Overview Window Control 2. The Overview Window will locate the current map view within the context of the Full Extent of the map. 3. You can reposition the current map display by clicking and dragging the red rectangle over the map within the Overview Window. 4. Click the at the upper left corner of the Overview Window to close the window. Page 32 of 109
7.3 Layers The Layers toolbar button, when clicked, opens a new dialog box in the map display. Layers Dialog Box does the following: Figure 7.3.1: Layers Button on Toolbar Toggled on or off map layers within the map display. Set layer Opacity Show layer metadata Show layer legend Figure 7.3.2: Layers Dialog Box Page 33 of 109
7.3.1 Toggle themes on and off 1. Check the box to the right of a Layer Name to select a layer to appear on the map. The selected themes and layers will appear in the map display. Figure 7.3.1.1: Layers Visibilty Toggle Note: Some layers may not be visible because the map layers on the top are not transparent. To see below layers set the transparency of the layer by selecting the Opacity Scale. 2. Select the to close the tool box windows. 7.3.2 Set Layer Transparency 1. Check the box to the right of a Layer Name to select a layer to appear on the map. 2. Slide the Opacity Slider to adjust the transparency of the layer. Page 34 of 109
Figure 7.3.2: Layers Opacity Slider 7.3.3 View Layer Metadata 1. Click the Information Icon to the left of a Layer Name to view the metadata for the layer. Figure 7.3.3.1: Layers More Information Button 2. An Information dialog box will open for the selected layer. Page 35 of 109
Figure 7.3.3.2: Metadata Information Dialog Box 3. Select the to close the tool box windows. 7.3.4 View Layer Legend 1. Click the Legend Icon to the left of a Layer Name to view the Legend for the layer. Page 36 of 109
Figure 7.3.4.1: Layer Legend Button 2. A legend dialog box will open for the selected layer. Page 37 of 109
Figure 7.3.4.2: Layer Dialog Box 3. Select the to close the tool box windows. 7.4 Map Legend Tool Another option for viewing the map legend is by selecting the Map Legend tool button on the top navigation bar. The Map Legend button opens the Legend window with the layer selected and its legend displayed in the window. Figure 7.4.1: Map Legend Tool Button Each layer that is currently visible on the map is displayed expanded by its various symbols beneath. The symbols and their labels are graphics and non-interactive. Page 38 of 109
Figure 7.4.2: Map Legend Dialog Box 1. Click the Information Icon to the left of a Layer Name to view the metadata for the layer. Page 39 of 109
Figure 7.4.3: Layers More Information Button 2. An Information dialog box will open for the selected layer. Page 40 of 109
Figure 7.4.4: Metadata Information Dialog Box 1. Select the to close the tool box windows. 7.5 Comparison Slider The Comparison Slider provides a tool for the examination of two map layers in order to note similarities and differences. This tool uses a slider effect to reveal a split image of two images aligned side by side of each other. Page 41 of 109
Figure 7.5.1: Comparison Slider Window Note the Comparison Slider window will opens a blank comparison until map layers are selected. To compare map layers: 1. Select the Comparison Slider button on the mapping tool bar. 2. Select a Swipe Layer (this is the map layer that will be interactive within the swipe window) from the Swipe Layer drop down list. Page 42 of 109
Figure 7.5.2: Swipe Layer Drop Down 3. Select a Base Layer (this is the map layer that will be used for comparison within the swipe window) from the Base Layer drop down list. Figure 7.5.3: Base Layer Drop Down 4. Select the Load Map button on the slider tool bar. 5. Slide the slider knob right and left to manipulate the slide comparison bar. Figure 7.5.4: Comparison Slider Knob To turn on county or state reference layers toggle the Show Counties Layer or Show States Layer check boxes. Page 43 of 109
Figure 7.5.5: Show Counties Layer or Show States Layer 7.5.1 Enlarge the Map using the Zoom-In button The Zoom-In button is used you enlarge the entire map when you click the button. 1. Click the Zoom-In button. 2. The entire map will be enlarged. 3. Click the Zoom-In button again to enlarge the map further. 4. Continue to click the Zoom-In button until the map is the desired size. 7.5.2 Reduce the Map using the Zoom-Out button The Zoom-Out button reduces the size of the entire map when you click the button. 1. Click the Upper Zoom-Out button. 2. The entire map will be reduced in size. 3. Click the Upper Zoom-Out button again to reduce the map further. 4. Continue to click the Upper Zoom-Out button until the map is the desired size. 7.5.3 View Layer Metadata within the Comparison Slider 1. Click the Information Icon to the left of a Layer Name to view the metadata for the layer. Figure 7.5.3: Layers More Information Button 2. An Information dialog box will open for the selected layer. Page 44 of 109
7.5.4 View Layer Legend within the Comparison Slider 1. Click the Legend Icon to the left of a Layer Name to view the Legend for the layer. Figure 7.5.4: Layer Legend Button 1. Select the to close the tool box windows. 7.6 Time Series Tool The Time Series provides a tool the displays a time elapsed series set of data obtained over a period of time, at regular intervals. This tool uses a time elapsed movie effect to reveal the series of map images. Figure 7.6.1: Time Series Tool Window Note the Time Series window will opens a blank time series map until the map layer is selected. Page 45 of 109
To view time series: 1. Select the Time Series Tool button on the mapping tool bar. 2. Select a Map Layer (this is the map layer that will be used within the time series window) from the Map Layer drop down list. Figure 7.6.2: Map Layer Drop Down 3. Select the Play Button once the map is fully loaded. 4. The map will cycle through the time series intervals. The time intervals being displayed is indicated by the Currently Showing date. Figure 7.6.3: Currently Showing Or the time slider indicator. The time series may also be manually directed with the slider indicator. Figure 7.6.4: Time Slider Indicator Page 46 of 109
5. Select the Previous Button to rewind time series. 6. Select the Next Button to forward time series. 7. Select the Loop Button to loop the time series. To turn on county or state reference layers toggle the Show Counties Layer or Show States Layer check boxes. Figure 7.6.5: Show Counties Layer or Show States Layer 7.5.5 Enlarge the Map using the Zoom-In Button The Zoom-In button is used you enlarge the entire map when you click the button. 1. Click the Zoom-In button. 2. The entire map will be enlarged. 3. Click the Zoom-In button again to enlarge the map further. 4. Continue to click the Zoom-In button until the map is the desired size. 7.5.6 Reduce the Map using the Zoom-Out Button The Zoom-Out button reduces the size of the entire map when you click the button. 1. Click the Upper Zoom-Out button. 2. The entire map will be reduced in size. Page 47 of 109
3. Click the Upper Zoom-Out button again to reduce the map further. 4. Continue to click the Upper Zoom-Out button until the map is the desired size. 7.5.7 View Layer Metadata within the Time Series 1. Click the Information Icon to the left of a Layer Name to view the metadata for the layer. Figure 7.5.7.1: Layers More Information Button 2. An Information dialog box will open for the selected layer. 7.5.8 View Layer Legend within the Time Series 1. Click the Legend Icon to the left of a Layer Name to view the Legend for the layer. Figure 7.5.8: Layer Legend Button 2. Select the to close the tool box windows. 7.6 Find Tool The Find Tool gives users a chance to find map items within the mapping area by searching available layers and features. This aids in finding the information quickly and without navigating around the map. Page 48 of 109
Figure 7.6.1: Find Tool Dialog Box To Find map layer features: 1. Select the Find Tool button on the mapping tool bar. 2. Select a Map Layer that will be searched from the Map Layer drop down list. Figure 7.6.2: Find Tool Dialog Box 3. Additional and selection specific drop down lists will become active and visible. Page 49 of 109
Figure 7.6.3: Find Tool Drop Down Dialog Box The selected reference item will be highlight. The map will also zoom and center to the selected item. 7.5.9 Figure 7.6.4: Find Tool Results Page 50 of 109
7.6 Carbon/Other Identify Tool The Carbon/Other Identify Tool give users a chance to identify map items within the mapping area by picking an area on the map. This aids in pin pointing the information quickly and providing details about the items selected. Figure 7.6.1: Carbon/Other Identify Tool Dialog Box To Carbon Identify map layer features: 1. Select the Carbon/Other Identify Tool button on the left map tool bar. 2. Click on the map where the identify will occur. 3. The identified area will be highlighted and a results dialog box will display. Page 51 of 109
Figure 7.6.2: Carbon Identify Selection The Carbon Identify dialog box is divided into Regional, State, County, and Sub County groupings. 1. Select the Carbon/Other Identify Tool button on the left map tool bar. 2. Click on the map where the identify will occur. 7.5.10 7.7 Identify Tool The Identify Tool gives users a chance to identify map items within the mapping area by picking an area on the map. This aids in pin pointing the information quickly and providing details about the items selected. Page 52 of 109
Figure 7.7.1: Identify Tool Dialog Box To Identify map layer features: Note: To accurately identify map items the layer should be visible (toggled on) in the Layers tool. 1. Select a Map Layer that will be identified from the Map Layer drop down list. Make Map Layer visible 2. Select the Identify Tool button on the left map tool bar. Page 53 of 109
Figure 7.7.2: Identify Steps 3. Select an area on the map. Figure 7.7.3: Identify Select 4. The selected feature will highlight on the map. Page 54 of 109
5. A details window will show details of the selected feature. 6. Select Clear to clear identify results. Figure 7.7.4: Clear Identify Results 7.8 Pie Chart Tool The Pie Chart Tool is a graphical way to organize data. All pie charts compare parts of a whole. A pie chart uses percentages or fractions to compare the data.the Pie Chart Toolcompares Carbon data in a interactive graphical viewing tool. The Pie Chart Tool gives users a chance to identify map items within the mapping area by picking an area on the map. This aids in pin pointing the information quickly and providing details about the items selected. Page 55 of 109
Figure 7.8.1: Pie Chart Tool Dialog Box To Identify map layer features for the Pie Chart: Note: To accurately identify map items the layer should be visible (toggled on) in the Layers tool Page 56 of 109
. 1. Select a Map Layer that will be identified from the Map Layer drop down list. Make Map Layer visible 2. Select the Pie Chart Tool button on the left map tool bar. 3. Select an area on the map. Figure 7.8.3: Pie Chart Select 4. The selected feature will highlight on the map. 5. A details window will show details of the selected feature. Note; The scale of the layer selected will default to a scale where data is available. Page 57 of 109
Figure 7.8.4: Scale of Selected Layer To Change Pie Chart features display scale: 1. Select a Regional, State, County, or Sub-County tab to change scale and data displayed. Page 58 of 109
Figure 7.8.5: Scale of Selected Layer Tab 7.9 Bar Chart Tool The Bar Chart Tool is a graphical way to organize data. All bar charts compare parts of a whole. A bar chart uses percentages or fractions to compare the data.the Bar Chart Tool compares Carbon data in a interactive graphical viewing tool. The Bar Chart Tool gives users a chance to identify map items within the mapping area by picking an area on the map. This aids in pin pointing the information quickly and providing details about the items selected. Page 59 of 109
Figure 7.9.1: Bar Chart Tool Dialog Box To Identify map layer features for the Bar Chart: Note: To accurately identify map items the layer should be visible (toggled on) in the Layers tool. 1. Select a Map Layer that will be identified from the Map Layer drop down list. Make Map Layer visible 2. Select the Bar Chart Tool button on the left map tool bar. 3. Select an area on the map. Page 60 of 109
Figure 7.9.3: Bar Chart Select 4. The selected feature will highlight on the map. 5. A details window will show details of the selected feature. Note; The scale of the layer selected will default to a scale where data is available. Page 61 of 109
Figure 7.9.4: Scale of Selected Layer To Change Bar Chart features display scale: 1. Select a Regional, State, County, or Sub-County tab to change scale and data displayed. Page 62 of 109
Figure 7.9.5: Scale of Selected Layer Tab 7.10 Model/Data Availability Viewer The Model/Data Availability Viewer allows the user to identify areas of the country that have source data or model results available for viewing. The user is able to select multiple source data layers and model scenario result sets. The map updates to show areas that contain all of the selected layers and results, areas that contain some portion of the selected layers and results, and areas that contain none of the selected layers and results. The tool works in reverse, as well, allowing the user to select an area on the map and display available layers and model results for the selected area. 7.10.1 Indentifying Available Data from Availability List 1. Select the Availability Viewer button from the top navigation bar. 2. The Model/Data Availability dialog box will open. Page 63 of 109
Figure 7.10.1.1: Model/Data Availability Dialog 3. Select the Model or Data at the level indicated in the ist. Page 64 of 109
Figure 7.10.1.2: Model/Data Availability Form 4. The outline of the selected data layer will highlight on the map for the available data. Page 65 of 109
Figure 7.10.1.3: Model/Data Availability Outline Note: Layers that are currently on are indicated by a checkmark in the current data column. Figure 7.10.1.4: Currently Viewing Model/Data 5. Select the Model Selection tab to switch list to Model Data. Page 66 of 109
Figure 7.10.1.4: Model Selection Tab 7.10.1 Indentifying Available Data from Map Page 67 of 109
1. Select the Availability button from the left mapping tool bar. 2. A tool draw box will be activated. 3. Draw a shape around the area to be queried. Figure 7.11.1.4: Model/Data Draw Tool 4. The Model/Data Availability dialog box will open. 5. All data that is available for the area drawn on the map is highlighted within the Model Data Availability and Selection list in blue. Page 68 of 109
Figure 7.11.1.2: Model/Data Availability Dialog 5. Select the Model Selection tab to switch list to Model Data. Page 69 of 109
To Clear Selected Map features: Figure 7.11.1.3: Model Selection Tab Page 70 of 109
1. Select the Clear Map button from the left mapping tool bar. 7.11 Carbon Pool Results Tool Carbon models calculate results for various carbon pools. Equivalencies between the differently named pools for each model will need to be determined. A tool to combine designated carbon pools for each data layer will be useful for creating and visualizing comparable data generated from different models. The carbon pool results tool will allow users to indicate layer attributes that should be summed, then add the values for the selected fields, and symbolize a map layer according to the calculate value, The Layers toolbar button, when clicked, opens a new dialog box in the map display. Layers Dialog Box does the following: Figure 7.3.1: Layers Button on Toolbar Toggled on or off map layers within the map display. Set layer Opacity Show layer metadata Show layer legend Page 71 of 109
Figure 7.11.1: Layers Dialog Box 7.11.1 Toggle Carbon Composite Layer on and off 1. Check the box to the right of the Carbon Composite Layer to select the layer to appear on the map. The selected themes and layers will appear in the map display. Page 72 of 109
Figure 7.11.1.1: Composite Layer Visibilty Toggle 2. Select the to close the tool box windows. 7.11.2 Adding/Removing Model Data from the Composite Layer Data used in the Composite Layer is determined by a default carbon pool layers and is controlled through the User Preferences tool. 1. Select the User Preferences button from the top navigation tool bar. Page 73 of 109
2. A User Preference dialog window will open with the default or current Carbon Pool selections indicated with checkmark next to the data layer name. The selected themes and layers will appear in the Carbon Composite Layer. Figure 7.11.2.1: Composite Layer Selected Carbon Pool 3. Select a Scenario Date for the Carbon Pool layer from the Scenario Date Column. Page 74 of 109
Figure 7.11.2.2: Composite Layer Selected Scenario Date 4. Select Set Preferences to Save changes made to the Carbon Pool results. Figure 7.11.2.3: Save Preferences 5. Select Revert to Default to reverse changes made to the Carbon Pool results and return to the default selection. Page 75 of 109
Figure 7.11.2.4: Revert to Default 6. Select Show Carbon Composite Layer to include this Composite Layer in the layers available for Selection on the site. Figure 7.11.2.5: Show Carbon Composite Layer Figure 7.11.2.6: Composite Layer Visibilty Toggle Page 76 of 109
Section 8. Administration Module The Administration Module is used by site Administrators and Managers to perform administrative functions. It can be access by logging into the site as an administrative or manager user. Administrative Functions include: Manager Users Manager Roles Manage Welcome Content Manage links Manage Lookup Tables Managing Model Information Managing Map Layer Information 8.1 Managing Users Users will log in to Carbon Data Visualization Tool with their account. Each user account is unique and holds the basic account details, together with the privileges assigned. Users are members of groups, which simplify the allocation of these permissions and/or privileges. The group s primary purpose is to simplify the maintenance process by reducing the number of entities to be updated, as a change made to a group is applied to all members of the group. Groups represented on the site are: Administrator - The administration account and member of the administrator group have full access rights. Admininistrators can change information displayed on the site and other user roles. Manager The manager account allows the user to manage the GIS layer data represented in the map viewer. Public - This group can be thought of as the default rights as it can be used to apply permissions for everyone. 8.1.1 Managing Users 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Page 77 of 109
Figure 8.1.1.1: Admin Tools Link 3. Select the Manage Users link from the left navigation tool list. Figure 8.1.1.2: Manage Users Link 4. Select the Edit link next to the user to be modified within the User table. The user table may be filtered to aid in locating users. 5. Modify the user information and/or Role from the pick list. Required items are designated with asterisks. Page 78 of 109
Figure 8.1.1.3: Edit User Form 1. Select the Update Account button to save the form data. 8.1.2 Deleting Users 2. Log in as an administrator. 3. Select the Admin Tool link on the site navigation bar. Figure 8.1.2.1: Admin Tools Link 4. Select the Manage Users link from the left navigation tool list. Page 79 of 109
Figure 8.1.2.2: Manage Users Link 5. Select the Delete link next to the user to be modified within the User table. The user table may be filtered to aid in locating users. 8.1.3 Adding a New User 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.1.3.1: Admin Tools Link 3. Select the Manage Users link from the left navigation tool list. Page 80 of 109
Figure 8.1.3.2: Manage Users Link 4. Select the Add New User link below the User table. Figure 8.1.3.3: Add New User Link 5. Complete the user information and/or Role from the pick list. Required items are designated with asterisks. Page 81 of 109
Figure 8.1.3.4: New User Form 6. Select the Update Account button to save the form data. 7. The user will be sent an email message containing their account information and prompting them to change their password. Note: Passwords must be a minimum of 7 characters in length and contain at least 1 special character. Page 82 of 109
8.1.4 Changing User Password 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.1.4.1: Admin Tools Link 3. Select the Manage Users link from the left navigation tool list. Figure 8.1.4.2: Manage Users Link 4. Select the Add New User link below the User table. Figure 8.1.4.3: Add New User Link Page 83 of 109
5. Select the Change Password link next to the user to be modified within the User table. The user table may be filtered to aid in locating users. Figure 8.1.4.4: Change User Password Form 6. Select the Update Password button to save the form data. 7. The user will be sent an email message containing their new password. Note: Passwords must be a minimum of 7 characters in length and contain at least 1 special character. 8.1.5 Filtering the User Table 1. Select the User Role pick list to filter the table per the option selected. Figure 8.1.5.1: User Role Filter Page 84 of 109
2. The table will filter data per the selected option. 3. Select (All) to remove filter. 8.2 Managing Roles Users will log in to Carbon Data Visualization Tool with their account. Each user account is unique and holds the basic account details, together with the privileges assigned. Users are members of groups, which simplify the allocation of these permissions and/or privileges. The group s primary purpose is to simplify the maintenance process by reducing the number of entities to be updated, as a change made to a group is applied to all members of the group. Groups are assigned roles which determine which tools and layers the groups will have access to on the Carbon Data Visualization Site. 8.2.1 Managing Tool Roles 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.2.1.1: Admin Tools Link 3. Select the Manage Roles link from the left navigation tool list. Page 85 of 109
Figure 8.2.1.2: Manage Roles Link 4. Select the Access Type Tools from the access type pick list. Figure 8.2.1.3: Access Type Option 5. Select the User Role that will be modified. Figure 8.2.1.3: User Role Option 6. Select the Edit button to begin editing the roles. Note: the Roles options will disable until the Edit button is selected. 7. Select the Access or No Access radio buttons to add or remove tools for the selected Role. Page 86 of 109
Figure 8.2.1.4: User Role Option 8. Select the OK button to begin save the edits. 9. Select the Reset button to begin revert all changes to the default selection. 10. Select the Cancel button to cancel all edits. 8.2.2 Managing Layers Roles 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.2.2.1: Admin Tools Link 3. Select the Manage Roles link from the left navigation tool list. Page 87 of 109
Figure 8.2.2.2: Manage Roles Link 4. Select the Access Type Layers from the access type pick list. Figure 8.2.2.3: Access Type Option 5. Select the User Role that will be modified. Figure 8.2.2.4: User Role Option 6. Select the Edit button to begin editing the roles. Note: the Roles options will disable until the Edit button is selected. 7. Select the Access or No Access radio buttons to add or remove tools for the selected Role. Page 88 of 109
Figure 8.2.2.5: User Layer Option 8. Select the OK button to begin save the edits. 9. Select the Reset button to begin revert all changes to the default selection. 10. Select the Cancel button to cancel all edits. 8.3 Managing Welcome Page Content Administrators have access to modify the home page content. This web control provides you with the ability to maintain the content of your website pages without the need for using any client software or heavyweight server side content management system. 1. Log in to the Carbon Data Visualization Tool using an Administrative account. 2. Click Welcome on the navigation bar. You will see a page like this on the below: Page 89 of 109
Figure 8.3.1: Home Page Editable Sections 8.3.1 Managing Contacts Content 1. Select the Admin Tool link on the site navigation bar. Figure 8.3.1.1: Admin Tools Link 2. Select the Manage Welcome Content link from the left navigation tool list. Page 90 of 109
Figure 8.3.1.1: Manage Welcome Content Link 3. Select the Message Type Contacts that will be modified. Figure 8.3.1.2: Message Type Option 4. The editor tool works similar to more common text editors such as Microsoft s Word. Page 91 of 109
Figure 8.3.1.3: Content Editor 5. Select the Update Message button to begin editing the roles. 6. Select the Cancel button to cancel all edits. 7. Returning to the Welcome page will show the changes made within the content editor piece. 8.3.2 Managing Welcome Message for Authenticated Users 1. Select the Admin Tool link on the site navigation bar. Page 92 of 109
Figure 8.3.2.1: Admin Tools Link 2. Select the Manage Welcome Content link from the left navigation tool list. Figure 8.3.2.2: Manage Welcome Content Link 3. Select the Message Type Welcome Message for Authenticated Users that will be modified. Figure 8.3.2.3: Message Type Option 4. The editor tool works similar to more common text editors such as Microsoft s Word. Page 93 of 109
Figure 8.3.2.4: Content Editor 5. Select the Update Message button to begin editing the roles. 6. Select the Cancel button to cancel all edits. 7. Returning to the Welcome page will show the changes made within the content editor piece. 8.3.3 Managing Welcome Message for Non-Authenticated Users 1. Select the Admin Tool link on the site navigation bar. Page 94 of 109
Figure 8.3.3.1: Admin Tools Link 2. Select the Manage Welcome Content link from the left navigation tool list. Figure 8.3.3.2: Manage Welcome Content Link 3. Select the Message Type Welcome Message for Non-Authenticated Users that will be modified. Figure 8.3.3.3: Message Type Option 4. The editor tool works similar to more common text editors such as Microsoft s Word. Page 95 of 109
Figure 8.3.3.4: Content Editor 5. Select the Update Message button to begin editing the roles. 6. Select the Cancel button to cancel all edits. 7. Returning to the Welcome page will show the changes made within the content editor piece. 8.4 Managing Links Administrators have access to modify the home page links. This web control provides you with the ability to maintain the content of your website pages without the need for using any client software or heavyweight server side content management system. Page 96 of 109
8.4.1 Editing Links 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.4.1.1: Admin Tools Link 3. Select the Manage Links link from the left navigation tool list. Figure 8.4.1.2: Manage Roles Link 4. Select the Access Type Tools from the access type pick list. Figure 8.4.1.3: Link Type Option 5. Select the Edit icon associate with the Link. Page 97 of 109
Figure 8.4.1.4: Edit Link Icon 6. Edit the Link Form fields. Figure 8.4.1.5: Edit Link Form 7. Select the Update Link button to save all changes to the Link. 8. Select the Cancel button to cancel all edits. 8.4.2 Deleting Links 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Page 98 of 109
Figure 8.4.2.1: Admin Tools Link 3. Select the Manage Links link from the left navigation tool list. Figure 8.4.2.2: Manage Roles Link 4. Select the Access Type Tools from the access type pick list. Figure 8.4.2.3: Link Type Option 5. Select the Delete icon associate with the Link. Figure 8.4.2.4: Delete Link Icon 6. Confirm the deletion by selecting OK. Page 99 of 109
8.4.3 Adding Links 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.4.3.1: Admin Tools Link 3. Select the Manage Links link from the left navigation tool list. Figure 8.4.3.2: Manage Roles Link 4. Select the Access Type Tools from the access type pick list. Page 100 of 109
Figure 8.4.3.3: Link Type Option 5. Select the Add New Link button below the Link list. Figure 8.4.3.4: Add New Link Button 6. Complete the Link Form fields. Figure 8.4.3.5: Add New Link Button Page 101 of 109
7. Select the Create Link button to save all changes to the Link. 8. Select the Cancel button to cancel all edits. 8.5 Managing Lookup Tables Administrators have access to modify the Lookup Tables used within the site. This web control provides you with the ability to maintain the content of your website pages without the need for using any client software or heavyweight server side content management system. 8.5.1 Editing Lookup Tables 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.5.1.1: Admin Tools Link 3. Select the Manage Lookup Tables link from the left navigation tool list. Figure 8.5.1.2: Manage Lookup Table Link 4. Select the Lookup Table Type from the access type pick list. Page 102 of 109
Figure 8.5.1.3: Lookup Table Type Option 5. Select the Edit icon associate with the Lookup Item. Figure 8.5.1.4: Edit Lookup Icon 6. Edit the Lookup Table Form fields. Figure 8.5.1.5: Edit Link Icon 7. Select the Update Lookup Item button to save all changes to the Lookup Item. 8. Select the Cancel button to cancel all edits. 8.5.2 Deleting Lookup Table Item 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Page 103 of 109
Figure 8.5.2.1: Admin Tools Link 3. Select the Manage Links link from the left navigation tool list. Figure 8.5.2.2: Manage Roles Link 4. Select the Lookup Table Type from the access type pick list. Figure 8.5.2.3: Lookup Type Option 5. Select the Delete icon associate with the Link. Figure 8.5.2.4: Delete Lookup Table Icon Page 104 of 109
6. Confirm the deletion by selecting OK. 8.5.3 Adding Lookup Item 1. Log in as an administrator. 2. Select the Admin Tool link on the site navigation bar. Figure 8.5.3.1: Admin Tools Link 3. Select the Manage Lookup Tables link from the left navigation tool list. Figure 8.5.3.2: Manage Lookup Table Link Page 105 of 109
4. Select the Lookup Table item from the access type pick list. Figure 8.5.3.3: Lookup Table Type Option 5. Select the Add New Item Link button below the Lookup Table list. Figure 8.5.3.4: Add New Item Button 6. Complete the Lookup Table Form fields. Figure 8.5.3.5: Add New Lookup Item Form 7. Select the Create Lookup Item button to save all changes to the Link. 8. Select the Cancel button to cancel all edits. Page 106 of 109