{"id":3251,"date":"2015-10-19T16:44:04","date_gmt":"2015-10-19T15:44:04","guid":{"rendered":"http:\/\/help.instantatlas.com\/report-builder-agol\/?page_id=3251"},"modified":"2024-06-03T14:16:55","modified_gmt":"2024-06-03T13:16:55","slug":"comparison-areas","status":"publish","type":"page","link":"https:\/\/help.reports.esriuk.com\/report-builder\/comparison-areas\/","title":{"rendered":"Comparison Areas"},"content":{"rendered":"<h4><strong>Overview<\/strong><\/h4>\n<p>Comparison data are usually regional or national averages of your indicators which you would like to display in your report. You can display comparison areas in table and chart widgets or show their values in text widgets by using <a href=\"https:\/\/help.instantatlas.com\/report-builder-agol\/agol-2\/widgets\/variables\/\" rel=\"noopener noreferrer\">variables<\/a>.<\/p>\n<p>It is currently only possible to add comparison areas when you use a CSV file or an <a href=\"https:\/\/help.instantatlas.com\/instantatlas-data-catalog\/\" target=\"_blank\" rel=\"noopener\">InstantAtlas Data Catalog<\/a> as your data source.<\/p>\n<p><!--You can add comparison areas via your feature service, CSV file or Table in ArcGIS Online. Please note that while you can use multiple sources of data together in a report, comparison data will always depend on the currently selected indicator. Comparison values will thus be taken from the same source as the indicator (e.g. a CSV file) if available and will be displayed as 'no data' if undefined.\n\n\n<h4><strong>Adding comparison areas via the feature service<\/strong><\/h4>\n\n\n\n\n<ul>\n \t\n\n<li>Add an additional row to your feature service for each comparison area you want to display in your report. You will probably have to do this in your source data before you make it a feature service.\u00a0 It is easy to add additional rows to a shapefile using ArcGIS Desktop.<\/li>\n\n\n \t\n\n<li>The additional rows should not have any geometry associated with them.<\/li>\n\n\n \t\n\n<li>For each additional row populate it with the relevant comparison data in each data field.<\/li>\n\n\n \t\n\n<li>In your ID field give it an ID beginning with '#', e.g. #US. This tells Report Builder to treat it as comparison data. Note if you don't have a suitable ID column you will need to create one.<\/li>\n\n\n \t\n\n<li>Fill in your name field with a relevant description for your comparison area.<\/li>\n\n\n<\/ul>\n\n\n[caption id=\"attachment_591\" align=\"alignnone\" width=\"1065\"]<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/comparison.png\"><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-591 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/comparison.png\" alt=\"comparison\" width=\"1065\" height=\"778\" \/><\/a> Example of a feature layer with one additional row added for US comparison data[\/caption]\n\n&nbsp;\n\nYou will need to make sure you switch the Feature ID field from the default of 'FID' to the field that holds your features and comparison areas ID codes with '#'. You can change this in the Report Properties\u00a0dialog (in the Report Design Page select the cogwheels icon at the top left hand side to open up the Report Settings tab\u00a0and then click on Properties).--><\/p>\n<h4><strong>How to set up comparison areas when using a CSV file<!--\/ ArcGIS Online table--><br \/>\n<\/strong><\/h4>\n<p>The first two columns of the CSV file <!--\/ table--> are where you set the IDs and Names for the comparison areas. In a CSV file,<\/p>\n<ol>\n<li>define a header for the first column. You can set the header to be identical to the feature service field you use as the report Feature ID (set this in Report Settings &gt; Properties). Report Builder will use this common field to create a link between the feature service and the CSV file.<br \/>\n<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_FidHeader.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-10461 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_FidHeader.png\" alt=\"CSV Feature ID field header\" width=\"259\" height=\"143\" \/><\/a><\/li>\n<\/ol>\n<ol start=\"2\">\n<li>Copy <strong>all<\/strong> records of the Feature ID field from the feature service table to the first column of the CSV file<!--\/ table-->. Here the feature service only contains 3 features, their feature ids are \u2018EH11\u2019, \u2018EH12\u2019 and \u2018EH13\u2019.<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_Fid.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-10471 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_Fid.png\" alt=\"CSV feature ID field with geography features\" width=\"161\" height=\"150\" \/><\/a><\/li>\n<\/ol>\n<ol start=\"3\">\n<li>Specify the comparison area IDs in the first column below the feature service feature IDs. The IDs must be given a prefix of \u2018#\u2019 (e.g. #001 or #UK) to distinguish them from the feature service features. Here there are two comparison areas: the City of Edinburgh and Scotland with \u2018#Edinburgh\u2019 and \u2018#Scotland\u2019 as their IDs.<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_CompFid.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-10481 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_CompFid.png\" alt=\"CSV feature ID field with comparison areas\" width=\"144\" height=\"171\" \/><\/a><\/li>\n<\/ol>\n<ol start=\"4\">\n<li>Now specify the header of the second column. The header name must be identical to the feature service field you use as the report Feature Name (set this in Report Settings &gt; Properties).<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_FnameHeader.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-10491 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_FnameHeader.png\" alt=\"CSV feature name field header\" width=\"253\" height=\"183\" \/><\/a><\/li>\n<\/ol>\n<ol start=\"5\">\n<li>Add the names of the comparison areas on the second column. Note you do not need to specify the names for the features from the feature service in the CSV file<!--\/ table--> as Report Builder will take the information from the feature service itself.<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_Fname.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-10511 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_Fname.png\" alt=\"CSV feature name field with comparison areas\" width=\"266\" height=\"173\" \/><\/a><\/li>\n<\/ol>\n<ol start=\"6\">\n<li>Once you have set up the first two columns, you can then add the indicators starting from the third column. Note that each indicator set in Report Builder can only retrieve information from one data source, e.g. it is not possible for an indicator \u2018Population 2015\u2019 to retrieve field data from a feature service for your geography features and then retrieve field data from a CSV file<!--\/ table--> for your comparison areas. Therefore the indicator values for all geography features must be included in conjunction with the values for comparison areas.<a href=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_data.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-10521 size-full\" src=\"https:\/\/help.instantatlas.com\/dashboard-builder\/wp-content\/uploads\/sites\/11\/2015\/06\/RB_CompAreaCSV_data.png\" alt=\"CSV indicators for geography features and comparison areas\" width=\"542\" height=\"167\" \/><\/a><\/li>\n<\/ol>\n<ol start=\"7\">\n<li>Once you have finished with setting up all the data for the comparison areas in the CSV file<!--\/ table-->, please refer to the <a href=\"https:\/\/help.instantatlas.com\/report-builder-agol\/agol\/data\/csv-data\/\" rel=\"noopener noreferrer\">CSV<!--\/ Table--> Data section<\/a> of the Report Builder help pages to link the CSV file to the report. You will be able to display indicator values for comparison areas in a range of widgets.<\/li>\n<\/ol>\n<p>Note you can combine CSV files<!--\/ tables--> which contain comparison areas with ones which do not contain any comparison areas. However, any CSV files<!--\/ tables--> that do contain comparison areas must contain the exact same comparison areas. Even if you do not have data for all of them you still have to add them and leave the data cells blank.<\/p>\n<p>&nbsp;<\/p>\n<h4><strong>Using comparison areas with an InstantAtlas Data Catalog<br \/>\n<\/strong><\/h4>\n<p>If the source of data for your report is an <a href=\"https:\/\/help.instantatlas.com\/report-builder-agol\/data-catalog\/\" target=\"_blank\" rel=\"noopener noreferrer\">InstantAtlas data catalog<\/a>, the core feature layer item in ArcGIS Online must have the following tag for the comparison areas list to be visible when editing the report widgets:<\/p>\n<p><i>ia-item-type=CatalogFeatureService<\/i><\/p>\n<p>The available comparison areas will be defined by the <a href=\"https:\/\/help.instantatlas.com\/instantatlas-data-catalog\/advanced-topics\/comparison-areas-and-relationships\/\" target=\"_blank\" rel=\"noopener noreferrer\">relationship classes<\/a> in the feature services belonging to the data catalog.<\/p>\n<p>NB Following any update to the core feature layer, check that the above tag is still applied. If the tag has been removed, comparisons shall no longer display in widgets if they are edited following the layer update.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview Comparison data are usually regional or national averages of your indicators which you would like to display in your report. You can display comparison areas in table and chart widgets or show their values in text widgets by using variables. It is currently only possible to add comparison areas when you use a CSV [&hellip;]<\/p>\n","protected":false},"author":22,"featured_media":0,"parent":0,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-3251","page","type-page","status-publish","hentry","entry"],"_links":{"self":[{"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/pages\/3251","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/users\/22"}],"replies":[{"embeddable":true,"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/comments?post=3251"}],"version-history":[{"count":0,"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/pages\/3251\/revisions"}],"wp:attachment":[{"href":"https:\/\/help.reports.esriuk.com\/report-builder\/wp-json\/wp\/v2\/media?parent=3251"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}