Managing Plans

Step 1. Plan

Upon logging in, you will view the Step 1: Plan tab. This area of the website is for managing the redistricting plans available to you to edit (if logged in with an account) or view (if visiting as a guest). In the redistricting world, a plan is a complete set of districts for a state or locality. You are not required to create a complete plan for all the districts, you could, for example create a plan that has only a single district. We treat all partial or complete plans the same.

You must select a plan to edit before you can start mapping. As you look at the Step 1. Plan Tab, you will notice that there are four numbered steps that you need to take to start drawing your first map.

We will walk through these four steps in turn, below.

Action 1. Select Legislative Body

The web site administrator will set up one or more legislative bodies for you to draw districts for. For a typical state, the following legislative bodies will be available. 

The administrator may make other legislative bodies available for editing. For example, if configured for local redistricting, county supervisor, city council, or school districts may be available.

The administrator configures these legislative bodies for you so you can get started mapping without having to set parameters for each legislative chambers' districts, such as the ideal population size for the districts and the target number of minority-majority districts. Only administrators have the ability to change the available legislative bodies.

Action 2. Select Plan Type

The next step is to select a type of plan to edit. There are four different types of plans that you can interact with.

If you click on Temple, Shared or My Plans, the list of plans in the Action 3. Select Plan will change accordingly to show you the available plans in each category.

Upload Plan

You can upload plans generated from other redistricting software, such as those produced by commercial vendors. These files must follow a special format. There are three important components to this format, the format of the records, that the file have an extension ending in .csv, and that the file must be zipped.

First, the records must conform to a special format. Here is an example of how the records must look:

517000323003033,2

511990510003000,2

511990505001007,2

510950801014019,2

511990510001189,2

517000315003007,2

The first 15 characters is a unique identifier for each census block. (For more information about census data, see here). It is a concatenation of the state, county, tract, and census block codes. (Tip: these codes must be in string format. If they are in a numeric format, leading zeros may be truncated. If you load this information into another file, be careful to preserve this unique identifier as a string.)

A comma separates the census block identifier with a district code, the district that is associated with each census block.

Second, the file must have a .csv extension for the file name. For example, the file name "foo.csv" is acceptable. The extension .csv is a common naming convention for comma separated files.

Third, the file must be zipped, or compressed. There are many free programs that zip files.

There are six steps to upload a plan.

It will take a few minutes for the software to load the plan. The amount of time will depend on a number of factors, including how many other people are using the software. If for some reason you do not receive an e-mail, check back in a few minutes to see if your plan shows up in the "My Plans" list. You can work on another plan while the plan is being uploaded.

Download Plan

There are two methods to download a plan. The first method is available on the Step 1. Plan tab and the second method is on the Step 4. Share tab.

Method 1, from the Step 1. Plan tab.

Once a plan is selected (see Action 3. Select Plan, below), a "Download" button will be visible. Click on this button and the software will generate a file in the same format as described in the Upload Plan instructions, above.

It may take the software up to a few minutes to generate the requested file. Once a file has been requested once, it is cached and should be available for download immediately when subsequent requests are made. When the file is ready for download, a dialogue box will open guiding you on where to save the file.

Method 2, from the Step 4. Share tab.

A file for download may also be requested from the Step 4. Share tab by pressing the "Request File" button.

Action 3. Select Plan

The plans that are available for editing are displayed in the Action 3. Select Plan area. The name of the plan, the author, and the last editing date/time are displayed. For "My Plans" a check box is also displayed identifying if a plan is a shared plan, visible to everyone.

Navigating Lists of Available Plans

By clicking on the the Name, Author, and Last Edited headers, you can sort the plans available to you accordingly. (You may also sort by shared status for My Plans.) If there are many plans, navigation buttons at the bottom of the list of plans will be available. Clicking ►> will move your forward (or backward) one page of plans, Clicking ►| will move you to the end (or beginning) page of plans. You may also enter a page number and press return to go to that page of list of plans.

You may search for a plan by entering the search string into the text box in the upper right of the Select Plan area and pressing return.

Action 4. Name your new plan/Start Drawing

If you have selected a Template or Shared plan, you must name your plan before you can continue.

To do so,

If you have selected a plan in the My Plans list, you have already given the plan a name so you do not need to do this step. You will be presented with two options, to edit the plan and to make a copy.

To edit the selected plan

Copy Plan

It is possible to make a copy of a plan that is in the My Plans list. You may find this useful if you are at a point in creating a plan where you want to explore different options.

To do so,

Edit Plan Description

If you select an existing plan from the plan list, additional information in the Plan Details area will be available describing the plan: the owner, the time stamp of when the plan was last edited, if it is shared, the number of districts in it, and a "Description." If a plan is owned by you, you may edit the description by clicking the "Edit Details" button. You can then enter or modify text in the description box. When satisfied with your new description text, click the "Save" button that will appear after you clock "Edit Details".