Difference between revisions of "GAP Help"

Latest revision as of 15:36, 6 August 2018

The Groundwater Assessment Platform (GAP; www.gapmaps.org) hosts information on geogenic contamination of groundwater by arsenic and fluoride. It provides the possibility to share data, case studies and field experiences as well as to interact with other users and create probabilistic maps for any area on the globe. The site has two main sections (Figure 1). In GAP Maps, you can display and print existing data and models as well as manipulate and model your own data and create hazard maps. The GAP Wiki contains diverse information on geogenic contamination.

The Help section provides instructions for using the GAP Maps section.

Viewing geospatial data (without registration)

All of the publicly available maps and data can be viewed and printed without registering on the site.

Click on to open a list of all available layers. Click on to print the currently viewed map as a PDF.

In case you have questions or require help while using the site, you can click on Help in the top bar to open the help page, which explains all of the features of GAP Maps. Alternatively, click the question mark in the upper-right corner of any window to open the help page relevant to that window.

In order to access the full functionality of GAP, you must first register as a user.

Viewing geospatial data and developing models (with registration)

To be able to upload your own data and create models, you must register or log in in the upper-right of the screen. This makes the full functionality of the site available.

The main functions of GAP Maps contained in the toolbar (1) on the left side of the screen. These functions are explained in detail in the sections: Layer list, My Layers, Statistical Analysis, Community and Print.

Additional map tools are located in the upper-right of the screen (2): Base Layers, Get point information and Zoom in/out

Register

Click Register in the upper-right of the screen to create a new account using your e-mail address. You must confirm that you are in full agreement with the 'Terms of Use' in order to complete the registration.

Layer list

Layer list

The Layer list tab lists the Active Layers as well as all available layers, which are grouped into the categories GAP layers, Publicly shared layers and Shared layers.

Active Layers lists the layers that have been added to the map. The layers can be turned on or off by clicking the layer name. Hovering the mouse over the layer name opens a popup window containing the layer legend and a slider bar to adjust the layer's opacity as well as buttons to move the position of a layer up or down, zoom to its extent or remove it

GAP layers contains GAP prediction maps and data points as well as environmental datasets, such as geology, climate and soil, made publicly available from other sources.

Publicly shared layers lists those layers that GAP users have shared publicly.

Shared layers lists those layers that have been shared personally with you, either directly from another user or as part of a community.

There are three data types: Coverage, Polygon and Point. To add a layer to the map, click the layer name. Click next to a layer to display its source and a description of the data.

Data Types
Data type	Icon
Coverage
Polygon
Point

My Layers

The My Layers window lists all layers uploaded by the user. It also includes functions to add, remove, share, display, download and manipulate the symbology of layers.

A tutorial on this part of the site is available in the video below.

Add

Functionality for uploading geospatial data layers to the map. Click here for detailed instructions.

Remove

To remove a layer, select it in the table and click Remove.

Share

Functionality to share/unshare a layer with an individual user, a community or all users (Public). Click here for a detailed information.

Display

To display a layer (add layer to map), either double-click the layer name in the table, or select layer in the table and click Display.

Symbology

Functionality for changing a layer's symbology. Click here for detailed instructions.

Download

Click Download to save a copy of a layer as a GIS-compatible shapefile or tif.

Rename

Click Rename to change the name of one of your layers.

Statistical Analysis

The Statistical Analysis section provides functionality for developing statistical models and probability maps. Click here for detailed information.

Community

Community (left) and <b>Community Layers (right)

The Communities window lists the communities to which a user belongs.

The Create button opens a window to create a new community. You must enter a name for the community and optionally a topic or description.

The Remove button removes the selected community, which is possible only if you have administrative rights.

The Layers button opens a window that lists all community layers according to community. Double-click a layer to add it to the map.

The Members button allows you to add and remove members by e-mail address and change their administrative rights.

The Messages button allows you to send and view messages for the community.

With the Edit button, you can change the name, topic and description of a community to which you have administrative rights.

Manage Account

Manage Account lets you change your password / login preference or delete your account.

Print

Click to print the displayed map as a PDF. Assign a map title and select the page layout (portrait or landscape) and resolution (DPI). Note that if the background map is displayed, the resolution of the printed map will be limited to 90 DPI. Click Submit when finished.

Base Layers

Base Layers are accessed by clicking the icon in the upper right. Five different base maps are offered: Bing Roads, Bing Aerial, Google Maps, Open Street Maps and a Country borders.

Get point information

Click on to access the Get point information tool, which allows you to find the values of all active layers at a point.

Zoom in/out

Click to zoom in or to zoom out. Alternatively, you can zoom the map in or out with the scroll wheel of your mouse.

Help

Click for content-specific help.

@@ Line 1: / Line 1: @@
-==Step 1: Viewing available geospatial information==
+The Groundwater Assessment Platform (GAP; [http://www.gapmaps.org <b>www.gapmaps.org</b>)] hosts information on geogenic contamination of groundwater by arsenic and fluoride. It provides the possibility to share data, case studies and field experiences as well as to interact with other users and create probabilistic maps for any area on the globe. The site has ''two main sections'' (Figure 1). In '''GAP Maps''', you can display and print existing data and models as well as manipulate and model your own data and create hazard maps. The '''GAP Wiki''' contains diverse information on geogenic contamination.
+The '''Help''' section provides instructions for using the GAP Maps section.
+[[File:New_startpage_800.png | right|<b>Figure 1:</b> Entry page]]
+__TOC__
-[[File:fig 1.jpeg|thumb|alt=Main Page|Main Page|800px|center|Figure 1: Entry page]]
+<br clear=all>
+==Viewing geospatial data (without registration)==
-==[[File:data_public.png]] GAP Database==
+All of the publicly available maps and data can be viewed and printed without registering on the site.
-Here all available GAP Layers (categorized based on geology, climate, soil, etc) are listed as depicted in Figure 3. There are 3 data types, "coverage", "polaygon" and "point".
-To add a layer to the map, double click on the layer name. To see the layer Information (source and description), press [[File:info.png]] next to the layer.
+Click on [[File:new_data_public.png|link=GAP_Help#GAP Database]] to open a list of all available [[GAP_Help#Layers|<b>layers</b>]]. Click on [[File:new_print.png|link=GAP_Help#Print]] to [[GAP_Help#Print|<b>print</b>]] the currently viewed map as a PDF.
-[[File:public_data_layers.jpg|thumb|alt=Available Layers|Available Layers|800px|center|Figure 3: Available Layers]]
+In case you have questions or require help while using the site, you can click on <b>Help</b> in the top bar to open the help page, which explains all of the features of GAP Maps. Alternatively, click the question mark [[File:new_question.png]] in the upper-right corner of any window to open the help page relevant to that window.
-{| class="wikitable" style="margin-left:50%;"
+In order to access the full functionality of GAP, you must first [[GAP_Help#Register|<b>register</b>]] as a user.
-|+ Table 1: Data Types
+[[File:new_gapmaps_notloggedin2_800.png|alt=Main Page|Main Page|left|<b>Figure 2:</b> Main Page ''GAP Maps'']]
+<br clear=all>
+==Viewing geospatial data and developing models (with registration)==
+To be able to upload your own data and create models, you must [[GAP_Help#Register|<b>register</b>]] or <b>log in</b> in the upper-right of the screen. This makes the full functionality of the site available.
+The main functions of GAP Maps contained in the toolbar (1) on the left side of the screen. These functions are explained in detail in the sections: [[GAP_Help#Layer list|<b>Layer list</b>]], [[GAP_Help#My Layers|<b>My Layers</b>]], [[GAP_Help#Statistical Analysis|<b>Statistical Analysis</b>]], [[GAP_Help#Community|<b>Community</b>]] and [[GAP_Help#Print|<b>Print</b>]].
+Additional map tools are located in the upper-right of the screen (2): [[GAP_Help#Base Layers|<b>Base Layers</b>]], [[GAP_Help#Get point information|<b>Get point information</b>]] and [[GAP_Help#Zoom in/out|<b>Zoom in/out</b>]]
+[[File:new_Main_Page_1079.png|alt=Main Page|Main Page|left|<b>Main Page</b>]]
+<br clear=all>
+==Register==
+Click <b>Register</b> in the upper-right of the screen to create a new account using your e-mail address. You must confirm that you are in full agreement with the 'Terms of Use' in order to complete the registration.
+[[File:new_register_800-70.png|alt=Register|Register|left|<b>Register</b>]]
+<br clear=all>
+==[[File:new_data_public.png]] Layer list==
+[[File:layer_list_popup_275.png|left|frame|<b>Layer list</b>]]
+The <b>Layer list</b> tab lists the <b>Active Layers</b> as well as all available layers, which are grouped into the categories <b>GAP layers</b>, <b>Publicly shared layers</b> and <b>Shared layers</b>.
+<b>Active Layers</b> lists the layers that have been added to the map. The layers can be turned on or off by clicking the layer name. Hovering the mouse over the layer name opens a popup window containing the layer legend and a slider bar to adjust the layer's opacity as well as buttons to move the position of a layer up or down, zoom to its extent or remove it
+<b>GAP layers</b> contains GAP prediction maps and data points as well as environmental datasets, such as geology, climate and soil, made publicly available from other sources.
+<b>Publicly shared layers</b> lists those layers that GAP users have shared publicly.
+<b>Shared layers</b> lists those layers that have been shared personally with you, either directly from another user or as part of a community.
+There are three data types: <b>Coverage</b>, <b>Polygon</b> and <b>Point</b>. To add a layer to the map, click the layer name. Click [[File:new_info.png]] next to a layer to display its source and a description of the data.
+{| class="wikitable" style="margin-bottom:0%;"
+|+ Data Types
 |-
-! scope="col"| Data Type
+! scope="col"| Data type
 ! scope="col"| Icon
@@ Line 30: / Line 76: @@
 ! scope="row"|Point
 | [[File:bullet_blue.png]]
 |}
+<br clear=all>
-==Map Layers Panel==
+==[[File:my_layers_icon.png]] My Layers==
+The <b>My Layers</b> window lists all layers uploaded by the user. It also includes functions to add, remove, share, display, download and manipulate the symbology of layers.
-The Map Layers panel lists all layers that have been added to the map previously. By right-clicking on the layers you can rearrange layers, remove layers and zoom to the extent of a certain layer (Figure 2)
+A tutorial on this part of the site is available in the video below.
-{| class="wikitable"
+[[File:new_my_layers_90.png|alt=My Layers|My Layers|left|<b>My Layers</b>]]
-|Figure 2: Map Layers panel collapsed (left), Map Layers panel expanded (center) and Tools (right).
-|[[image:MapLayers.JPG|left|200px|Map Layers Panel, collapsed version]]
-|[[image:MapLayersTools.PNG|center|200px|Map Layers Panel, expanded version]]
-|[[image:MapLayerTools.PNG|right|200px|Map layers panel tools]]
-|}
+===[[Add Layer|Add]]===
+Functionality for uploading geospatial data layers to the map. Click [[Add Layer|<b>here</b>]] for detailed instructions.
+===Remove===
+To remove a layer, select it in the table and click <b>Remove</b>.
-==[[File:print.png]] Print Map==
+===[[Share Layer|Share]]===
+Functionality to share/unshare a layer with an individual user, a community or all users (Public). Click [[Share Layer|<b>here</b>]] for a detailed information.
-This function first has to be finished with openstreetmaps!
+===Display===
+To display a layer (add layer to map), either double-click the layer name in the table, or select layer in the table and click <b>Display</b>.
+===[[Layer Symbology|Symbology]]===
+Functionality for changing a layer's symbology. Click [[Layer Symbology|<b>here</b>]] for detailed instructions.
+===Download===
+Click <b>Download</b> to save a copy of a layer as a GIS-compatible shapefile or tif.
+===Rename===
+Click <b>Rename</b> to change the name of one of your layers.
+<br clear=all>
+{{#evt:
+service=youtube
+|id=https://youtu.be/oQJyVD9RIgA
+}}
+<br clear=all>
+==[[File:statistical_analysis_icon.png]] [[Statistical Analysis|Statistical Analysis]]==
+The Statistical Analysis section provides functionality for developing statistical models and probability maps. Click [[Statistical_Analysis|<b>here</b>]] for detailed information.
+<br clear=all>
+==[[File:community_icon.png]] Community==
+[[File:new_community2_75pourcent.png|alt=Communities|left|Communities|frame|<b>Community (left) and <b>Community Layers (right)</b>]]
+The Communities window lists the communities to which a user belongs.
+The <b>Create</b> button opens a window to create a new community. You must enter a name for the community and optionally a topic or description.
+The <b>Remove</b> button removes the selected community, which is possible only if you have administrative rights.
+The <b>Layers</b> button opens a window that lists all community layers according to community. Double-click a layer to add it to the map.
+The <b>Members</b> button allows you to add and remove members by e-mail address and change their administrative rights.
-The main features of the GAP Map are indicated in Figure 1. To be able to upload your own data and set up models you will need to [[Gap_tools#Register|<b>Register</b>]] or <b>Login</b> (1).
+The <b>Messages</b> button allows you to send and view messages for the community.
-In case you require any help on the site you can always click <b>Help</b> in the top bar which will direct you to the Help page where all parts of the site are explained.
+With the <b>Edit</b> button, you can change the name, topic and description of a community to which you have administrative rights.
-When you click on the Toolbar (3), the different features of the site appear (see inset in Figure 1). The different sections are explained in detail on the following sites: [[Gap_tools#GAP Database|<b>Public Layers</b>]], [[Gap_tools#Private Data|<b>Private Layers (or My layers)</b>]], [[Gap_tools#Statistical Modelling|<b>Statistical Analysis</b>]], [[Gap_tools#Community Data|<b>Manage Communities</b>]], [[Gap_tools#Manage your Account|<b>Manage your Account</b>]], [[Gap_tools#Print Map|<b>Print Map</b>]].
+<br clear=all>
-The box <b>Map Layers (4)</b> will always show you all layers you have currently selected. You can change opacity and view the legend here. <b>Layers (5)</b> provides you an overview of all available layers.
+==[[File:manage_account_icon.png]] Manage Account==
-In the lower right corner (6) you find the zoom function as well as the <b>Info Cursor</b> which lets you identify the data of a certain pixel.
+Manage Account [[File:manage_account_icon.png]] lets you change your password / login preference or delete your account.
-Clicking [[File:question.png]] anywhere on the page will always direct you to the corresponding Help site.
+<br clear=all>
-[[File:MainPage.png|thumb|alt=Main Page|Main Page|800px|center|Figure 1: Main Page]]
+==[[File:new_print.png]] Print==
-==Register==
+Click [[File:new_print.png]] to print the displayed map as a PDF. Assign a map title and select the page layout (portrait or landscape) and resolution (DPI). Note that if the background map is displayed, the resolution of the printed map will be limited to 90 DPI. Click '''Submit''' when finished.
-You can add a new account with your email address. Make sure to read the 'Legal notice and disclaimer' before you click on <b>Register</b>.
+[[File:new_printing_800.png|alt=Print|Print|left|<b>Printing</b>]]
-==[[File:data_private.png]] Private Data==
+<br clear=all>
-The window <b>My Layers</b> shows all layers uploaded by the user. Additionally it includes functions to [[Gap_tools#Add Layer (upload layer)|<b>add</b>]], [[Gap_tools#Remove Layer|<b>remove</b>]], share, visualize and manipulate the symbology of layers.
-[[File:UserDataTable.JPG|thumb|alt=Private Layers|My Layers|300px|center|Figure 4: My Layers]]
+==Base Layers==
-===[[Add Layer|Add Layer (upload layer)]]===
+Base Layers are accessed by clicking the [[File:base_layers_icon_60.png]] icon in the upper right. Five different base maps are offered: Bing Roads, Bing Aerial, Google Maps, Open Street Maps and a Country borders.
-Provides functions (tools) for uploading spatial layers (data). Click [[Add Layer|<b>here</b>]] to get to the site describing all necessary details.
-===Remove Layer===
-To remove a layer, select it in the table and click <b>Remove</b>.
-===[[Share Layer|Share Layer]]===
+[[File:new_base_layers2_60.png|alt=Base layers |left|<b>Base layers</b>]]
-Provides tools to share/un-share a layer publicly and/or with an individual user or a community. Click [[Share Layer|<b>here</b>]] to get to the site describing all necessary details.
-===Visualize Layer===
+<br clear=all>
-To visualize a layer (add layer to map) either double click on the layer name in the table, or select layer in the table and click <b>Visualize</b>.
-===[[Layer Symbology|Layer Symbology (style)]]===
+==Get point information==
-Provides functions (tools) for changing the layer symbology. Click [[Layer Symbology|<b>here</b>]] to get to the site describing all necessary details.
-==[[File:Sum.png]] [[Statistical Analysis|Statistical Analysis]]==
+Click on [[File:get_point_info_icon.png]] to access the <b>Get point information</b> tool, which allows you to find the values of all active layers at a point.
-The Statistical Analysis section provides tools and functions for developing statistical models and probability maps. Click [[Statistical Modelling|<b>here</b>]] for detailed information.
-==[[File:users_relation.png]] Community Data==
+[[File:get_point_info2_60.png|alt=Get point information |left|<b>Get point information</b>]]
-The Community window lists all communities of which the user is a member. The layers are categorized by community names. Clicking <b>Create</b> will open a window where you can initiate a new community. Selecting one community and clicking <b>Remove</b> will remove the community. This is only possible if you have administrator rights. You can see the details on user rights by clicking <b>Details</b> and if you have administrator rights change details by clicking <b>Edit</b>. When you click <b>Layers</b> a separate window will open that lists all communities you are part of and the respective layers that are accesible to this community. You can such a layer to the map by double clicking on the layer name.
-[[File:Communities.png|thumb|alt=Communities|Communities|500px|center|Figure 5: Communities (left) and Community Layers (right)]]
+<br clear=all>
-==[[File:User_monitor.png]] Manage your Account==
+==Zoom in/out==
-This site first has to be finished!
+Click [[File:zoom_in_icon.png]] to zoom in or [[File:zoom_out_icon.png]] to zoom out. Alternatively, you can zoom the map in or out with the scroll wheel of your mouse.
-==[[File:print.png]] Print Map==
+<br clear=all>
-This function first has to be finished with openstreetmaps!
+== [[File:new_question.png]] Help==
+Click [[File:new_question.png]] for content-specific help.
-== [[File:question.png]] Help==
+<br clear=all>
-To get help througout the site press [[File:question.png]].