SM_XXXXX: Internal Functions to utilize boundary data and create maps.

In SeerMapper: A Quick Way to Map U.S. Rates and Data of U.S. States, Counties, Census Tracts, or Seer Registries using 2000 and 2010 U.S. Census Boundaries

Description

Provides support for SeerMapper and other packages that can use the SeerMapper core functions and boundary datasets to map state, registry, county or tract sub-areas in the U. S. Based on the location IDs provided loads into memory the U. S. state and registry boundary data, determines the sub-area level being mapped, then loads the county and (if needed) census tract boundary data for any state containing a sub-area with data and maps the data and requested boundaries.

Usage

SM_Mapper(rPM,MV)

Arguments

rPM	This a named list of SeerMapper variables and call parameter values used by the internal functions of SeerMapper.
MV	This a named list of SeerMapper boundary data and location IDs to support the requested map.

Details

Three functions are exported by SeerMapper for use by other packages offered by this author. These functions are internal functions and not designed for general use. The three exposed functions are: SM_GlobInit, SM_Build, and SM_Mapper. Each uses the rPM and MV named lists to receive and return information to the caller. SM_GlobInit builds the initial rPM named list and populates it with default values. SM_Build receives the rPM and MV named lists, validates the location ID supplied, sets the level of the boundaries needed, loads the boundaries from the datasets contained in the packages of SeerMapper, implements the expanded boundaries to be drawn beyond the data sub-areas, and returns the loaded boundaries in the MV named list. SM_Mapper receives the rPM and MV and based on the information provided, creates the map. The functions are very depended on the information in the rPM and MV begin correct, the use of these functions or modification to there data structures is not recommended.

Value

The functions returns named list containing the rPM named list (SM_GlobInit, SM_Build), the MV named list (all three functions) and a named list of the graphic x and y limits used in the mapping.

Author(s)

James B Pearson and Linda Pickle, StatNet Consulting, LLC, Gaithersburg, MD

SeerMapper documentation built on Jan. 15, 2021, 3:16 p.m.