messages-BG | R Documentation |
The BuildBorderGroup function verifies the call parameters and the incoming data. It then produces the data structures required by micromapST to draw maps for custom geographic areas. The user must provide a shape file and a name table for the function to product the user's custom border group dataset. This chapter documents the error and warning messages created by the BuildBorderGroup function when a problem or error is discovered before R has a chance to abort the execution of the function.
Like micromapST messages, BuildBorderGroup messages all start with "***" to help quickly find them in the warnings() logs and general output.
The general format of the messages is:
***XXXX text of message
where the XXXX is the unque four alphanumeric message identifier of the message. This chapter attempts to provide insight into the cause of the message and possible ways to resolve the problem.
Messages with numbers ranging from 3000 to 3999.
Conventions: The user provides the shape file and the name table to the function. The messages attempt to provide specific information on the problem detected. So, parts of the message will be modified to provide more specific information. In the messages below <name> type fields are used to identify the variable information in the messages.
Any values in the message that are replaced by more specific information are shown as <namefield>. The explanation for the message and suggested means of resolution will reference the <namefield> variable to help define what the message is associated with in the operation of the BuildBorderGroup funcition.
The following is a listing of all micromapST generated messages and a description of possible causes and solutions.
BuildBorderGroup Messages:
Debug Call parameter:
debug call parameter is not a numeric value.
The default value of <default debug> will be used.
The value provided for the debug call parameter is not a numeric value. It must a number between 0 and 65535. The debug parameter will be set to the default value of 0.
checkPointRestart
The checkPointReStart call parameter is not a
logical value.
The checkPointReStart call parameter must be a logical variable with a value of TRUE or FALSE. The default value is FALSE.
Check Point Restart has been requested. Check
point files
will be read from folder:
<name table directory>/Checkpoint directory.
The checkPointReStart call parameter was set to TRUE and the BuildBorderGroup function will attempt a restart using the <name table directory> and the Checkpoint subdirectory to locate the check point files. If valid, the files will be reloaded and the BuildBorderGroup process will be continued to completion.
General Call Parameter
Require call parameters are missing :
<list of parameters> - execution stopped.
BuildBorderGroup requires several call parameters to run. The <list of parameters> string presents to operate properly. The minimum set of call parameters is: NameTableFile, BorderGroupName, and ShapeFile. If no directories are specified either the value of the NameTableDir will be used or the current working directory. The function must have enough information to locate the initial name table (.csv or spreadsheet format) and the shape file(s) (.shp, .shx, .dbf)
Name Table Directory
NameTableDir call parameter is missing or NULL. Correct
and re-run.
The NameTableDir parameter must be a character string that provide
the directory path information to the directory containing
the Name Table file.
NameTableDir call parameter is an 'NA', Empty or not
a character string. Value= <NameTableDir> Correct and re-run.
The NameTableDir parameter must contain a character string
with length > 1 of an existing path to the directory that contains
the Name Table File. The value was found to be NA, ""(empty), or a
non-character variable. Correct the incorrect value and retry.
NameTableDir value specified does not exist.
Value= <NameTableDir>
The character string provided as the NameTableDir value is not a
valid path to the directory containing the Name Table File.
The path provided does not exist.
BorderGroup Files
BorderGroup directory specified in the call parameter
does not exist. It will be created. Value= <BorderGroupName>.
The BorderGroupDir parameter in the function call specifies a
non-existing directory.
The path provided will be used to create the BorderGroupDir directory.
The required BorderGroupName call parameter is missing.
The BorderGroupName parameter must be provided to be able to create
the final border group data set. Provide the required parameter and
rerun the function.
BorderGroupName is a 'NA', Empty or is not a character
string. Value= <BorderGroupName>.
The BorderGroupName parameter is not a character string or has a value
of NA. Neither can be used as the border group name. The value must be
a character string that is acceptable as a filename by operating system.
Inspect and correct.
BorderGroup directory specified in the call parameter is NA, Empty or not a character vector. The parameter will be ignored and the NameTable directory used. Value=<BorderGroupDir> The provided Border Group Directory is found to be NA, ""(empty), or a non-character variable. The parameter is ignored and the Name Table Directory is used instead. If the Border Group Directory was meant to point to a different location, correct the parameter and retry.
NameTable Files
NameTableFile parameter has not been provided.
Execution Stopped.
The name table filename for the name table data has not been
provided. Add the appropriate NameTableFile call parameter.
The name table passed to function on NameTableFile
parameter is not a valid variable type: <class of NameTable data>
The class of the NameTableFile parameter must be a data.frame or
a character string. It was found to be <class of NameTable data>.
Correct and rerun.
The NameTableFile parameter is set to 'NA', requires
a valid file name or structure.
The name table file parameter is set to a NA value. It must be a
valid data.frame or a character string indicating the name of the
name table file in the name table directory.
The NameTableFile parameter is empty. A name table
structure or filename must be provided.
For BuildBorderGroup to function, it must have the name or structure
of a valid Name Table. Without this, the border group can not build
a name table or complete the construction of a border group dataset.
Check on how to build a name table or check for typos in the
Name Table File value.
The NameTableLink call parameter is not a character
string. Fix and rerun.
The NameTableLink call parameter must be a character string that can
be used to reference a data.frame column read in from a .csv, spreadsheet
or R .rda and .RData files. Please inspect the link name and make sure
it is a valid column in the initial name table.
The NameTable file is not a .csv, Excel,
or R .RDA format.
The file containing the initial NameTable data must be a .csv,
Excel spreadsheet or R .rda file. Each column must be one of the data
columns required to construct the name table. (see name table section.)
#320x
Name Table Link
The NameTableLink call parameter is an 'NA', empty
(\'\' or \' \') or not a character string. Fix and rerun.
The NameTableLink identifies the name table column that will be
used to link the name table to the information and polygons in the
shape file structure. It was found have a value of 'NA',
Empty (\'\' or \' \') or was not a character type value.
The NameTableLink call parameter must be a character string that can be used to reference a data.frame column read in from a .csv, spreadsheet or R .rda file. Please inspect the link name and make sure it is a valid column in the initial name table.
# 321x
Shape File and Directory
Shape File parameter has not been provided or is NA.
The filename of the shape file has not been provided in the
BuildBorderGroup function call. Review the function call and make sure
the ShapeFile parameter is present and identifies
the base filename of the shape file to be used.
The extensions of .shp, .shx, or .dbf do not have to be specified.
The base filename will be used as the layer to be read.
The ShapeFileDir is used as the 'dsn' value on the st_read call.
ShapeFile is a sf structure passed as a call parameter.
The ShapeFile call parameter is a sf structure.
ShapeFile is a SPDF structure passed as a call parameter.
The ShapeFile call parameter is a SPDF structure.
The ShapeFile call parameter is being used to pass
a full spatial structure to the function. However, the structure
must be a SPDF or a sf class. The data was: <ShapeFile class>
The ShapeFile call parameter must be a character string,
sf structure or SPDF structure. The class of the ShapeFile value
is <ShapeFile class> and is not usable. Fix and retry.
Shape file directory specified in the ShapeFileDir
call parameter does not exist. Value= <ShapeFileDir>
The directory specified in the ShapeFileDir call parameter does not exist.
The value was <ShapeFileDir>. Make sure the character string is a valid
path to the directory containing the Shape File and that access is
permitted. When no value is provided, the directory specified for the
NameTableDir will be used. If no NameTableDir is provided,
the current working directory is used.
Shape file (dir & name) does not exist.
Value= <ShapeFileDir & ShapeFile value>
The path to the shape file (directory and name) does not exist.
The either the directory and/or the shape file filename does not exist,
is not accessible or does not reference valid ERSI Shapefile collection
containing a x.shp file. The extension of .shp is added to the
path to validate the directory and filename for ESRI Shapefiles
collections. Only the base filename is required in the ShapeFile
filename. If present it is removed when the shape file is read.
Check the path <ShapeFileDir & ShapeFile value> and make sure
it is valid and can be accessed.
The ShapeFile call parameter is an NA, empty(” or ' '),
or not a character string. The filename of the Shapefile must be specified.
The provided ShapeFile name has a value of NA, is empty (” or ' '),
or is not a character string. A valid filename must be provide for the
ShapeFile name. Correct and retry.
# 322x
ShapeLinkName parameter
The ShapeLinkName call parameter is missing. The default
value of NAME will be used.
For the shape file polygons to be used by micromapST, a linkage between
the name table and shape file must be established. The ShapeLinkName
call parameter is used to identify the shape file variable the function
can use to match data in the name table. The ShapeLinkName call
parameter is missing. The function will attempt to use the
default value of NAME to find a variable in the shape file.
If this is not correct, provide the ShapeLinkName parameter
with a value of the correct variable.
ShapeLinkName value is NA. The default of NAME
will be used.
The value in the ShapeLinkName call parameter is an NA value.
It must be a character string identifying the Shape File data
column/variable to be used to link the polygons to the
name table rows.
ShapeLinkName is not a character string.
Value= <ShapeLinkName>.
The value in the ShapeLinkName call parameter is not a character
string that can be used to access a variable in the shape file header.
Review the <ShapeLinkName> character string and correct.
#323x
Map Headers and parameters
The MapHdr parameter does not contain character strings
for use as the column headers. The MapHdr parameter will be ignored.
The MapHdr call parameter does not contain character strings.
Inspect and correct. The default of c("","Areas") will be used.
The MapHdr parameter must be a simple vector type.
The MapHdr call parameter must be a simple vector type variable with
1 or 2 elements. Data types of Data.frames, lists, tibbles, and other
advanced structures are not allowed. Correct and retry.
The MapHdr parameter has zero or more than 2 elements.
Only the first 2 will be used.
The MapHdr call parameter contains more that 2 elements.
For example: c('hdr1','hdr2','hdr3') Only the first 2 elements will be used.
It is suggested the max length of the MapHdr strings
be 16 characters.
The MapHdr values (2) should be less than 16 character to keep the
map type glyph columns from becoming too wide. Consider shortening
the character strings.
#324x
Map Minimum and Maximum Height
The MapMinH parameter does not contain numeric value.
Default Value is used.
The MapMinH (Map Minimum Height) parameter is provided, but does not
contain a numeric value. The default value of 1 inch is used.
The MapMinH minimum height value is out of range
(0.4 to 2.5 inch). The default will be used.
The MapMinH parameter value must be between 0.4 and 2.5 inches to be usable.
The default of 1 inch is used.
The MapMaxH parameter does not contain numeric value.
Default Value is used.
The MapMaxH (Map Maximum Height) parameter is provided, but does not contain
a numeric value. The default value of 1.75 inches is used.
The MapMaxH maximum height value is out of range
(1 to 2.5 inches). The default will be used.
The MapMaxH - value must be in the range from 1 to 2.5 inches. The default
value of 1.75 inches will be used.
The MapMinH value must be less than the MapMaxH value.
Will swap values.
The MapMaxH value must higher than the MapMinH value. The values are swapped.
#325x
ID Header and Parameters
The IDHdr parameter does not contain character strings
for use as the column headers.
The IDHdr call parameter must be a character string to be used
for the ID glyph column headers. The default header of the border group
name and Areas will be used.
The IDHdr parameter must be a simple vector type.
The IDHdr parameter value must be a simple one dimensional vector
with 2 value, like the MapHdr parameters. The default of the border
group name and "Areas" will be used.
The IDHdr parameter has more than 2 elements. Only
the first 2 will be used.
The IDHdr parameter has more than 2 values (elements) in the vector.
Only the first 2 values will be used for the IDHdr headers.
It is suggested the max length of the IDHdr strings be
12 characters.
To keep the ID glyph column from becoming too wide, it is recommended
the IDHdr string be limited to less than 12 characters each.
# 326x
Reduction Percentage Parameter
The ReducePC parameter must be a numeric value. The default
of 1.25 % will be used.
The ReducePC (Reduce Percentage) parameter is not a numeric value. The
default value of 1.25% will be used. This parameter indicates how much
of the original spatial information will be kept when the geometry
is simplified by the rmapshaper package.
The ReducePC parameter is not a simple vector. The default
value of 1.25 % will be used.
The ReducePC parameter can only be a single value. The default value
of 1.25 % will be used.
The ReducePC parameter has more than one value. Only the
first value will be used.
More than one value is provided with the ReducePC parameter.
Only the first value will be used.
The value of ReducePC is out of range (0.01 to 100 %).
The default value of 1.25 % will be used.
The value of the ReducePC parameter must be between 0.01 and 100 percent.
It is out of range. The default value of 1.25 % will be used.
# 326x
LabelCex Call Parameter
The LabelCex parameter must be a numeric value. The default
of 0.25 will be used.
The value of the LabelCex call parameter must be numeric. The default
of 0.25 will be used instead.
The LabelCex parameter must be a simple vector. The default
value of 0.25 will be used.
The LabelCex parameter value is not a single value vector but is a more
complex data type. The default value of 0.25 will be used.
The LabelCex parameter has more than one value. Only the
first value will be used.
The LabelCex parameter contains more than one value. Only the first
value will be used.
The value of LabelCex is out of range (0.05 to 10). The default
value of 0.25 will be used.
The LabelCex parameter value must be between 0.05 and 10. It is out of range
and the default value of 0.25 will be used.
# 328x
proj4 Parameter
No projection provided in the shapefile or the proj4
call parameter,will be set to a Long/Lat projection.
No projection was found in the shapefile or structure provided the
function or in the proj4 call parameter. The boundary data is
assumed to be longitude/latitude values and the projection
in the spatial structure will be set to a Long/Lat projection.
The proj4 call parameter set to NA or Empty(”) or
is not a character string. The parameter will be ignored.
The proj4 call parameter must be a valid character string in the
proj4 projection syntax. A value of NA is not acceptable and the
proj4 call parameter will be ignored.
3304 The proj4 call parameter is not a valid
character string or 'crs' structure for a projection. The proj4 parameter
will be ignored. The default AEA projection will be used in needed.
The function was unable to process the provided proj4 projection character
string using the st_crs function. The parameter will be ignored.
A generic AEA projection based on the center of the map and its height
will be used to transform the map for use in the link micromap.
Invalid proj4 parameter value provided. Parameter
will be ignored.
When trying to process the proj4 projection string using the
sf package st_crs function, a error was raised. The proj4 string
can not be process properly and will be ignored.
The proj4 call parameter specifies a long/lat
projection.
proj4: <proj4>
The final projection can't be a longlat projection.
The proj4 parameter is ignored and a AEA projection will be created.
The proj4 call parameter specifies a long/lat projection (see <proj4>
for details). The final projection of the map for linked micromaps
should not be long/lat. Therefore, an Albers Equal Area projection
is calculated based on the centroid of the map with secondary
latitudes 1/4 the maps height above and below the centroid.
The proj4 call parameter does not have +units=m,
changing string to meters.
The proj4 call parameter projection does not have a component of +units=m
to set the projection to meters as required. Since this projection
will be the final projection of the map, the +units has been changed
to m to force the final projection to be in meters.
# 330x
Shape File Processing and Call Parameter
The Shape file SPDF structure was passed to the function
in the call.
This message is an informational message to document the shape file
(as a SpatialPolygonsDataFrame) was passed to the function instead
of passing the directory and name of the shape file.
Reading shape file from dir: <SFDir> file: <SFName>
The function is going to read the shape file from the directory <SFDir>
and layer name <SFName> using rgdal\'s readOGR function
with verbose = TRUE.
The sf st_read can not import the shapefile as specified.
The errors reported were: <res1> <res2>
In the attempt to read the shapefile, the function attempts to use the dsn= parameter on the st_read for the directory to the shape files and the layer= parameter to specify the specific shape file. This is one of two modes the st_read function can use depending on the driver it selects. If this mode does not succeed, the function will attempt to use the mode where the layer= is not used and the dsn= parameter must contain the entire directory and filename, minus the extentions. If either are successful, this message is generated and the two error messages are reported in <res1> and <res2>. Review the error messages and correct the directory name used, the filename referenced and make sure both exist.
Spatial Driver found in boundary data file read
was <SReadDriver>.
The <SReadDriver> was identified during the st_read of the Shape File.
The shape file structure was passed to the function
in the call.
The type of data passed to the function in the ShapeFile parameter
indicates the user is passing a spatial structure rather than a filename.
The type of structure will be validated.
The spatial structure passed to the function via the
ShapeFile parameter is not a SPDF or a sf full structure.
Please correct and try again.
If a spatial structure is passed to the BuildBorderGroup function,
it must be a SPDF or sf structure containing the data information.
The data information is required to be able to match the
polygons in the structure to the rows in the name table.
The projection field in the shapefile is empty,
set to <OrigLongLat>
The proj4string slot in the SpatialPolygonsDataFrame for the shape
file is empty. The projection for the shape file is assumped to be
a long/lat projection and will be set to a long/lat projection of <OrigLongLat>.
Checking Shape Link Name Column: <ShapeLinkName>
Checking to make sure the shape file data.frame header contain a variable by
the name of <ShapeLinkName> as specified
on the function call.
The ShapeLinkName provided: <ShapeLinkName> does not exist in
the shape file data.
The shape file variable <ShapeLinkName> does not exist in the data.frame header.
Check for the existence of the variable and for possible spelling errors and return.
Shape file link variable name is valid, values will be
cleaned up and stored in variable X__Link.
The specified Shape File link variable name was found in the
SpatialPolygonsDataFrame. Its contents will be cleaned up and saved
in variable X__Link for later use.
# 331x-2x
Name Table General Issues
The Name Table was read from: <NameTableType>
<NameTablePath>
The initial name table file will be read from <NameTablePath>
containing the directory and filename. The name table file type
is <NameTableType>.
The Name Table Path provided to read the Name Table does not exist. Value=<NameTablePath>. The Name Table Directory and Filename to read the Name Table does not exist. Please check the Name Table file's location and try again. The Name Table must be accessible to run the BuildBorderGroup function.
The NameTable in the .rda file is not a data.frame.
Please correct and retry.
The initial name table can be constructed and saved in the R .rda
format file. When read, the contents of the file is not a data.frame
structure and cant be used. Research the cause and correct.
There are more than one data.frame in the .rda
file provided for the NameTable. Provide only one data.frame table
in the .rda and retry.
When the .rda file was opened for use as the name table data.frame,
more than one was found. The .rda should only contain one data.frame
for use as the name table.
Name Table Link column is: <NameTableLink>
The function will use the <NameTableLink> column to pair up the name
table rows with the collections of polygons in the shape file.
The Name Table has no columns of data.
The name table as read, does not contain any data columns or meaningful column
labels. Research and correct.
The Name Table has no rows or areas.
The name table as read, does not contain any area rows. There must be one
row per area in the map. Research and correct.
The column specified in the NameTableLink calling parameter
does not exist in the loaded Name Table.
The value specified in the NameTableLink call parameter is not the name of a column
in the read initial name table. If the Link column exists, it will be used as
the NameTableLink column to match the name table areas to the shape file polygons.
At least one of the following columns must be present in the
NameTable file: <List of Column Names>
Please correct the spreadsheet and
try again.
One of the columns named in <List of Column Names> must exist in the name table.
If none of the columns exist, then the initial name table is not valid and needs
additional work to permit the building of a border group.
The following columns are not needed and will be deleted from the
Name Table:
Extra columns were found in the name table. These columns are listed below and
will be deleted. Check for typos to make sure all of the required information
is retained.
# 350x-5x
Name Table Name, Abbr, ID, Alias and Alt_Abr data errors
The <inx> column contains duplicate entries. Correct and retry.
The column identified by <inx> was inspected and found to contain duplicate values
(entries). Duplicates are not allowed in location ID columns that must be unique
for each row. Research the values in column <inx> and correct.
The <inx> column contains NA or blank values that are not
allowed.
The column identified by <inx> contains blank values or NA values. These values
are not permitted in location ID type columns. Research and correct the values.
The Abbr column in the Name Table is not included.
Will attempt to backfill it from other information.
The Abbr location id should be supplied in the name table whenever
possible. If it does not exist, it will be created using other
information provided in the the name table.
The Name Table Abbr field is persent - no backfill
required.
The name table abbr field was present. Processing continues normally.
Some of the Name Table Abbr values are longer than 5
characters. It is recommended the Abbr values be keep short.
It is recommended the character string values in the Abbr column be kept
to 5 characters or less. This keeps the location ID fields in the data
smaller and less work for the preparer and keeps the ID glyph abbr
label narrower to more statistics type glyphs to be presented.
None of the columns needed are present. The Link and
one of the Name, Abbr, and ID column should have been there. This should
never happen with the previous checks.
If this error message occurs, then something has happened during
the processing. This situation should have been caught earlier.
Research the name table and make sure all required columns are present.
Checking ID column in the name table to make sure the
values are numeric with leading zeros.
While the ID values of location ids are numeric, a lot of them have
leading zero. The IDs are check to ensure they are numeric, then
converted to character format and leading zeros added to help in
later comparisons.
The ID column is not present. A numerical sequence number
has been used to fill the column.
No ID colomn is present in the name table. An ID column consisting of
a sequence of 1 to n is used.
The ID data column is not all numeric values. Values
will be assigned.
Not all of the ID values are numeric or valid. The rows with bad
ID values will be replaced with new values.
Name Table L2_ID_Name column contains row(s) with NAs
or ” values. L2 feature disabled.
All of the rows in the Name Table L2_ID and L2_ID_Name columns must
have values for the L2 Feature to operate correctly. Inspect these
columns in the name table provided and correct.
Name Table L2_ID column contains row(s) with NAs
or ” values. L2 feature disabled.
All of the rows in the Name Table L2_ID and L2_ID_Name columns
must have values for the L2 Feature to operate correctly.
Inspect these columns in the name table provided and correct.
Name Table regName column contains row(s) with NAs or ” values. Region feature disabled.
All of the rows in the Name Table regID and regName columns must have values for the
Region Feature to operate correctly. Inspect these columns in the name table provided and correct.
Name Table regID column contains row(s) with NAs or ” values. Region feature disabled.
All of the rows in the Name Table regID and regName columns must have values for the
Region Feature to operate correctly. Inspect these columns in the name table provided and correct.
The Region Feature has been disabled. The number of regions defined
is either 1 or is equal to the number of areas.
For the Region feature to operate, there must be more than 1 region and less than the number
areas. If equal to 1 or equal to the number areas in the map, the Region function has no
value and is disabled.
#356x-359x
Name Table Modification Parameters
The Name Table in the <inxRN> area row and in the <inx> column
is not numeric and has a bad value of: <WrkVal>. Value set to the default. Fix and retry.
The data value in the row named <inxRN> for column <inx> has a value <WrkVal2> that is
a non-numeric value. Correct and rerun.
Data in row: <inxRN> for <inx> parameter <WrkVal2> is out of range.
(<low> to <high>)
The data value in the row named <inxRN> for column <inx> has a value <WrkVal2> that is
out of range. The acceptable range is from <low> to <high>. Correct and rerun.
# 362x
Map Labels and Coordinates
The MAPL column in the name table is not character data. Labeling
will not be done.
The map label must be a character string value. Labeling for the row will not be done.
If the MapL column is present with label(s), then MapX and MapY
must be present. One or the other is missing. Labeling is not done.
For each Map Label in the name table, there must be a valid MapX and MapY value
specifying the location on the map to draw the label. If all three are not present,
the label for that area will not be drawn.
MapL value is present and there are no valid MapX coordinates.
Labeling will not be done.
A map label for an area is present, but the MapX coordinate is missing or invalid.
The label will not be drawn. Correct the MapX and possibly the MapY values.
MapL is present and there are no valid MapY coordinates.
Labeling will not be done.
A map label for an area is present, but the MapY coordinate is missing or invalid.
The label will not be drawn. Correct the MapY and possibly the MapX values.
The MapL label for area <area name> should be 3 or less characters
to be usable.
It is recommended the map label string be shortened to 3 character or less to reduce
the space required to draw the label.
No MapLabel content - processing skipped.
The retired MapLabel column in the Name Table does not have any values. Converting
the MapLabel column into the MapL, MapX, and MapY columns will be skipped.
Some of the items in the MapLabel entry for <name table row>
are NA or blanks. Will be ignored.
The MapLabel entry for the <name table row> is blank or NA and can not be used.
The value is ignored.
The MapLabel value for <name table row> is not valid. Must be a
character string with three values separated by commas. The value is ignored.
The character string in the MapLabel field must consist of three values separated by
commas. The first value is a character string (the label) and the other two columns
are numbers representing the X and Y coordintates to draw the label. The X and Y
coordinates are in the units and origin of the original shape file.
The label value in the MapLabel entry for <name table row> is > 3 char.
Only first 2 characters will be used.
The recommend length of the map labels is 2-3 character. One or more of the labels are
greater than 3 character. Adjust the length of the map labels.
One of the coordinates in the MapLabel entry for <name table row>
is/are not a number. <MapX> or <MapY>
Check the MapX and MapY coordinates values, they must be numerical values.
One of the MapLabel coordinates for <name table row> are out of range.
Entry ignored.
The values for the MapX and MapY coordinates must be within the range of the space covered
by the defined map in its original projection. If the values are outside of the map's area,
this error will appear. Inspect the coordinates and adjust as needed.
# 363x-364x
Shape File Projection
The projection provided in the Shape File does not have +units=m,
modify and setup for re-projection to change to meters.
The final projection must be in meters. The projection in the Shape File or
structure is not meters. A new projection based on the original is created
with +units=m. This projection will be used for the final transformation of the map.
Found +units=m in projection string of non-longlat projection
in the shape file.
The projection in the shapefile is not a long-lat projection and it is already in units of
meters. No modifications are required and no transformation will be needed.
#371x
Boundary data clean up
Cleaning up polygons in spatial structure.
The spatial structure will be passed through sf st_is_valid and st_make_valid
functions to clean up the polygon geometries.
Shape File contains invalid polygons. The indexes and associate reasons are\:
This is an informational message indicating the shape file geometry will be passed through
the sf package validation and make_valid function to clean up the geometry. S2 functions
are not used.
# 372x
Matching Shape File to Name Table
Comparing shape file to name table links
The link values in the shape file identified variable are being compared to
the values in the name table identified column. If there are any
polygons that do not have a matching name table entry, the polygon(s) will
be deleted.
The following Shape File areas are not in Name Table:
<List of Shape File areas not in Name Table>
The areas will be dropped.
Any area (polygon) in the shape file that does not have a row in the Name Table, will
be dropped from the final border group map.
# 375x
Linking Name Table to Shape File
Comparing the link values to tie the name table to the shape file.
This is the reverse comparison to comparing shape file links to the name table links.
If a name table area/row does not have a matching shape file set of polygons, then
the functions execution will be halted. Either provide the polygon(s) for the
area included in the name table or remove the name table entry.
The following Name Table areas do not have boundaries in the ShapeFile:
<List of Name Table Rows without polygons>
Correct and retry.
The BuildBorderGroup function can not continue if there is not an area(set of polygons) in
the shape file for the Name Table row. Execution stopped.
Some of the polygons in the Shape file still do not belong to
areas in the name table. Polygon(s) are ignored.
Not every polygon is linked to an area in the Name Table. These polygons will
remain in the map, but will be ignored. If multple ignored polygons share the
same boundary, the boundary may not be drawn.
# 376x
Shape File Simplification
Simplifying the shape file boundary data with rmapshaper.
This message is a progress report to indicate the processing has called rmapshaper to
simplify the spatialpolygon data.frame (shape file) to the ReducePC specification
with a weighting of 0.9. Check the results to see if the map is over simplified or not
simplified enough. Change the ReducePC call parameter and rerun until the map becomes usable.
rmapshaper parameters before simplification : Keep= <MS_Keep>
Weight= <MS_Weighting>
The rmapshaper ms_simplify function parameters for the MS_Keep and MS_Weighting
are listed to document the amount of boundary reduction and smoothing. See the
rmapshaper ms_simplify documentation for more details.
rmapshaper processing completed.
The rmapshaper ms_simplify function has completed its work and has returned a
modified spatial structure.
Map area aggregation completed.
After the rmapshaper ms_simplify completes its work, the polygons in the spatial
structure are aggregated into multipolygons to create one rows per area
in the sfc structure. This message signals the aggregation step has been
completed. The number of features in the sf structure are now equal to the
number of areas in the name table.
# 377x
Area Size Inspection and Name Table Modifications
The following areas may be too small (<0.03%): <ListOfAreas>
In general, if an polygon is less than 0.03
shaded for linked micromaps, it may not be visible to the graphs users. The list
of areas that may be too small are provided in the <ListOfAreas> string
in the message. Review the list of areas and a plot of the map and determine
if the areas should be enlarged or moved or manually manipulated to ensure their
shading can be seen easily. checkPointReStart call parameter allows the user to
intercept the shape file before the VisBorders data.frame format datasets are created
to make custom changes.
Info:No modifications are required to map.
The name table did not contain any shift, scale or rotate parameters for any areas
in the maps. No modifications were done.
# 379x
Name Table Modifications
Identifying neighbors for each area.
The function is now searching and identifying the neighbors for each area in the map.
This information is used in the color selection algorithm to keep two areas that
share the same boundary line from being colored the same color in the examples
and any future feature that is added to micromapST.
The list of neighbors for each area are in the name table 'NB' column.
The neighbor list is stored in the 'NB' column of the name table temporarily. This will be
save across the checkpoint restart for future use.
Info:No modifications are required to map.
The name table did not contain any modifications for areas in the map.
Area: <area key> will be adjusted using the <modification list> values.
<area key> area has parameters to have shifts, scaling and/or rotate modification done to the
boundaries.
Xoffset: <Xoffset> Yoffset: <Yoffset> Scale: <Scale> Rotate: <Rotate> in radians: <radians>
The name table contains the following values for each of the possible modification for the
identified area in # 3811.
Re-inserting area polygons for <area key>
The area <area key> has been modified and is being re-inserted into the map and
neighboring areas.
plot of original area before modifications in blue:
A screen plot was drawn of the area before modification with blue lines.
plot of main area after modifications in green:
A screen plot was drawn of the area after the modification with green lines.
Original neighbor boundaries in magenta for <neighbor area>
A screen plot was drawn for an neighboring area to the modified area before
adjustments were made with magenta lines.
Trimmed neighbor boundaries in seagreen for <neighbor area>
A screen plot was drawn of an neighboring area to the modified area after trimming
adjustments were made with seagreen lines.
Name Table modificiations to Shape file are completed.
All of the name table specified area modification has been completed.
# 381x - 382x
Area Coverage Analysis
These area coverage estimates were done after the name table
modifications. The area's coverage may have be increased or decreased from the
original Shape file. This coverage review is done against the current area's
coverage after all modifications. If an area's coverage is less than 0.057%
of the total map coverage of <TotalArea> * 0.00057 m^2 may not be large enough
to be visible in a in a linked micromap graphic. The area(s) that should
be reviewed is(are):
<list of areas that may be undersized.> This message provide a list of the areas that may not be visible when willed with the link color in the linked micromap. Investigate and adjust the area size as needed.
All of the area appear to be big enough to show the shading
in a linked micromap.
Verify all of the areas can be seen when the linked micromap color shades the
area.
# 384x
Final processing and transformation
Transforming projection of Shape file and label points.
This is a progress message to indicate, the function is about to perform any
requested or needed project transformations on the shape file and the label points in the
name table. If the resulting projection is not correct, check the value provided
via the proj4 call parameter and whether the default AEA projection based on the center
of the map is correct.
Using user provided projection: <proj4>
This message outputs the projection string provided by the BuildBorderGroup caller via the
proj4 calling parameter to help document the border group.
Re-transforming shape file using original projection, with +unit= changed to meters.
The original projection provided on the shape file did not have the +unit= proj4/6 parameter set
to meters. BuildBorderGroup assumes the projection of the shape file just prior to the conversion
of the boundaries to the VisBorders format is meters. The proj4 call parameter or the projection
contained in the shape file was inspected and a new projection created with the +unit= paremeter set to
m was created and used in the maps transformation before the VisBorders data.frames are created.
Projecting shape file using created AEA projection.
Since the shape file is a long/lat projection and no projection was provided via the proj4 call parameter,
the BuildBorderGroup function will calculate an Albers Equal Area projection based on the centroid
of the mapped area and secondary latitudes at 1/4 the map's height above and below the center latitute.
This results in all of the areas being presented with equal area (or shading area).
Transformations completed.
All of the transformation and projection modifications have been completed.
Info:No transformation was done to the map.
No transformations were required on the final map. The original projection is still
in use.
The proj4 value character vector is not a valid projection.
Must be a value acceptable to st_crs(). proj4 is ignored.
Verify the proj4 call parameter is correct and has the right syntax for the proj4 projection
specification. The proj4 parameter will be ignored.
# 386x
Generating Test Plot
The length of name table and the number of areas in the shape file are different.
The number of areas listed in the name table and the number of areas with polygons in the shape file
are different. Either the name table has more entried than the shape file or the shape file has
more areas then the name table. Correct and re-run.
# 387x
checkPointRestart Writes
The checkpoint files will be store in the Checkpoint directory : <CkptPath>
The directory used to save the check point files is <CkptPath>.
Checkpoint - Name Table RDA Filename: <NTCkpt> Name Table CSV
Filename: <NTCkptcsv>
The check point Name Table data.frame is save as a data.frame (.rda) in the <NPCkpt> file
and as a .csv file in the <NTCkptcsv> file.
Checkpoint - Shape File collection is: <SFCkpt> set of ESRI
Shapefiles and an RDA image: <SFCkptRDA>
The check point image of the shape file is saved in ERSI Shapefile format in the
<SFCkpt> shape files and as a SpatialPolygonsDataFrame in the <SFCkptRDA> RDA file.
Checkpoint - areaParms data.frame in: <APPCkpt> as <APCkpt>
The control areaParms dataset has been checkpointed in the <APPCkpt> directory
as the <APCkpt> filename.
BuildBorderGroup has completed the write of the check point files to disk
for possible editing and restart. They are located in the following directory:
<Check Point Directory>
The border group dataset has been successfully written to directory included in this
message and is ready for use, reuse, or editing.
The check point Shape File for the border group is saved to: <Shape File Name>
This message identifies the filename of the saved Check Point Shape File being used to build this
border group. It can be editted, but must be returned to the same directory with the same
name for the checkPointRestart logic to restart the border group building process.
After editing, the results must be saved back to the same directory and filename.
The check point shape file can be manually edited to make areas more visible in the small micromap.
Once the modifications are completed by any external GIS or polygon editor, the final shape file
must be save in it's original directory and under the original filename. If you want to save
a copy of the shape file producted by the BuildBorderGroup function, save it before making modifications.
Checkpoint Reload to Continue
Check Point Restart Process Initiated.
This is an informational message letting the user know the checkPointReStart process has been
initiated and all of the working files have been reloaded into the function.
No Border Group or Name Table directory provides. Cannot find restart files. STOP. The name table and border group directories provided for the checkPointReStart could not be located. Make sure to provide the same directories and file names used in the original BuildBorderGroup function call.
NameTable directory: <NameTableDir>
The name table directory being used for the check point restart is <NameTableDir>.
Using the BorderGroup directory: <BorderGroupDir> to locate the
checkpoint files.
The name table directory was not provided. Since the target output directory was the
BorderGroupDir path, the BorderGroupDir call parameter will be used to locate the
checkpoint folder and files.
Reading areaParms dataset: <areaParm.rda file>
The restart logic in the checkpoint feature is loading the areaParms.rda
file from the <areaParms.rda file> path.
Reading shape file: dsn=<Shapefile Directory> layer=<Shapefile base name>
The restart logic in the checkpoint feature is loading the saved shape file from the
checkpoint folder <ShapFile Directory> and the layer is the <ShapeFile base name>. These are
the checkpoint folder locations not the original Shapefile directory and file parameters.
Reading NameTable: <NT filename>
The restart logic in the checkpoint feature is loading the checkpointed version
of the name table (areaNamesAbbrsIDs) from the checkpoint folder.
The Shapefile has been modified and the 'X__Key' variable has been removed.
Rerun the BuildBorderGroup function to restore the variable.
Then do not remove the variable when editing the shape file.
BuildBorderGroup places a couple of special variable in the shape file to allow the polygons to be
matched up with the areas in the name table. It appears the 'X__Key' variable as been removed.
Editing is permitted, but none of the 'X__' variables added by the BuildBorderGroup should be
removed. Rerun BuildBorderGroup to restore the variables, do the required editing, and then
do a checkPointReStart = TRUE to build the micromapST boundary files.
# 392x
Creating micromapST boundaries files
The shape file variables have been editted. The 'X__Key' variables are
missing. Redo the edits and do not delete the 'X__Key' variable.
During the editing of the Shape file, the 'X__Key' variable must be kept the same to allow the
Name Table to maintain a link between the area location ids and the associated polygons.
Reedit the Shape File and ensure the X__Key variable is untouched.
The shape file row.names in the spatial structure do not match
the 'X__Key' variable values. Investigate and correct cause. row.names are reset to the
'X__Key' values.
The contents of the X__Key variable/column. If they are changed, the tie between the
Name Table and the spatial data is broken. Reedit the Shape file and return the X__Key column
to its original value written when the checkpoint file was created.
Invalid polygon found in <area key> area #:<nz> id:<z>
Message is issued by the BuildVisBorders function as it is process the spatial
data and converting it into the data.frame format for micromapST drawing. The message
indicates an invalid polygon was identified for the <area key> at row number <nz> with the
id of <z>. Identify the bad polygon and fix its geometry.
Completed conversion to VisBorders format.
All of the boundary data for the individual areas, Layer 2 boundaries (if requested), regional
layer boundaries (if requested), and the map outline have been converted to the data.frame
point format required by micromapST to draw the miniture maps.
Creating the 4 micromapST boundary layers (area, L2, L3, and Regions).
The shape file will be copied to the area, L2, Regions, and L3 shape file images and
merge based on the spaces layed out in the name table for L2 spaces, Regional spaces, and the
outline of the entire map (L3).
Completed conversion to VisBorders format.
The conversion from spatial structure to micromapST's data.frame format has been completed.
Writing an images of each Border Group data.frame for <BGBase>
A single R .rda file will be written for each of the 6 data.frames included in the
border group <BGBase>. The can be found in the border group directory under the
names of <BGBase>_<name of data.frame>.rda.
Border Group Created - Successfully.
The writing of the border group dataset has been successful. The border group is now
ready for use.
Summary build report of names, abbr, id and other data is written
to <RepOutFileName>
Each border group needs documentation to provide the user to let them know what the list of
Names, Abbrs, IDs, Aliases, and Alt_Abr location IDs are available in the Name Table for the
space mapped by border group. A copy of the key information from the Name Table is printed for
use in this documentation in a text file in the border group directory under the name of
<RepOutFileName>.
Border Group: <finalBGroup> is done.
The process of gathering the information, validating it, editing it, and converting
in to a format for micromapST has been completed and the dataset written to disk.
The proj4 value character vector is not a valid projection. Must be a value
acceptable to st_crs. proj4 is ignored.
The projection character string provided on the proj4 call parameter is not a valid.
It can not correctly processed the sf function st_crs to be used as a projection.
Make it complient with PROJ4 speciications. Correct and re-run. (convertProj4)
AdjPolygons - Polygons level value is not a Polygons structure.
In processing the SpatialPolygonsDataFrame image of the shape file, the Polygons
level below the polygons level is not a valid SpatialPolygons structure and
can not be processed. Execution is halted. Review the shape file or
SpatialPolygonsDataFrame structure and make sure it is correct.
The number of areas in the map is 1 or less. A border group can
not be made.
The number of areas in the name table and the shapefile must be more than 1 polygon or area to
be able to build a border group. Check the name table and shapefile contents.
Errors have been found and noted above. Execution stopped.
Please fix problem(s) and retry.
*** More detail to be added ***
The border group has been created. To make sure the user can use the same location ids that were used in the name table, the following table is printed to provide documentation on what location IDs are available to the user when they are assemblying their data. Each column present in the name table is listed: Name, Abbr, ID, Alias, Alt_Abbr. These are the primary columns used by the data gatherer.
If only the regional space information is present in the name table, then the regID and regName name columns will be displayed in the report for reference.
If Map Labels and name table modifications were specified for any area in the name table, The MapL, MapX, MapY, Xoffset, Yoffset, Scale and Rotate columns of the name table are listed in this section for later reference. If neither Map Labels or modifications were used, this section of the report is not outputed.
If only Map Labels were implemented in the name table and not name table modifications, only the values for the MapL, MapX, and MapY name table columns are displayed in this section of the report.
If no Map Labels were specified in the name table, but name table modification were specified, then this section of the report will list only the name table modification values for future reference.
If the name table contains Layer 2 and Regional space information for use by micromapST, then this section of the report will be outputed listing the L2_ID, L2_ID_Name, regID, and regName name table column information for later use. If the L2 and regional information is not present this section of the report is not displayed.
If only the Layer 2 information is present in the name table, then the L2_ID and L2_ID_Names name table columns will be displayed in thei report for reference.
Jim Pearson, StatNet Consulting, LLC, Gaithersburg, MD
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.