Defining variables in Esri Redistricting

Esri Redistricting is a fully configurable application. In this topic, you will learn how to configure variables, define the demographic sets to which the variables belong, the order in which the demographic set is displayed, and information about each variable.

The variables are displayed in the Demographics dialog box that users can select when creating a new plan if you have enabled the New Plan wizard.

Understanding the variable file

Learn how the import file is organized and how to configure the file so that it can be processed by Esri Redistricting. The import file must be a CSV.

Dx vars file example
Dx vars file example

The table below describes the values in each column that define how the demographics are configured in Esri Redistricting, also referred to as dx_vars.csv.

Note:

There are no column headers in the CSV. Variables begin on row 1.

CVS ColumnDescription ValueExample Value

A

The order placement of the demographics set (folder) in the demographics pane.

3

B

Demographic Set (folder) name.

Standard

C

The demographic variable name.

Note:

This value must match exactly what is in the geodatabase.

ASIANNH

D

Field designation that falls into one of three values:

  • R = Used only for the Universe-TOTAL value

  • O = Used when the field does not have a percent value associated.

  • OWP = Used when the field has a percent value associated.

OWP

E

Field percent variable. This is the percent field name for the variable. This is only required for the OWP field designation.

ASIANNHP

F

The field that is the denominator value for the percent equation. This is only required for the OWP field designation.

TOTAL

G

Short description of the variable.

Non-Hispanic Asian

H

Long description of the variable.

All individuals who chose Not Hispanic Asian either singly or in combination with white and chose Not Hispanic.

Applying the variable file

Esri Redistricting Enterprise implementations can update the variable file (also known as dx_vars) through the Administration Console to ensure the appropriate variables are available to Esri Redistricting users.

Application Setup dialog

Application Setup dialog

  1. As an Administrator, log in to the Administration Console.
  2. Click Setup.
  3. Next to Upload Variable CSV, click Choose File.
  4. Navigate to and select the input variable CSV for upload.
  5. At any time, you can download a copy of the current variable CSV for your records or to make updates.
  6. Click Save.
  7. Once the uploaded variable file is saved, you can launch Esri Redistricting Enterprise to see the updated variables.

Download the variable CSV

From the Administration Console, you can download the current variable CSV so that you can make updates to the current variable configuration.

  1. As an Administrator, log in to the Administration Console.
  2. Click Setup.
  3. Next to Upload Variable CSV, click Download Variable CSV.