Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://developers.arcgis.com/python/guide/part2-where-to-enrich-study-areas/ below:

Part 2 - Where to enrich? (what are study areas?) | ArcGIS API for Python

GeoEnrichment uses the concept of a study area to define the location of the point or area that you want to enrich with additional information or create reports about. The accepted forms of study areas are:

1. Street address locations
   • a. Single line input
   • b. Multiple field input
2. Point, line and polygon geometries
3. Buffered study areas
4. Named statistical areas

Before we look at the exmaples of study areas, let's understand the concept of Data collections and analysis variables. We will look at Data collections in detail in a later section.

GeoEnrichment uses the concept of a data collection to define the data attributes (analysis variables) returned by the enrichment service. A data collection is a preassembled list of attributes that will be used to enrich the input features. Collection attributes can describe various types of information, such as demographic characteristics and geographic context of the locations or areas submitted as input features. We will introduce the concept of data collections here and look at the details in the next guide.

The Country class can be used to discover the data collections, sub-geographies and available reports for a country. When working with a particular country, you will find it convenient to get a reference to it using the Country.get() method.

The data_collections property of a Country object lists a combination of available data collections and analysis variables for each data collection as a Pandas dataframe.

Once we know the data collection we would like to use, we can look at all the unique analysisVariable available in that data collection.

# Import Libraries
from arcgis.gis import GIS
from arcgis.geoenrichment import Country, enrich, BufferStudyArea

# Create a GIS Connection
gis = GIS(profile="your_online_profile")

# Get US as a country
usa = Country.get("US")
type(usa)

arcgis.geoenrichment.enrichment.Country

df = usa.data_collections

# print a few rows of the DataFrame
df.head()

# call the shape property to get the total number of rows and columns
df.shape

Each data collection can have multiple analysis variables as seen in the table above. Every such analysis variable has a unique ID, found in the analysisVariable column. When calling the enrich() method, these analysis variables can be passed in the data_collections and analysis_variables parameters.

You can filter the data_collections and query the collections analysis_variables using Pandas expressions.

# get all the unique data collections available for the current country
df.index.unique()

Index(['1yearincrements', '5yearincrements', 'Age', 'agebyracebysex',
       'agebyracebysex2010', 'agebyracebysex2020', 'AgeDependency', 'AtRisk',
       'AutomobilesAutomotiveProducts', 'BabyProductsToysGames',
       ...
       'travelMPI', 'unitsinstructure', 'urbanizationgroupsNEW', 'vacant',
       'vehiclesavailable', 'veterans', 'Wealth', 'women', 'yearbuilt',
       'yearmovedin'],
      dtype='object', name='dataCollectionID', length=118)

The snippet below shows how you can query the Age data collection and get all the unique analysisVariables under that collection.

df.loc["Age"]["analysisVariable"].unique()

array(['Age.MALE0', 'Age.MALE5', 'Age.MALE10', 'Age.MALE15', 'Age.MALE20',
       'Age.MALE25', 'Age.MALE30', 'Age.MALE35', 'Age.MALE40',
       'Age.MALE45', 'Age.MALE50', 'Age.MALE55', 'Age.MALE60',
       'Age.MALE65', 'Age.MALE70', 'Age.MALE75', 'Age.MALE80',
       'Age.MALE85', 'Age.FEM0', 'Age.FEM5', 'Age.FEM10', 'Age.FEM15',
       'Age.FEM20', 'Age.FEM25', 'Age.FEM30', 'Age.FEM35', 'Age.FEM40',
       'Age.FEM45', 'Age.FEM50', 'Age.FEM55', 'Age.FEM60', 'Age.FEM65',
       'Age.FEM70', 'Age.FEM75', 'Age.FEM80', 'Age.FEM85'], dtype=object)

# View a sample of the `Age` data collection
df.loc["Age"].head()

Now, let's look at some examples of enriching each of the study areas.

Street address locations can be passed as strings of input street addresses, points of interest or place names. A street address can be passed as a single line or as a multiple field input. If a point (e.g. a street address) is used as a study area, the service will create a 1 mile ring buffer around the point to collect and append enrichment data.

The example below uses a street address as a study area for enrichment using Age data collection.

# Enriching single address as single line imput
single_address = enrich(
    study_areas=["380 New York St Redlands CA 92373"], data_collections=["Age"]
)

1 rows × 48 columns

The returned spatial dataframe can be visualized on a map as shown below:

A buffer of 1 mile is created by default, as seen on this map, for any address.

# Plot on a map
address_map = gis.map("Redlands, CA")
address_map

single_address.spatial.plot(address_map)

Multiple addresses as single line input

# Enriching multiple addresses as single line input
enrich(
    study_areas=[
        {
            "address": {
                "text": "12 Concorde Place Toronto ON M3C 3R8",
                "sourceCountry": "Canada",
            }
        },
        {
            "address": {
                "text": "380 New York St Redlands CA 92373",
                "sourceCountry": "USA",
            }
        },
    ],
    data_collections=["Age"],
)

2 rows × 48 columns

enrich(
    study_areas=[
        {
            "address": {
                "Address": "380 New York Street",
                "City": "Redlands",
                "Region": "CA",
                "Postal": 92373,
            }
        }
    ],
    data_collections=["Age"],
)

1 rows × 48 columns

Enriching with various analysis variables for age such as FEM45, FEM50, FEM65 etc.

enrich(
    study_areas=["380 New York St Redlands CA 92373"],
    analysis_variables=["Age.FEM45", "Age.FEM55", "Age.FEM65"],
)

Point geometries can be passed as x and y coordinates to study_areas parameter. When points are specified as study areas, the service will analyze map areas surrounding or associated with the input point locations. Unless otherwise specified, the service will analyze a one mile ring around a point. This is also true for a line. Locations can also be given as polygon geometries.

from arcgis.geometry import Point

pt = Point({"x": -117.1956, "y": 34.0572, "spatialReference": {"wkid": 4326}})
enrich(study_areas=[pt], data_collections=["Age"])

1 rows × 46 columns

pt1 = Point({"x": -122.435, "y": 37.785, "spatialReference": {"wkid": 4326}})
pt2 = Point({"x": -122.433, "y": 37.734, "spatialReference": {"wkid": 4326}})

enrich(study_areas=[pt1, pt2], data_collections=["Age"])

2 rows × 46 columns

from arcgis.geometry import Polyline

line = Polyline(
    {
        "paths": [[[-13048580, 4036370], [-13046151, 4036366]]],
        "spatialReference": {"wkid": 102100},
    }
)
enriched_line_df = enrich(study_areas=[line], data_collections=["Age"])

1 rows × 46 columns

The returned spatial dataframe can be visualized on a map as shown below:

# Plot on a map
line_map = gis.map("Redlands, CA")
line_map

We can clearly see the line and a 1 mile buffer around the line in this map

# Draw line
line_map.content.draw(line)

# Plot enriched area around line
enriched_line_df.spatial.plot(line_map)

from arcgis.geometry import Polygon

poly = Polygon(
    {
        "rings": [
            [
                [-117.185412, 34.063170],
                [-122.81, 37.81],
                [-117.200570, 34.057196],
                [-117.185412, 34.063170],
            ]
        ],
        "spatialReference": {"wkid": 4326},
    }
)

enrich(study_areas=[poly], data_collections=["Age"])

1 rows × 42 columns

BufferStudyArea instances are used to change the ring buffer size or create drive-time service areas around points specified using one of the above methods. BufferStudyArea allows you to buffer point and street address study areas. They can be created using the following parameters: * area: the point geometry or street address (string) study area to be buffered * radii: list of distances by which to buffer the study area, eg. [1, 2, 3] * units: distance unit, eg. Miles, Kilometers, Minutes (when using drive times/travel_mode) * overlap: boolean, uses overlapping rings/network service areas when True, or non-overlapping disks when False * travel_mode: None or string, one of the supported travel modes when using network service areas

BufferStudyArea also allows you to define drive time service areas around points as well as other advanced service areas such as walking and trucking.

The example below creates disks of radii 1, 3 and 5 Miles respectively from a street address and enriches these using the 'Age' data collection.

buffered = BufferStudyArea(
    area="380 New York St Redlands CA 92373",
    radii=[1, 3, 5],
    units="Miles",
    overlap=False,
)
drive_dist_df = enrich(study_areas=[buffered], data_collections=["Age"])

3 rows × 48 columns

The returned spatial dataframe can be visualized on a map as shown below:

# Plot on a map
buffer_map1 = gis.map("Redlands, CA")
buffer_map1.basemap.basemap = "dark-gray-vector"
buffer_map1

drive_dist_df.spatial.plot(map_widget=buffer_map1)

renderer_manager = buffer_map1.content.renderer(0)
smart_mapping_manager = renderer_manager.smart_mapping()
smart_mapping_manager.class_breaks_renderer(
    break_type="size",
    classification_method="esriClassifyNaturalBreaks",
    num_classes=4,
    field="buffer_radii",
)

The example below creates 5 and 10 minute drive times from a street address and enriches these using the 'Age' data collection.

buffered = BufferStudyArea(
    area="380 New York St Redlands CA 92373",
    radii=[5, 10],
    units="Minutes",
    travel_mode="Driving",
)
drive_time_df = enrich(study_areas=[buffered], data_collections=["Age"])

2 rows × 48 columns

The returned spatial dataframe can be visualized on a map as shown below:

# Plot on a map
buffer_map2 = gis.map("Redlands, CA")
buffer_map2.basemap.basemap = "gray-vector"
buffer_map2

drive_time_df.spatial.plot(map_widget=buffer_map2)

renderer_manager = buffer_map1.content.renderer(0)
smart_mapping_manager = renderer_manager.smart_mapping()
smart_mapping_manager.class_breaks_renderer(
    break_type="size",
    classification_method="esriClassifyNaturalBreaks",
    num_classes=3,
    field="buffer_radii",
)

In all previous examples of different study area types, locations were defined as either points or polygons. Study area locations can also be passed as one or many named statistical areas. This form of study area lets you define an area as a standard geographic statistical feature, such as a census or postal area, for example, to obtain enrichment information for a U.S. state, county, or ZIP Code or a Canadian province or postal code. We will explore Named statistical areas in detail in the next section.

Enriching zip code 92373 in California using the 'Age' data collection:

redlands = usa.subgeographies.states["California"].zip5["92373"]

arcgis.geoenrichment.enrichment.NamedArea

<NamedArea name:"United States" area_id="92373", level="US.ZIP5", country="United States">

redlands_df = enrich(study_areas=[redlands], data_collections=["Age"])

1 rows × 45 columns

The returned spatial dataframe can be visualized on a map as shown below:

zip_map = gis.map("Redlands, CA")
zip_map

redlands_df.spatial.plot(zip_map)

Here is an example of each case:

ca_counties = usa.subgeographies.states["California"].counties

counties_df = enrich(study_areas=ca_counties, data_collections=["Age"])
counties_df.head()

5 rows × 45 columns

counties_df2 = usa.enrich(
    study_areas=list(ca_counties.values()), data_collections=["transportation"]
)
counties_df2.head()

5 rows × 255 columns

county_map = gis.map("California")
county_map

counties_df.spatial.plot(map_widget=county_map)

county_map.legend.enabled = True

In this part of the arcgis.geoenrichment module guide series, you were introduced to the concept of study areas and how Geoenrichment uses a study area to define the location of the point, polyline or area that you want to enrich. You have also seen in detail how different types of study areas can be enriched and visualized on a map.

In the subsequent pages, you will learn about:

1. Exploring Named Statistical Areas (explains where to enrich continued)
2. Data Collections and GeoEnrichment coverage (explains what datasets/variables to enrich with)
3. Generating Reports
4. Standard Geography Queries

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4