{"id":588722,"date":"2023-05-26T19:07:46","date_gmt":"2023-05-27T02:07:46","guid":{"rendered":"https:\/\/www.esri.com\/about\/newsroom\/?post_type=arcuser&#038;p=588722"},"modified":"2023-05-26T19:07:46","modified_gmt":"2023-05-27T02:07:46","slug":"fieldescriptions","status":"publish","type":"arcuser","link":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions","title":{"rendered":"High-Quality Field Descriptions Make Mapping Easier"},"author":1031,"featured_media":0,"menu_order":0,"template":"","format":"standard","meta":{"_acf_changed":false,"sync_status":"","episode_type":"","audio_file":"","podmotor_file_id":"","podmotor_episode_id":"","castos_file_data":"","cover_image":"","cover_image_id":"","duration":"","filesize":"","filesize_raw":"","date_recorded":"","explicit":"","block":"","itunes_episode_number":"","itunes_title":"","itunes_season_number":"","itunes_episode_type":"","_links_to":"","_links_to_target":""},"categories":[275822,25022],"tags":[1171,961],"arcuser_issues":[484952],"class_list":["post-588722","arcuser","type-arcuser","status-publish","format-standard","hentry","category-arcgis-living-atlas-of-the-world","category-hands-on","tag-open-data","tag-spatial-analysis","arcuser_issues-au-spring-2023"],"acf":{"short_description":"Robust field descriptions save time and ensure accuracy for anyone using datasets for analysis.  ","pdf":{"host_remotely":false,"file":588732,"file_url":""},"flexible_content":[{"acf_fc_layout":"content","content":"Making a map is a great way to visualize quantitative data because it shows the data values in combination with location intelligence. However, making a map requires understanding the attributes being mapped. If descriptions of those attributes are a few clicks away, that significantly decreases the time the mapmaker needs to understand the attributes.\r\nThe field descriptions of feature layers in ArcGIS Online are a structured place to communicate all details of attribute fields, including:\r\n<ul>\r\n \t<li>Definitions<\/li>\r\n \t<li>Sources<\/li>\r\n \t<li>Vintages<\/li>\r\n \t<li>Units<\/li>\r\n<\/ul>\r\n<h3>Expressions for Calculated Fields<\/h3>\r\nThese descriptions help analysts navigate the ever-growing corpus of data by putting this field-specific documentation as close to the field as possible. This limits the amount of time analysts need to search for documentation. Analysts use this information to ensure they\u2019re using the right attributes for their purposes.\r\n\r\nMany layers in ArcGIS Living Atlas of the World, such as American Community Survey hosted feature layers, USA Census 2020 Redistricting layers, Bureau of Labor Statistics Monthly Unemployment layer, County Health Rankings 2022, and Justice40 Tracts, include long field descriptions.\r\n<h3>Learn Definitions<\/h3>\r\nGIS analysts know that GIS can help shed light on complex topics, like climate change, social justice, and economic development, by visualizing opportunities to intervene. Those complex topics often come with a specific vocabulary that allows subject matter experts to describe details efficiently. Unfortunately, to the layperson, this language can sound like industry jargon. One example of this jargon is the phrase \"group quarters population.\" It\u2019s defined as people living in group-based settings such as college dorms, military barracks, correctional facilities, or assisted living homes.\r\n\r\nBy opening the USA Census 2020 Redistricting Tracts layer in Map Viewer, you can see a field displayed as Total group quarters population in the fields list for styling the map. The i information button provides the definition:\r\n\r\n<em>\u201cGroup quarters are defined as places where people live or stay in a group living arrangement that is owned or managed by an organization providing housing and\/or services for the resident.\u201d<\/em>\r\n\r\nAnother useful type of definition included in the field description\u2014when appropriate\u2014is one for coded values. For example, every census block, block group, tract, and county are contained in a state (or state equivalent if in Washington, DC, or Puerto Rico). This state is a field on the layers for lower levels of geography. Similarly, these codes are also contained within a census division. The coded values for the attribute division range from 0 to 9. In this case, the description serves as a codebook that exposes which division each value corresponds to.\r\n\r\nOne click on the<em> i<\/em> information button gives a better understanding of these topics. Not leaving Map Viewer to get the definitions on another website saves time. The layer provides the definitions you need in the field descriptions.\r\n<h3>Learn Expressions for Calculated Fields<\/h3>\r\nI find that working with calculated fields can be cumbersome and time-consuming, because sometimes my own calculations don\u2019t match what I\u2019m seeing on the layer I\u2019m working with. I want to see the formulas used, since knowing exactly how a field was calculated can be extremely helpful.\r\n\r\nFor example, the Living Atlas Gender Identity and Sexual Orientation layer does not include those who did not report certain characteristics in either the numerator or denominator of percent calculations. You can explore the field descriptions by opening the attribute table, clicking \u2026 (more options) in the header for the specific field in the attribute table and choosing the<em> i<\/em> information button to access information about a specific field including the field description. The formula used for the field can be viewed. With that information, I have greater trust in an attribute than when I wasn\u2019t replicating the values, and I don\u2019t need to leave the Map Viewer and read through a methodology document from the source. My question was answered in a few clicks.\r\n\r\n&nbsp;"},{"acf_fc_layout":"image","image":588762,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"<h3>Learn Sources, Vintages, and Units<\/h3>\r\nSome datasets are valuable in part because they bring together information from multiple sources. While it is very useful to have different types of information in one unified layer, it can raise questions about sources and vintages. However, the field description is an ideal place to store this type of attribute-specific metadata. For example, each year the Robert Wood Johnson Foundation undertakes the herculean task of combining several sources and updating each with the latest vintage data available to produce its County Health Rankings. This results in a very informative layer that provides attributes on topics such as obesity, smoking, child poverty, and mammogram screening.\r\n\r\nIf I\u2019m interested in underlying sources and vintages of the data used in this layer, I will look at the layer\u2019s item page. However, much of this information on sources will differ depending on the attribute. To find out the underlying source and vintage of an attribute, all I have to do is click the Data tab on the item page. This brings me to the attribute tables, and from there, I hover over the field I want to learn more about, in this case, percent low birth weight.\r\n\r\nHovering over the column exposes the field description, which includes source information. The source for data on low birth weight is the National Center for Health Statistics\u2014Natality files for years 2014\u20132020. This field description also notes that low birth weight is defined as weight less than 2,500 grams, and that it\u2019s 20 percent of the Health Outcomes ranking.\r\n\r\n&nbsp;"},{"acf_fc_layout":"image","image":588772,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"For large GIS projects, there are dozens of fields that have detailed information associated with them. Here the fields list on the item detail page can be extremely helpful. In the Data tab, simply switch from Table view to Fields view. Try the List option or the Table option to discover which one works best for your needs. I find the List option is the most ideal because it displays all field information (including field descriptions) in one place.\r\n\r\n&nbsp;"},{"acf_fc_layout":"image","image":588782,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"<h3>Field Descriptions Are Visible in Many Places<\/h3>\r\nFrom the previous examples, you probably noticed that field descriptions are available in many places in ArcGIS Online. Get to them within the Map Viewer\u2019s symbology options, viewing the attribute table within Map Viewer, and in the Data tab of the item page. Exposing the field descriptions in multiple user experiences makes viewing the descriptions just a few clicks away from whatever you\u2019re doing. Next time you\u2019re working with a layer in ArcGIS Living Atlas and have a question about an attribute, check for a field description.\r\n\r\n&nbsp;"},{"acf_fc_layout":"image","image":588792,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"<h3>Include Long Field Descriptions on Your Feature Layers<\/h3>\r\nIn most large organizations, the analysts who publish layers are different from the analysts who use the layers for mapping. And the people who create dashboards, apps, and stories can be different. Are you publishing feature layers for your organization that others use downstream in a workflow? Consider including long field descriptions on some of your layers in this case.\r\n\r\nFrom an organizational perspective, analysts are creating a high-quality institutional asset that can avoid misinterpretation of data, which reduces costs. From an individual perspective, analysts are providing answers to specific questions about various fields in a self-service style, which reduces questions piling up in analysts\u2019 inboxes.\r\n\r\n&nbsp;"},{"acf_fc_layout":"image","image":588812,"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"<h3>Creating Descriptions<\/h3>\r\nThe most time-intensive part of creating field descriptions will be writing out the descriptions themselves because that can involve looking through codebooks, metadata in data warehouses, information across multiple sources, and other kinds of technical documentation that may or may not be well organized. Since the main goal of field descriptions is to communicate information about the field, it can be worthwhile to ask people who use the map layers you create what they need to know about the attributes. You can ask questions such as:\r\n<ul>\r\n \t<li>Is the source the most important thing to put first?<\/li>\r\n \t<li>What definitions are needed?<\/li>\r\n \t<li>Do we include formulas?<\/li>\r\n \t<li>Do any acronyms need to be spelled out?<\/li>\r\n<\/ul>\r\nWhen they write descriptions for a handful of fields, analysts will quickly realize that it takes dedicated time. If creating field descriptions for every single field seems overwhelming, start with the fields that generate the most questions. Which attributes generate the most questions?\r\n\r\nThe actual mechanics of applying the field descriptions are easy for the item\u2019s owner. It can be done manually through the ArcGIS Online graphical user interface (GUI), or through a scripted process. A scripted process is most ideal when editing many fields.\r\n<h3>Applying Descriptions Manually through the GUI<\/h3>\r\nFrom the item page, click Data &gt; Fields &gt; to change from Table view to List view. Then click the field you\u2019d like to edit.\r\nBy opening the USA Census 2020 Redistricting Tracts layer in Map Viewer, you can see a field displayed as Total group quarters population in the fields list for styling the map. The i information button provides the definition.\r\n\r\nIf you\u2019re working with multiscale layers, make sure the desired layer is selected in the drop-down option. If your layer contains many fields, use the search bar to search within the fields. Or use the filter options to filter by field type. The character limit for adding descriptions manually through the user interface is 500.\r\n<h3>Applying Descriptions through a Scripted Process<\/h3>\r\nIf you\u2019d prefer a scripted process to save time and reduce the potential for human error, I highly recommend <a href=\"https:\/\/bit.ly\/3XPXf5P\">AliasUpdater<\/a>, a Python script created by Esri staff member Lisa Berry. It was designed to help you update the aliases and descriptions for hosted feature services.\r\n\r\nYou\u2019ll need a Microsoft Excel table containing the field names, desired aliases, and desired descriptions. This script also allows for assigning other options including attribute field type, decimal places to display, and comma separators. The character limit for adding descriptions through a scripted process is 1,064.\r\n<h3>Recap<\/h3>\r\nField descriptions help clarify confusion around definitions, units, sources, vintages, and more. Many layers in Living Atlas contain field descriptions for all attributes. This helps analysts learn more about what exactly they are mapping in just a few clicks. Adding field descriptions to your own layers is straightforward."}],"references":null},"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v25.9 (Yoast SEO v25.9) - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Better field descriptions promote accuracy<\/title>\n<meta name=\"description\" content=\"Robust field descriptions make datasets more accurately and easily used for analysis for everyone by clarifying the vintage, sources, units, and formulas of the data.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"High-Quality Field Descriptions Make Mapping Easier\" \/>\n<meta property=\"og:description\" content=\"Robust field descriptions make datasets more accurately and easily used for analysis for everyone by clarifying the vintage, sources, units, and formulas of the data.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions\" \/>\n<meta property=\"og:site_name\" content=\"Esri\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/esrigis\/\" \/>\n<meta property=\"og:image\" content=\"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2023\/05\/description_banner.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:site\" content=\"@Esri\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\n\t    \"@context\": \"https:\/\/schema.org\",\n\t    \"@graph\": [\n\t        {\n\t            \"@type\": \"WebPage\",\n\t            \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions\",\n\t            \"url\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions\",\n\t            \"name\": \"Better field descriptions promote accuracy\",\n\t            \"isPartOf\": {\n\t                \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#website\"\n\t            },\n\t            \"datePublished\": \"2023-05-27T02:07:46+00:00\",\n\t            \"description\": \"Robust field descriptions make datasets more accurately and easily used for analysis for everyone by clarifying the vintage, sources, units, and formulas of the data.\",\n\t            \"breadcrumb\": {\n\t                \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions#breadcrumb\"\n\t            },\n\t            \"inLanguage\": \"en-US\",\n\t            \"potentialAction\": [\n\t                {\n\t                    \"@type\": \"ReadAction\",\n\t                    \"target\": [\n\t                        \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions\"\n\t                    ]\n\t                }\n\t            ]\n\t        },\n\t        {\n\t            \"@type\": \"BreadcrumbList\",\n\t            \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions#breadcrumb\",\n\t            \"itemListElement\": [\n\t                {\n\t                    \"@type\": \"ListItem\",\n\t                    \"position\": 1,\n\t                    \"name\": \"Home\",\n\t                    \"item\": \"https:\/\/www.esri.com\/about\/newsroom\"\n\t                },\n\t                {\n\t                    \"@type\": \"ListItem\",\n\t                    \"position\": 2,\n\t                    \"name\": \"High-Quality Field Descriptions Make Mapping Easier\"\n\t                }\n\t            ]\n\t        },\n\t        {\n\t            \"@type\": \"WebSite\",\n\t            \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#website\",\n\t            \"url\": \"https:\/\/www.esri.com\/about\/newsroom\/\",\n\t            \"name\": \"Esri\",\n\t            \"description\": \"Esri Newsroom\",\n\t            \"potentialAction\": [\n\t                {\n\t                    \"@type\": \"SearchAction\",\n\t                    \"target\": {\n\t                        \"@type\": \"EntryPoint\",\n\t                        \"urlTemplate\": \"https:\/\/www.esri.com\/about\/newsroom\/?s={search_term_string}\"\n\t                    },\n\t                    \"query-input\": {\n\t                        \"@type\": \"PropertyValueSpecification\",\n\t                        \"valueRequired\": true,\n\t                        \"valueName\": \"search_term_string\"\n\t                    }\n\t                }\n\t            ],\n\t            \"inLanguage\": \"en-US\"\n\t        },\n\t        {\n\t            \"@type\": \"Person\",\n\t            \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/82e5143bcdebadf8fd64d84e503ca468\",\n\t            \"name\": \"Monica Pratt\",\n\t            \"image\": {\n\t                \"@type\": \"ImageObject\",\n\t                \"inLanguage\": \"en-US\",\n\t                \"@id\": \"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/image\/\",\n\t                \"url\": \"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg\",\n\t                \"contentUrl\": \"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg\",\n\t                \"caption\": \"Monica Pratt\"\n\t            },\n\t            \"description\": \"Monica Pratt is the founding and current editor of ArcUser magazine, the executive editor of ArcNews magazine, the editor of Esri Globe and head of the Publications team at Esri. She has been writing on technology topics, specializing in GIS, for more than 30 years. Before joining Esri in 1997, she worked for newspapers and in the financial industry.\",\n\t            \"sameAs\": [\n\t                \"https:\/\/x.com\/ArcUser\"\n\t            ],\n\t            \"url\": \"\"\n\t        }\n\t    ]\n\t}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Better field descriptions promote accuracy","description":"Robust field descriptions make datasets more accurately and easily used for analysis for everyone by clarifying the vintage, sources, units, and formulas of the data.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions","og_locale":"en_US","og_type":"article","og_title":"High-Quality Field Descriptions Make Mapping Easier","og_description":"Robust field descriptions make datasets more accurately and easily used for analysis for everyone by clarifying the vintage, sources, units, and formulas of the data.","og_url":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions","og_site_name":"Esri","article_publisher":"https:\/\/www.facebook.com\/esrigis\/","og_image":[{"url":"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2023\/05\/description_banner.jpg","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_site":"@Esri","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions","url":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions","name":"Better field descriptions promote accuracy","isPartOf":{"@id":"https:\/\/www.esri.com\/about\/newsroom\/#website"},"datePublished":"2023-05-27T02:07:46+00:00","description":"Robust field descriptions make datasets more accurately and easily used for analysis for everyone by clarifying the vintage, sources, units, and formulas of the data.","breadcrumb":{"@id":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.esri.com\/about\/newsroom\/arcuser\/fieldescriptions#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.esri.com\/about\/newsroom"},{"@type":"ListItem","position":2,"name":"High-Quality Field Descriptions Make Mapping Easier"}]},{"@type":"WebSite","@id":"https:\/\/www.esri.com\/about\/newsroom\/#website","url":"https:\/\/www.esri.com\/about\/newsroom\/","name":"Esri","description":"Esri Newsroom","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.esri.com\/about\/newsroom\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/82e5143bcdebadf8fd64d84e503ca468","name":"Monica Pratt","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.esri.com\/about\/newsroom\/#\/schema\/person\/image\/","url":"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg","contentUrl":"https:\/\/www.esri.com\/about\/newsroom\/app\/uploads\/2018\/08\/MonicaMug_agol2.jpg","caption":"Monica Pratt"},"description":"Monica Pratt is the founding and current editor of ArcUser magazine, the executive editor of ArcNews magazine, the editor of Esri Globe and head of the Publications team at Esri. She has been writing on technology topics, specializing in GIS, for more than 30 years. Before joining Esri in 1997, she worked for newspapers and in the financial industry.","sameAs":["https:\/\/x.com\/ArcUser"],"url":""}]}},"sort_order":"16","_links":{"self":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser\/588722","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser"}],"about":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/types\/arcuser"}],"author":[{"embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/users\/1031"}],"version-history":[{"count":0,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser\/588722\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/media?parent=588722"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/categories?post=588722"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/tags?post=588722"},{"taxonomy":"arcuser_issues","embeddable":true,"href":"https:\/\/www.esri.com\/about\/newsroom\/wp-json\/wp\/v2\/arcuser_issues?post=588722"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}