ArcGIS Arcade Fundamentals

Summary

The video script details a comprehensive presentation on ArcGIS Arcade, a scripting language for creating custom expressions and calculations within the ArcGIS platform. The presenters, Phil Julian and Gustavo Castro, introduce the audience to the versatility of Arcade across different ArcGIS products, emphasizing its security and lightweight nature. They demonstrate how Arcade can enhance data analysis and visualization through dynamic labeling, pop-up customization, and data manipulation. The script also covers basic syntax, variables, functions, and best practices for using Arcade effectively. The presentation includes a live demo showcasing the practical application of Arcade for improving map readability, pop-up information, and form customization in field maps. The speakers highlight the accessibility of Arcade through various profiles and its ability to synchronize changes across different applications and platforms, making it a powerful tool for GIS professionals.

Takeaways

• 📈 **ArcGIS Arcade Overview**: Arcade is a scripting language for creating custom expressions and calculations within ArcGIS, enhancing data analysis and visualization capabilities.
• 🛠️ **Flexibility and Portability**: Arcade is versatile and can be used across various ArcGIS products like ArcGIS Pro, ArcGIS Online, and ArcGIS Enterprise, making it a powerful tool for GIS workflows.
• 🔒 **Security**: Arcade ensures security as expressions are operational only within ArcGIS applications and cannot execute outside the platform.
• ✅ **Customization**: Users can create custom labels, symbols, and pop-ups, as well as perform data manipulations such as filtering, classifying, and calculating field values on the fly.
• 📚 **Syntax and Functions**: Arcade uses a syntax similar to JavaScript, with support for variables, functions, and conditional statements, making it accessible for those with prior coding experience.
• 🎨 **Data Visualization**: Arcade allows for dynamic visualizations, such as changing symbology based on data values, creating dynamic charts or graphs, and customizing label formatting.
• 📐 **Geometric Functions**: Arcade provides geometric functions to work with spatial data, including calculating the length of lines, area of polygons, and centroids.
• 📈 **Data Manipulation**: Users can perform complex data manipulations without creating new fields or tables, streamlining the process of filtering, classifying, and labeling GIS data.
• 📝 **Labeling**: Arcade enhances labeling in GIS by allowing dynamic and customized labels that respond to changes in data or map settings, leading to clearer and more informative maps.
• 🌐 **Cross-Platform Use**: Arcade expressions created in one ArcGIS platform can be shared and used across different platforms, ensuring consistency in data representation and analysis.
• ⚙️ **Best Practices**: The presentation highlighted best practices for using Arcade, such as keeping expressions simple, organized, and well-commented for readability and efficient performance.

Q & A

What is the main purpose of using ArcGIS Arcade?

ArcGIS Arcade is used to create custom expressions and calculations within the ArcGIS platform. It allows for dynamic visualizations and data-driven maps to be created, enhancing data analysis and visualization capabilities.

Who is the target audience for this presentation?

The presentation is aimed at both coders and non-coders who work with the ArcGIS platform and are interested in improving their GIS workflows and data analysis through the use of Arcade.

What are some examples of situations where Arcade can improve workflows or data analysis?

Arcade can be used to calculate field values, filter data, classify data, create dynamic labels, format pop-up information, and display current map scale or extent, among other things.

How is Arcade different from traditional coding?

Arcade is a scripting language designed specifically for use within ArcGIS applications. It is portable and lightweight, allowing it to be used across different ArcGIS products and workflows without executing outside of them.

What are some basic syntax elements of Arcade expressions?

Arcade expressions are enclosed in curly braces and can contain multiple statements separated by semicolons. Variables are defined using the VAR keyword, and functions are used to perform complex calculations or operations.

How can Arcade be used for custom labels?

Arcade can be used to display complex label information by combining multiple fields, writing custom text based on specific criteria, and creating custom symbols or patterns that better represent the data being visualized.

What is the benefit of using Arcade for custom calculations and expressions across multiple ArcGIS products?

Custom expressions and calculations created with Arcade can be used across various ArcGIS products and platforms, ensuring consistency and reusability of the expressions, which can improve efficiency and maintain uniformity across different projects.

How does Arcade help in data manipulation?

Arcade allows users to perform calculations and manipulate data on the fly without the need to create new fields or tables. It can be used for filtering, classifying, and labeling data in new dynamic ways.

What are some best practices for working with Arcade expressions?

Best practices include keeping expressions simple and efficient to avoid slow map performance, organizing variables and functions for reusability, using comments for readability, and testing labels at different scales and on different devices to ensure legibility.

How can Arcade improve data visualization?

Arcade can create custom symbology that changes based on data values, generate unique IDs for features, format phone numbers consistently, and calculate complex criteria like the percentage change in population over time, leading to more impactful and informative map visualizations.

What resources are available for learning more about ArcGIS Arcade?

Resources for learning more about ArcGIS Arcade include official documentation, a playground for experimenting with expressions, ArcGIS blogs for updates, and community forums for discussions and support.

Outlines

00:00

📈 Introduction to ArcGIS Arcade for Dynamic Mapping

The video begins with an introduction by Phil Julian and Gustavo Castro, solution engineers from the Minneapolis office, who apologize for audio disruptions due to a snowstorm. They introduce ArcGIS Arcade as a scripting language for creating custom expressions and calculations within ArcGIS. The presenters clarify that the presentation is aimed at both coders and non-coders, intending to demonstrate how Arcade can enhance GIS workflows and data analysis capabilities. The agenda includes an overview of Arcade, basic syntax, data manipulation, labeling, visualizations, a demo, tips and tricks, and a recap with additional resources.

05:02

🎨 Customizing Labels and Visualizations with Arcade

The speakers discuss how ArcGIS Arcade can be used for custom labels and visualizations. They provide examples of using Arcade expressions for dynamic labeling, creating custom symbols, and adjusting symbology based on data values. The video also covers using Arcade for custom calculations and expressions for data analysis, such as calculating distances between features or creating new attribute values based on complex criteria. Additionally, custom pop-ups and dynamic text elements in layouts are discussed, along with a demonstration of an Arcade expression that converts meters to feet.

10:03

📐 Advanced Arcade Expressions for Data Manipulation

The video delves into advanced uses of Arcade expressions for data manipulation. It shows how to calculate the area of a circle based on its diameter and assign values to variables within an expression. The speakers provide examples of defining variables, using conditional statements, and creating custom pop-ups with images. They also touch on creating custom labels with conditional formatting and changing symbology based on attribute values, emphasizing the flexibility and power of Arcade for data analysis and visualization.

15:04

🔢 Basic Syntax and Variables in Arcade Expressions

The presenters provide a recap of the basic syntax for Arcade expressions, emphasizing the use of curly braces, semicolons for separating statements, and commenting. They explain how variables are defined and used within Arcade, including different types such as string, number, and Boolean. Examples given include calculating population density, creating labels with distance information, and generating labels based on population size. Functions are also introduced as pre-written blocks of code that can perform specific operations and be nested within other functions.

20:04

🧩 Combining Syntax Elements for Complex Arcade Expressions

The video demonstrates how to combine variables and functions to create more complex Arcade expressions. It shows calculations for area conversion and population density, and how to store the results of functions for later use. The script examples given include converting the area of a feature from square meters to square kilometers and calculating the length of a line feature in meters. The concept of using a variable to store the result of one function for use in subsequent calculations is also covered.

25:06

📊 Data Manipulation and Filtering with Arcade

The speakers explore how Arcade can be used for data manipulation, such as performing calculations on the fly, filtering data, and classifying data. They provide examples of calculating percentages, concatenating field values, converting units of measurement, and using Arcade expressions in definition queries for data filtering. The video also covers multi-criteria filtering and classifying data into categories based on specific criteria, showcasing the versatility of Arcade for enhancing GIS data handling.

30:09

🏷️ Advanced Labeling Techniques with Arcade

The video focuses on advanced labeling techniques with Arcade, allowing for dynamic labels that respond to changes in data or map settings. It covers how to format and style label text based on specific criteria, concatenate values from multiple fields, and create custom labels based on criteria. Examples include using Arcade expressions to determine label visibility based on population size and to adjust text format based on map scale. Best practices for labeling with ArcGIS Arcade are also discussed, emphasizing simplicity, efficiency, and readability.

35:09

🌐 Cross-Platform Benefits and Syntax of ArcGIS Arcade

The speakers discuss the benefits of using ArcGIS Arcade expressions and calculations across multiple ArcGIS products and platforms. They highlight the ability to save and share custom expressions for consistency and the enhancement of data visualizations and analysis. The basic syntax of Arcade expressions is reviewed, including the use of curly braces, semicolons, and variables. The video also provides examples of using Arcade for conditional symbology, dynamic charts or graphs, and creative data display.

40:10

📚 Resources and Documentation for ArcGIS Arcade

The video concludes with a reminder about the availability of ArcGIS Arcade documentation and resources for further learning. It emphasizes the evolving nature of Arcade and the importance of staying updated with the latest changes. The speakers also encourage the audience to explore the ArcGIS blog for the latest updates and to utilize the Arcade editor for an enhanced coding experience. They invite questions and offer assistance, pointing to forums, tutorials, and webinars as valuable resources for learning more about Arcade.

Keywords

💡Arcade

Arcade is a scripting language used within the ArcGIS platform to create custom expressions and calculations. It is portable and lightweight, allowing its use across different ArcGIS products and workflows. In the video, Arcade is central to enhancing GIS workflows, data analysis, and creating dynamic visualizations. It is used for tasks such as custom labeling, symbology, and data manipulation.

💡ArcGIS

ArcGIS is a geographic information system (GIS) for working with geography-based data. It is the platform where Arcade is utilized to improve workflows and data analysis. The script mentions ArcGIS Pro, ArcGIS Online, and ArcGIS Enterprise as environments where Arcade can be applied to create dynamic and data-driven maps.

💡Data Visualization

Data visualization refers to the graphical representation of information and data. In the context of the video, Arcade is used to create dynamic visualizations within ArcGIS, such as changing symbology based on data values, creating dynamic charts or graphs, and enhancing the presentation of GIS data.

💡Data Manipulation

Data manipulation involves altering, organizing, or processing data for analysis or other uses. The video discusses how Arcade can be used to perform calculations and manipulate data on the fly, such as calculating field values, filtering data, or classifying data without the need to create new fields or tables.

💡Custom Labels

Custom labels are user-defined textual or graphical representations of data that can be added to maps for clarity. The video emphasizes how Arcade can be used to create dynamic and customized labels that respond to changes in data or map settings, enhancing the overall presentation and usefulness of the map.

💡Syntax

Syntax refers to the set of rules governing the structure of expressions and statements in a programming language. In the context of the video, learning the basic syntax of Arcade is crucial for writing expressions, using variables, and employing functions to manipulate data and create visualizations within ArcGIS.

💡Variables

Variables are used to store and manipulate values within a script or program. In Arcade, variables can be defined and used to hold data that can be referenced and manipulated throughout an expression. The video provides examples of how variables are used in Arcade to store the results of calculations for later use.

💡Functions

Functions are pre-written blocks of code that perform specific operations. In Arcade, functions can simplify expressions, reduce repetition, and be nested within other functions. They are used for various purposes, such as rounding numbers, counting features, and manipulating strings, as demonstrated in the video.

💡Conditional Statements

Conditional statements are used to perform different actions based on certain conditions. In Arcade, they are essential for creating expressions that change behavior or output depending on the data or user interactions. The video mentions the use of if-else statements to create custom labels and symbology based on feature attribute values.

💡Dynamic Content

Dynamic content refers to elements within a digital platform that change or adapt based on user interaction, data changes, or other factors. The video discusses how Arcade enables the creation of dynamic labels, pop-ups, and visualizations that adjust in real-time as data or map settings change.

💡GIS Workflows

GIS workflows are the sequences of steps taken to complete a GIS project or task. The video emphasizes how Arcade can be used to improve these workflows by providing custom calculations and expressions that can be used to enhance data analysis, visualization, and overall efficiency in working with geographic information systems.

Highlights

Arcade is a scripting language for creating custom expressions and calculations within ArcGIS, enhancing data analysis and visualization capabilities.

Arcade is portable and lightweight, usable across various ArcGIS products and workflows, including ArcGIS Pro, ArcGIS Online, and ArcGIS Enterprise.

Arcade expressions are secure, operating only within ArcGIS applications and cannot execute outside of it, ensuring data integrity.

Arcade can be used to create dynamic labels, render features, check attribute data, and format data within ArcGIS applications.

The presentation covers basic syntax, data manipulation, labeling, and visualizations using Arcade, providing attendees with a solid understanding of its capabilities.

Arcade expressions can calculate field values, filter data, classify data, and create dynamic labels based on map size or scale.

Custom pop-ups can be created with Arcade expressions to display relevant information based on the feature clicked, enhancing user interaction with the map.

Arcade expressions can format pop-up information visually using charts, images, or graphs to represent data more effectively.

The presentation includes a live demo by Gustavo Castro, showcasing the practical application of Arcade expressions in real-world scenarios.

Arcade supports a variety of functions, including mathematical, text, and geometry functions, which can be combined for complex data manipulation.

Best practices for using Arcade expressions are discussed, emphasizing simplicity, efficiency, and readability for optimal map performance.

Arcade expressions can be saved and shared, promoting consistency in labeling and analysis across multiple projects and teams.

The presentation demonstrates how to use Arcade for advanced labeling techniques, such as conditional formatting and dynamic label adjustments based on real-time data.

Arcade's flexibility allows for custom calculations and expressions to be used in both desktop and web GIS applications, ensuring a consistent workflow.

The ArcGIS Blog is a valuable resource for staying updated with the latest Arcade features and improvements, as showcased in the recent ArcGIS Online update.

Arcade's evolving nature means that new functionalities are continually being added, expanding its capabilities for developers and users alike.

The presentation concludes with an encouragement for attendees to experiment with Arcade across the ArcGIS platform for their mapping endeavors.

Transcripts

um today I'm going to be presenting with

Gustavo Castro a solution engineer

um as myself Phil Julian

we are both out of the Minneapolis

regional office and we're very sorry we

couldn't join you today

um if you hear any audio disruptions in

the background there's a symphony of

snow blowers we just got slammed last

night with this storm so I apologize if

there's any uh audio issues in the

background

that being said we'll go ahead and start

this presentation so first a disclaimer

I am not a coder

I utilize arcade in my maps and spend a

lot of time kind of working with the

documentation and looking for examples

to be able to provide

um

the use of arcade within my um you know

efforts within the arcgis platform so if

you're in that situation whether you're

a coder or a no coder this presentation

will hopefully convince you that arcgis

arcade is going to allow you to create

those Dynamic visualizations and data

driven maps that you can use in your

everyday cartographic Pursuits

in this presentation we're going to

explore the ins and outs of arcade and

show you how to use it to improve your

data analysis and visualization

capabilities

and by the end of this presentation we

hope that you will have a solid

understanding of arcade and how it can

be used to improve your GIS workflows

and data analysis

you should have tools and knowledge to

that you'll need to start experimenting

with arcade expressions in your maps and

your analysis

and with that we will go ahead and get

started

um with looking at arcade

so taking a quick look at the agenda

we're going to begin with an

introduction arcade where we're going to

explain what arcade is and how it can be

used within arcgis

we're going to give some examples of

situations where arcade can be used to

improve workflows or data analysis

we're going to cover some basic syntax

so this is going to include how to write

expressions the use of variables and the

use of functions

we're going to dive into Data

manipulation where we can demonstrate

how arcade can be used to manipulate

data on the Fly and this can include

things like using arcade to calculate

field values filter data or classify

your data

uh we'll talk about labeling and show

how arcade can be used to create Dynamic

labels in your maps and this can include

formatting text adding icons or symbols

or changing label placement based on the

size or scale of your map

we'll talk about visualizations which is

going to include how arcade can be used

to create dynamic visualizations in your

map and this can include changing

symbology Based on data values creating

Dynamic charts or graphs or creatively

displaying your data

after that we're going to go ahead and

pause take a quick break and Gustavo is

going to go ahead and do a demo so you

can see some of these topics that we're

going to cover in action

and then we will see how much time we

have remaining we can go over some tips

and tricks which is going to provide

some of the best practices for working

with arcade expressions

we're going to talk about what's new and

then we will also go ahead and do a

quick recap and have some additional

resources that you can use to continue

learning more about Arcade

so with that let's go ahead and begin

our introduction

so arcgis arcade is a scripting language

that creates custom expressions and

calculations in arcgis it's portable and

lightweight meaning you can use it

across different arcgis products and

workflows including arcgis Pro arcgis

online and rgis Enterprise

arcade is secure because Expressions

only work within arcgis applications and

cannot execute outside of it you can use

arcade to create labels render features

check attribute data format data and

More in arcgis online arcade can be used

for custom pop-ups and defining

symbology and pro it can be used for

creating custom labels symbolizing

features and creating custom fields and

in Enterprise we can see it used for

creation of custom widgets and defining

custom visualization expressions

so overall RK provides a flexible and

portable way to perform custom

calculations and expressions Within

arcgis

so continuing on that subject about how

it's used within arcgis let's take a

look at custom labels for better

visualization so you can use arcade

Expressions to display complex label

information such as combining multiple

Fields writing custom text based on

specific criteria

you can use arcade Expressions to create

custom symbols or patterns that better

represent the data being visualized such

as different shapes or sizes to

represent different categories and you

can use arcade Expressions to adjust

symbology based on specific data values

such as using a gradient fill to show

population density

we can also use arcade for custom

calculations and expressions for data

analysis like distances and attribute

values

so we can use arcade Expressions to

calculate distances between features or

say find the nearest feature to a given

location we can use arcade Expressions

to calculate new attributes values based

on complex criteria such as creating a

new field that categorizes feature based

on multiple attributes

we can also use it to work with our

pop-ups so we can use arcade Expressions

to create custom pop-ups that show only

relevant information based on the

feature that's being clicked such as

displaying different fields for

different feature types

and we can also use arcade Expressions

to format pop-up information in a more

visually appealing way such as using

charts images or graphs to display your

data

and then we can also use Dynamic text

elements in our layouts like dates and

map skills

so using arcade Expressions we can

display the current date or time or we

can format dates in a specific way and

using arcade Expressions to display the

current map scale or extent we're to add

custom text elements to a layout based

off of specific criteria

foreign

so let's take a look at some codes

we're going to go ahead and start with

our first arcade expression and this

expression converts the linked attribute

of a feature from meters to feet using a

conversion factor of the three dot etc

etc

and this expression uses the dollar sign

feature Global variable to retrieve the

value of the linked attribute for the

current feature

it's then going to multiply this value

by the conversion factor of 3.2

miscellaneous to get that length value

in feet and the resulting value is going

to be returned by the expression and it

will be displayed as the output and we

can see here that it's enclosed in curly

braces which is used to denote an arcade

expression within a larger string

expression and the dollar sign is being

used to indicate that the expression is

referencing an attribute or Global

variable

um arcade expressions with multiple

statements are separated by semicolons

so this next arcade expression

calculates the area of a circle based

off of its given diameter value it's

going to first assign the value of

diameter attribute from the input

feature to a variable called diameter

then it's going to calculate the radius

of the circle by dividing the diameter

by 2 and assigning it a variable called

radius next it's going to calculate the

area of the circle by multiplying the

value of pi by the square of the radius

and assigning that to a variable called

area and finally it's going to return

the value of area variable as a result

of the expression which is represented

which represents the area of the circle

that corresponds to a given diameter

our next example is going to look at

defining and assigning a valuable value

to a variable in an arcade expression

first this one's going to declare the

constant value value of pi as

3.14159 then it's going to assign the

value of radius attribute from the input

feature to a variable called radius next

it's going to calculate the area of the

circle by multiplying Pi by the square

of the radius and assigns it into a

variable called area and finally it's

going to return the value of area as a

variable as a result of the expression

um and then looking at our strings they

must be enclosed in quotes

um in this last example it's going to

Define a variable called label text and

assign it

the value of a fixed string which is

going to be called the value of the

field is

then it's going to concatenate the value

of a specified field denoted by field

name using the feature Global variable

which is going to retrieve the attribute

of the current feature

the results of the concatenation is

going to be assigned to the label text

variable and finally the expression

Returns the value of label text as a

variable for the feature

here we can see a little bit more of a

complex example that's going to be

creating a custom pop-up that includes a

photo and this arcade code is used to

generate a pop-up that displays an image

for each feature on a map and here's how

it works the code starts by declaring

two variables image and name the image

variable is assigned the value of image

URL attribute for the current feature

which presumably contains a URL pointing

to an image file the name variable is

assigned to the value of name

attribute for the current feature the

code will then create an object that

contains two properties title and

content the title property is sets the

value of the name variable which will be

used in the title of the pop-up

the content property is in an array that

contains a single object and the object

has a type property sets in media which

indicates that it'll display a piece of

media in the pop-up the media info's

property is an array that contains a

single object and this object has a type

property set to image which indicates

that it'll display an image the value of

the property this object is an object

that contains a single property Source

URL and the value of this property is

set to the value of the image variable

which contains the URL the image the

current feature

so basically what's going on is this

arcade code retrieves the URL of an

image for each feature in the map it's

going to create a pop-up but the

feature's name is a title and it's going

to display the image

in in the pop-up

and then we can also look at creating

custom labels that use conditional

formatting to change font color size

based off of features attribute value

this code is going to use be used to

create custom labels with color-coded

symbols based on a threshold value the

variables label and value are assigned

to the values of the field name and

value respectively from the feature

being labeled using the feature Global

variable the code then initiate

initializes the color variable as

undefined it's going to then check the

value of the value variable against the

threshold of 100 using an if else

statement and if the value is greater

than 100 it's going to set the color

variable to Red otherwise it's going to

set it to Black

finally the code returns an object with

the custom label text and the

color-coded symbol which is constructed

using the color variable and the text

property is set to the label variable

and the symbol property is set to an

object with a color property sets the

color variable and this object can be

used to customize the symbol of a

labeled feature based on the value of

its value field

we can also create custom Expressions

that calculate an area of a polygon so

this little snippet here of arcade code

is going to calculate the area of a

feature and return the value as the

output the feature.shape dot area

expression retrieves the area of the

feature geometry and it is assigned to

the area variable the return statement

then Returns the value of the area

we can also use arcade to create custom

symbols that change color based on an

attribute value so this arcade code is

going to be used to symbolize features

in a map based off of a specific value

called value

the code Begins by creating a variable

called value and assigning it the value

of the value attribute of the feature

being evaluated against the feature

Global variable

then a variable called color is created

without an initial value next an if else

statement is used to evaluate the value

attribute value and set the color

variable accordingly if the value

attribute equals load the color variable

sets a green

if it equals medium the color variable

is set to Yellow otherwise if it doesn't

match any of those values it's going to

be set to red

finally the code returns an object with

the type simple fill and color value set

to the color of color variable that was

set in the previous step this object can

be used to define the symbol for the

feature being evaluated which in this

case the symbol is a simple fill with a

color that depends on the value of the

value attribute

so some of the benefits of using arcgis

arcade custom expressions and

calculations can be used across multiple

arcgis products and platforms so that

means a custom expression that

calculates the distance between say two

points can be used in both arcgis Pro

and arcgis online web Maps

and a custom expression that generates

something like a unique ID for each

feature can be used in both arcgis Pro

and online feature layers

custom Expressions can be saved and

shared with others so a custom

expression that formats phone numbers

for example can be saved and shared with

other members of a team ensuring

consistency and labeling across multiple

projects and a custom expression that

calculates something like the percentage

change in population over time can be

shared with other organizations working

on demographic analysis

arcade can improve data visualizations

and Analysis so using arcade to create a

custom symbology that changes based on

the age of a building can help reveal

patterns of Urban Development over time

we're using arcade to create a custom

calculation that identifies areas with

the highest concentration of different

land use types can help inform decisions

about urban planning and zoning

all right so we'll go ahead and jump

into basic syntax

as mentioned earlier arcade expressions

are enclosed to curly braces and can

contain one or more statements separated

by a semicolon

variables can be defined using the VAR

keyword and values can be assigned using

the equals operator

functions can be used in arcade

Expressions perform complex calculations

or operations and conditional statements

can be used in arcade expressions for

evaluate a condition and return a value

based on the results

so a quick recap arcade expressions are

enclosed in curly braces

um Expressions can contain one or more

statements separated by a semicolon and

statements can be commented out in both

single line or multi-line comments

let's jump into variables variables can

be used to store it and manipulate

values variables are defined using the

VAR keyword and assigned using the

equals operator and variables can be of

various types including string number

and Boolean

so we have some examples variables in

arcade in this first example this code

is an arcade expression that calculates

the population density of a feature by

dividing the value of a field called

population by the value of a field

called area

and for this example if the population

attribute of a feature being measured is

5000 and area attribute is 100 square

kilometers the expression will return a

value of 50 indicating that there's a

population density of the feature of 50

people per square kilometer

uh we can also store the results of the

function to be used later in the

expression so this next code is an

arcade expression that calculates the

distance between a feature and the near

city in a data set and then creates a

label with this information

for example if the nearest city to the

feature being measured is 50 kilometers

away the expression would return a label

that says distance near City 50

kilometers

and then storing the results of a

calculation to be used for label or

tooltip

this next bit of code is an arcade

expression that creates a label for a

feature based off of its population the

label includes the name of the feature

and a status indicating whether the

feature is a large city or a small City

and for example if the feature being

measured is a city called Springfield

with a population of 500 000 the

expression would return a label it says

Springfield small City

so we'll talk about functions next

functions are pre-written blocks of code

that performs perform specific

operations functions can be used to

simplify expressions and reduce

repetition and functions can be nested

within other functions and can accept

arguments

we can see some functions such as the

round function which can be used to

round a number to a specified number of

decimal places this example will round

the population of a feature to two

decimal places and divide it by a

million we have a count function that

can be used to count the number of

features that meet a certain condition

and this next example will count the

number of cities in a data store with a

population greater than one million we

have a date function that can be used to

create a new date

from an object string and for example

this code will create a date object for

February 23rd 2023 and we have an upper

function that can be used to convert

string to all uppercase this example

will convert a city name of a feature to

all uppercase letters and the last of

these examples which there are many

functions available is the concat

function which can be used to

concatenate strings and this example

will concatenate the first and last name

of the feature with a space in between

we have some text functions that we can

take a look at uh once again this is

just a few we have a left which returns

a specified number of characters from

the beginning of the spring of a string

we can see from the uh comment that this

is going to return hello

um we have right which is going to

return a specified number of characters

from the end of a string and we can see

from the comment here this is going to

return the world with that exclamation

point and we have mid which returns a

specified number of characters from a

string starting at a specified position

and we can see that this is going to

return world

we have math functions we can see the

absolute value of a number from the

comments we can see this first one is

going to return 5. we have round which

is going to round a number to a

specified number of decimal places and

so this is going to return that simple

Pi of 3.14. and we have a floor which is

going to round a number down to the

nearest integer and we can see this is

going to this is going to turn three

even though it's a DOT nine

and then we have a couple of geometry

functions we can look at now we have

length which is going to return the

length of a line or polyline geometry

um we can see that this is going to

return to length of line area can return

the area of a polygon geometry

and then we have the centroid which is

going to return the centroid point of a

polygon geometry

so we can combine syntax elements in our

JS arcade so in this this first example

we see that we have variables and

functions that can be combined to create

a more complex expression first the

script is going to calculate the area of

the feature using the area

areas of special variable in arcade that

Returns the area of the current feature

in square meters the script then divides

the area by a million to convert the

area from square meters to square

kilometers and this is done by dividing

the area by 1 million area divided by 1

million then resulting value is assigned

to the variable area

the next script is going to calculate

the population density by dividing the

population of the feature by the area

the population density is assigned to

the variable pop density and this is

done by dividing the feature.population

which is the population of the current

feature by area finally the script is

going to round the value of Pop density

down two places using the round function

which is built in to Arcade so that's

going to round the number to the

specified number of decimal places that

you decide the resulting value is going

to be returned by the script so the

entire script calculates the population

density of a feature in square

kilometers by dividing the population of

its feature by its area in square

kilometers then rounding the resulting

value down to two decimal places

and then we can see in our second one we

can use a variable to store the results

of a function and then use that variable

in subsequent calculations so in this

example the length function is used to

calculate the length of a line feature

and the result is stored in the line

length variable

the variable is then used to convert the

length to meters and round the result to

two decimal places using the round

function and finally the results is

going to be used in a label expression

to display the length in meters assuming

the feature.shape represents the length

of the line feature the value return

would be a string that displays the

length for the line of meters rounding

two decimal places for example if the

length of a line is 50 feet the code

would convert it to 15.24 and then

return the string length 15.24 meters

all right in this section we're going to

talk about data manipulation so we're

going to explore how arcade can be used

to perform calculations and manipulate

data on the fly without the need to

create new fields or tables

as we've said before arcade's powerful

scripting language that can be used to

create custom expressions and

calculations for use in maps and data

analysis

and with arcade you can filter classify

and label your data in new Dynamic ways

so arcade can be used to calculate

fields in our GIS you can use an arcade

expression in the field calculator to

calculate new values based on existing

Fields arcade can be used in labeling

Expressions to display calculated values

on a map or in pop-up Expressions to

display the calculated values for

individual features

we can see some example of this we can

see calculating a percentage based on

two Fields this arcade expression

calculates the percentage that one field

value represents of another field value

in the same record we can concatenate

values from multiple Fields so this

arcade expression concatenates the

values of two fields in the same record

into a single line

you know we can convert units of

measurement so this is an example of uh

converting meters to feet

arcade can be used to filter data in

arcgis you can also use rgi arcade

expressions and definition queries to

filter features based off of specific

criteria an arcade can also be used in

pop-up Expressions to display only

certain attributes for individual

features or in a labeling expression the

display only certain labels on a map

um I'm going to try to go a little bit

quicker it'll kind of look at the time I

want to make sure Gustavo has enough

time for his presentation but we can

take a quick look at some examples of

arcade Expressions that can be used to

filter data in arcgis

we can look at this top bit of code here

that's going to be an example of arcade

Expressions that uses euclidean distance

to filter features based off their

proximity to a point layer we can

display only features with values above

or below a certain threshold and this is

going to be example of a Boolean

expression that uses logical operators

to evaluate two conditions in return a

Boolean value which would be either true

or false

um and we can also display you know only

features that meet multiple criteria so

this is an example of a multi-criteria

filter using three fields we have field

a field B and field C and the code will

return true only if all three conditions

are met

um we can also classify data using

arcgis arcade

um we can use arcade expressions in the

classify dialog groups uh value value

into classes based off of specific

criteria

an arcade can also be used in labeling

Expressions to display values as classes

on a map or on a pop-up expression to

display values as classes for individual

features

so this is an example of value

classification based on a single field

called value field

and this code is going to use if else

statements to check if the value in the

field

um

and then it's going to return the

appropriate category based off of the

value

we can also classify database off of

geographic location so this code

calculates the distance between the

current feature and the city of Seattle

and classifies the feature as Urban

Suburban or rural based on the distance

and the actual distance classification

thresholds and labels can be modified as

needed

so you can combine multiple data

manipulation techniques in arcade to

create more complex expressions for

example you can use a combination of

field calculations and data filtering

display only certain values based on

calculated criteria and you can also use

a combination of data filtering and

classification display only certain

features within specific value ranges or

a combination of classification and

field calculations to a group data

categories based off of their calculated

values

and then we're going to jump into

labeling with arcade

so labeling with arcade is going to

allow you to create Dynamic labels to

respond to changes in your data or map

settings arcade Expressions can be used

to customize label placement and

formatting giving you greater control

over the appearance of your labels

and overall arcade provides you know a

powerful set of tools for customizing

labels allowing you to create clear

Dynamic and informative Maps

so some of the basics labeling with

arcades can allow you to create Dynamic

and customized labels for your Maps or

GIS and arcade Expressions can be used

to format and style label text based off

of specific criteria

arcade's going to allow you to

concatenate values from multiple Fields

or add text to labels and it's also

going to allow you to create custom

labels based off a specific criteria

so a couple of examples we can use

Expressions to format labels based off a

specific criteria

um and this expression

um the variable declares a variable

text formats the number with commas

round rounds to the nearest thousand and

the K concatenates the K at the end of

the label

we can concatenate values for multiple

Fields or add text to labels in this

expression the plus operator

concatenates the values from the two

fields and this is going to allow you to

add text before and after the

concatenated values respectively

and you can create custom labels based

off a specific criteria so in this

expression the if statement is going to

check if the population is greater than

10 000 and if it is it's going to return

the value from the name field and if the

population is less than or equal to ten

thousand it's going to return an empty

string effectively hiding the label for

those features

we can use arcade Expressions to format

labels based off specific criteria

concatenate values for multiple Fields

we're adding text label and create

custom labels based off of specific

criteria so we just kind of went over

um so you can also do some Advanced

labeling techniques which is going to

allow you to add labels with complex

Expressions that combine multiple data

manipulation techniques such as

conditional formatting and string

concatenation apply digital effects such

as drop Shadows outlines and Halos to

improve legibility and enhance your

appearance of your labels dynamically

adjust label formatting based on

real-time data feeds such as weather

traffic conditions to provide more

timely and relevant information to the

user it's going to allow you to use

arcade Expressions to create stack

labels which can be useful when

displaying multi-part information such

as street names and house numbers

um this next bit of code is going to

show how you can use arcade to determine

the current map scale and then set a

text format based off of that scale

and in the second example we can see

that the type attribute of the current

feature is checked and then resulting

that the text format is set accordingly

so some of the best practices for

labeling with arcgis arcade you know

make sure that your

arcade expressions are being used to

create Dynamic labels that change Based

on data and map scales to keep those

visible

keep label Expressions simple and

efficient to avoid slow map Performance

and keep

variables and functions organized so you

can be able to reuse and label your code

and make sure to make use of your

comments to make them more readable and

understandable

keep your labels simple and easy to read

with appropriate font sizes and styles

keep label Styles consistent and formats

similar throughout the map and test

labels at different scales and on

different devices to ensure that they

are legible and well placed

so formatting labels based off a

specific criteria we use arcade

Expressions to create custom labels

Based on data values such as combining

fields or formatting numbers and dates

um in this next example we can see that

we can display different labels based

off of a field value using the

immediative function and in our last

example we can see how we can capitalize

the first letter of each ward in the

label using the proper function

um you can concatenate values from

multiple fields to add text labels

and so we can see this example of

creating a full name from separate first

and last name fields and using that

expression with the

um the traditional concatenation or we

can use the concatenated function to

achieve the same results as you can see

in the second version of the script here

we can use custom labels based off of

specific criteria so we can use if else

statements to create conditional labels

based off of data values such as

displaying yes if a value is true and

know if it's false

we can use statements to create labels

with multiple possible values such as

displaying high medium or low based off

of a data range

for example in this second code here we

can see how we display different labels

based off the range of values in a pub

density field

and in this last example we're going to

take a look at using labels to create a

label for distance field that combines

value in kilometers and a value in miles

so we can see both of those here used

with this arcade expression

um last I'm going to try to try to

Breeze through this here we got

visualizations

um Dynamic visualizations and arcade

involve using arcade Expressions to

create custom Styles and symbols that

change dynamically based off of the data

values in a layer and this is going to

result in more impactful and informative

map visualizations

and we go ahead and quickly take a few

look at a few examples of this

so using arcade Expressions

we can create conditional symbology

based off of data values we can use

arcade Expressions to create Dynamic

charts or graphs and we can use arcade

Expressions to display data in a

creative way

so this example here is going to

calculate the population density per

square mile for a feature and then it's

going to define a gradient color ramp to

symbolize different levels of the

population density and the results is a

conditional symbology that colors the

feature according to their population

density with lower density features

having lighter colors and higher density

features having darker colors

and this next expression is going to

define a dictionary

project land use symbols which

Associates different types of land use

with specific symbols for for example if

the land use type attribute of this

feature is residential the expression

will return house

um we can create custom symbols or

patterns to display data in a more

visually appealing way and this arcgis

arcade code is going to define a custom

symbol for water bottle bodies and

return the custom symbol for the water

features while using the default symbol

for other features

and then there's some Advanced

visualization techniques that we can do

there's the ability to create some you

know transitions or animations create

interactive visualizations and you can

combine multiple visualization

techniques to make your Expressions more

advanced

so looking at some of the best practices

make sure you're choosing a clear and

appropriate color scheme that's you know

easily read and understood use

consistent symbology and visualization

techniques throughout your maps and make

sure to test your visualizations based

on different devices and screen sizes to

make sure that they're legible and

impactful

and with that I'm going to go ahead and

hand over to Gustavo and we will go

ahead and take a look at some of this in

action

in the last 20 minutes or so we're just

gonna take a look at some of the things

that Philip mentioned in practice here

um and this this is not really intend to

make an expert in all the functions

available or the variables or anything

like that it's more where is arcade

available and how can I start writing

writing some code in those profiles

um and I want to start with

documentation here just to make sure

that after the

uh the session here if anyone has to

leave early you are aware there is a

really good documentation all the tops

that we're going through

um I also want to talk a little bit

about this idea of a profile within

arcade because depending on what you're

trying to

um change if it's the label or the

visualization or the pop-up those are

different profiles

um that you're going to be working with

and you can see here a list of those

profiles and where they are available

so for example if you're doing something

in Arches dashboard maybe you're not

going to see any options to do attribute

rules there it's just going to be

something more on the visualization side

of things just to earn hypothetical

example and some same thing with some of

these other ones right if you're working

with maybe Geo trigger you're not going

to see anything related to pop-up here

so it kind of

what you're going to see on the on the

editor it's going to be a little

different and I can show that in our

chest online in a second but I just want

to make sure that we talked a little bit

about that and then like I mentioned the

beginning I'm not going to go through

any specific functions here today but if

you have done any JavaScript or python

before you're very familiar with a lot

of these functions if not if you're kind

of brand new to to writing any type of

code you can come here and you can find

specific functions that will help you

accomplish accomplish something

specifically you're trying to do

and then again if you don't want

um

create a whole project and if it's the

first time that you're getting you're

just getting started with this there's a

playground here where you can explore

some of the variables the functions and

type some code and see the the results

so if that's sad um I'm gonna start the

demo I also want to mention something if

you go to the arcgis blog you're going

to see there is a lot of what's new here

uh because in the last couple of days

they released a new

um release of arches online and I'm

gonna use a little bit of field maps

today and if you come here you're gonna

see that one of the things that changed

is arcade uh where you access things so

if I'm having a hard time finding a

buttons because it just just changed the

interface but I think I'm good because I

passed things this morning but there and

this is a good reminder too that arcade

is always evolving right it started more

as a visualization so kind of last

section that the field went through

there but then over time they added

support for label and pop-ups and and

now even as a developer you can kind of

have full control of the whole arcade

experience and include that in your apps

too

okay with all that said

um for the demo today here I'm gonna use

one of the arcgs solutions and I just

use the image assessment solution so if

you're not familiar with arches Solution

that's kind of another topic but

um it's basically pre-configuration of

different applications that Azure

provides so I'm using this just so they

are just online create some layers and

maps and applications for me and I don't

have to create those from scratch

and if I go to my content I can see a

lot of those items that were created

and um this is kind of the map that I

started with and I just made some simple

improvements here using arcade and

that's where I'm going to spend the next

10 minutes or so on going through so you

can see uh if I look at the label here

it's not the best format to to show the

label right it's not easy to understand

so I think we can make that look a

little better using arcade without I

think before maybe you would have to go

to schema create a new field and have to

change the type and find a way to to

make this a little bit more easier to

read but with arcade now we can kind of

do that

um without having to to go to the to the

scheme and add additional Fields the

data another thing if I click on one of

these features the pop-up is very simple

right now and it's gonna remain

basically the same I didn't really

customize the entire pop-up experience

but I'm going to add some maybe a title

in a description here so that it's a

little bit easier again to to understand

where I can use those sections to

provide some additional information even

if I if I don't want to mess with the

pop-up but if you want to take a step

further you could really customize this

have links and images and things that

I'm not going to go here today but just

want to mention that's possible

and then also when I'm editing things

um let's say I'm going to add a new

affected uh area here I'm going to show

how you can customize the form in in

field maps and how arcade can be helpful

there too so this form is very long

right now and I don't I don't know if

there's any automation here in terms of

capturing date and the user that's doing

the editing so those are some of the

things that we can do using RK too

um I think that's what I want to mention

this map I'm going to the second one the

one that I made the changes um you can

see that the date now it's a little bit

easier to read

maybe you wanted something different but

I think that's kind of the standard that

most people are used to if I click on

the icon here you can see now I have a

title um in the index is just a string

that I type the word index but then the

number here is being calculated with

arcade and this is just a hypothetical

number two it's nothing meaningful here

but for the purpose purpose of the demo

I'll show you how you can do some of

those calculations using arcade and in

this description is the same it's just a

string that I typed this whole kind of

first section here and then this value

here is dynamically based on the

features so if I click on this one you

can see now it's saying this one is

affected but everything else the same

the index change because there's some

numbers that I entered here are

different

so if I go to field maps now and I click

on this one this one is actually the

original one you can see I don't have

any form created here

um I could convert my entire pop my

entire set of attributes to uh the form

I can add additional things but I'm

gonna actually do a different uh

one here that I configured for this demo

so when I opened this map I have the

form that I configured just a couple of

fields and you can see that some of

these are using calculations and some of

these are also going to use functions

that will capture values without the

user having to enter that information so

that the

another thing that you can do too is

conditional visibility so this one you

can see there is a tag visible here

because I have some logic here that um

is

basically saying when this is going to

be visible and when it's not going to be

visible so here's the kind of first

arcade example

um it's just grabbing the the domain

name and then it equals major

um

then that that additional question will

be shown on the form if not then you

want that question won't clear and you

can you can type the code yourself if

you launch the editor but in this case

here there is also a nice user interface

that you can just select the options and

then it will kind of change that to you

so if I change this to minor you would

change that I'm not going to change this

to make sure that the demo works here

but you could change over here too

so that's conditional visibility and

that's one of the things that changed

with this last release of arches online

this was a little different before if

you have been here but now uh you have

this um kind of settings icon and that's

how you access things and it just looks

looks a bit a little different

predict so that's conditional visibility

you can also do calculations so if I if

you look at the calculated value here

and if I go again here and I it's using

this index

um if I go edit arcade

it's just a very simple expression

expression that's

um

grabbing the value and then multiplying

by by another right so it's grabbing the

impact the attribute impacted units for

that specific feature and then

multiplying by the areas of the image

um so that's another very simple and but

you can see if I expand this here now

uh that's the the the notion of working

with a profile

um I see feature and layer in data store

because those are things that are

available

in this profile here when I go to the

map viewer I'll open something for

example working with labels and you're

going to see that you're not going to

see the same options the functions they

might look very similar it's just kind

of comprehensive list of common

um functions that that you might be

using but the profile here are going to

be specific for for that uh

the application that you're using for

example

and then this one it's another

uh example of how to calculate something

but in this case

um actually it's

now if it's down here

in this case it's just using a function

to grab the user's name

so it's looking at the layer and then

just grabbing the the user that edited

this layer

um and then same thing for the date here

there is another arcade expression

called date that I created you can see

that it's using that because I I can

select and unselect things here but I

want to keep that date one and if I open

it's just it's a very simple function

called now that's just gonna

automatically enter the the date at the

time that this feature is being

collected or editing edited or whatever

the attribute is representing

so that's kind of what I want to show

here

um if I go back to my map I want to show

a couple additional things if I go to

the to the labels and I think uh

a challenge in the beginning when you're

starting work with arcade is just

knowing where the buttons are and it's

usually something that looks like this

or it's something that you're going to

see the word expression so let's say I

go to the pop-up

um and I'm editing my title you can see

this one looks a little different but

there is an icon here and in some cases

that there will be something that says

create an expression so let's go to the

symbolic you can see this one says

expression so it's just getting familiar

with uh those icons and where they are

but again if I go to the labels

um and I click here

and it's going to launch this and that's

how I change the the label it's just a

month function and then captures the

month from this date field then plus a

string just with a slash here in the day

the same idea slash and then the same

idea but if I expand this year now you

can see there's only one Global variable

available for for this right I can't

really do things with the the whole map

or the whole layer it's just the label

for the feature

um if I go to the pop-up let's take a

look here um

quickly if I click here

um and let's let's pretend we're adding

a new expression and I click on this now

you can see I can add things related to

the Future related to the label layer

that can have multiple features the

whole map or the data store and I can

expand this to look at some the

attributes right there in this case

because the the damage is set assessment

features and layers see they come with a

lot of attributes that's why there is a

very long list but it could be that your

layer will be just a few attributes here

uh same idea for the functions you can X

the functions here too

and we're kind of almost running out of

time here so

um I want to show something a little bit

more complex and this might be a good

way for you to get some ideas of what

can be done too if I go to the living

Atlas

um and I type for example here quality

I'm going to find some layers from esri

here this one you can see there is some

more interesting symbology I didn't want

to mess up with this in bulge for the

damage assessment because it's very

specific icons and colors based on

status but if we go to the

to the living Atlas grab a layer and you

like the symbology that it's been used

then you can click on that layer let's

look at this one here

let's go to symbolage and then let's

there is an arcade expression that sets

the symbol size based on the map scale

so if I click there you can see now

instead of my simple examples with just

one line of code it's something more

like what Philip showed on the slides

here right so there is variables being

declared some function and when being

used here for for different things that

I want to do with the symbology and then

return something in the end

um I think that's all that I'm gonna

show here the last thing that I want to

show quickly is that Philip mentioned

during the presentation that

one of the major benefits of arcade is

that I can write something like you saw

before I wrote something in field maps

but it's also available in my in the map

viewer and in any other applications

that I embed this map or that I create

to use in this map

um and that applies to desktop

environments too so if I look at my map

here now and I just went to my portal

I'm using rhs Pro so I can quickly open

um the everything that I have in Arches

online or arcgis Enterprise so portal

here it's not the polo that comes with

Enterprise it's just a web GIS borrow

then I found that web map

um

that I showed before in the map viewer

and then I just add to my project and

now you can see that the the symbolage

or the the label is the same and if I

click on the future that the title here

will be the index to just like before

right and if I want to make changes to

uh

uh things using arcmap I can do that too

so I for example I would select one of

this

um the one of the layers that I have and

then I'm I click on the labeling for

example and then the same idea here will

be expression or an icon

um

and then when I launch that you can see

that same function that I showed you

before and if I want to make any changes

maybe I want to delete some section of

this

it will change here and if I save and I

open that just online you that's the the

same experience that everything that I

see here is what I'm going to see there

too

oh thanks Gustavo

um just a couple of a couple of things

that were just just mentioned

um follow the blogs for for good

information uh we did just have a update

to arcgis online

um this post came out yesterday but we

had our February update you can read all

about all of the new functionality

um you know a big update that came with

the November release was that arcgis

arcade editor the Gustavo demonstrated

which makes it much easier in that kind

of Rich coding experience to be able to

build your expressions and test them

really easily so it should really take

away

um you know if you have any anxiety

about writing codes like I mentioned I'm

not a coder this makes it much easier to

be able to build those expressions and

kind of give that predictive

um you know kind of format as far as

trying to figure out what it is you're

trying to accomplish

um

and then you know there's there's plenty

of resources that we have available

there's there's the documentation

there's the playground there's tutorials

we have you know robust

um Community

um with with the forums for arcade

um there's you know webinars so there's

you know any any kind of entry point to

kind of get started I know I like you

know watching these these demos and

videos going back to the documentation

and trying stuff out

um to see if I can you know kind of

accomplish the same thing that some of

these other folks are doing

um and then always you know you can feel

free to reach out to either Gustavo or

myself

um you know if we have questions that we

can answer we can certainly do that and

if not we can always pass that along

back to the uh sort of subject matter

expert to make sure those questions get

addressed by the right people

and um I think that we are right at time

so I want to thank everybody once again

Andrew Gustavo and I are really you know

sorry we couldn't be there in person but

hopefully this was informative and we'll

encourage you to

um use arcade uh more uh you know across

the platform in your in your mapping

Endeavors so once again just want to

thank everybody and hope that everybody