ChinaBG: ChinaBG border group datasets to support creating micromaps for the 32 providences and municipalities in the country of Republic of China

Description

The micromapST function has the ability to generate linked micromaps for any geographical area. To specify the geographical area, the bordGrp call argument is used to specify the border group dataset for the geographical area. The ChinaBG border group dataset supports creating linked micromaps for the 34 provinces, special administrative regions, metropolitan areas in the China. When the bordGrp call argument is set to ChinaBG, the appropriate name table (sub area names and abbreviations) and the 34 sub-areas (provinces, SAR, cities, etc.) boundary data is loaded in micromapST. The user's data is then linked to the boundary data via the county's name, abbreviated name or ID based on the table below.

Arguments

Details

The ChinaBG border group dataset contains the following data.frames:

For the China border group, there are 34 county sub-areas listed in the areaNamesAbbrsIDs and areaVisBorders datasets. The L2VisBorders dataset is not used and is set to the L3VisBorders dataset as a placeholder. The RegVisBorders dataset represents the 6 regions of China in the ChinaBG border group. The L3VisBorders dataset contains the outline of the country of China.

The details on each of these data.frame structures can be found in the "bordGrp" section of this document. The areaNamesAbbrsIDs data.frame provides the linkages to the boundary data for each sub-area using the fullname, abbreviation, alternate abbreviation, and numerical identifier for each country to the data based on the setting of the rowNames call argument. A column or the data.frame row.names must match one of the types of names in the areaNamesAbbrsIDs data.frame name table. If the data row does not match a value in the name table, an warning is issued and the data is ignored. If no data is present for a sub-area (county) in the name table, the sub-area is mapped but not colored.

The following are a list of the names, abbreviations, alternate abbreviations, ids, and the region for each county, province or metro area in the ChinaBG border group.

name	ab	alt_ab	id
region	Anhui	AH	CN.AH
34	Huadong	Beijing	BJ
CN.BJ	11	Huabei	Chongqing
CQ	CN.CQ	50	Xinan
Fujian	FJ	CN.FJ	35
Huadong	Gansu	GS	CN.GS
62	Xibei	Guangdong	GD
CN.GD	44	Zhongnan	Guangxi
GX	CN.GX	45	Zhongnan
Guizhou	GZ	CN.GZ	52
Xinan	Hainan	HI	CN.HA
46	Zhongnan	Hebei	HE
CN.HB	13	Huabei	Heilongjiang
HL	CN.HL	23	Dongbei
Henan	HA	CN.HE	41
Zhongnan	Hubei	HB	CN.HU
42	Zhongnan	Hunan	HN
CN.HN	43	Zhongnan	Jiangsu
JS	CN.JS	32	Huadong
Jiangxi	JX	CN.JX	36
Huadong	Jilin	JL	CN.JL
22	Dongbei	Liaoning	LN
CN.LN	21	Dongbei	Nei Menggu
NM	CN.NM	15	Huadong
Ningxia Hui	NX	CN.NX	64
Xibei	Qinghai	QH	CN.QH
63	Xibei	Shaanxi	SN
CN.SA	61	Xibei	Shandong
SD	CN.SD	37	Huadong
Shanghai	SH	CN.SH	31
Huadong	Shanxi	SX	CN.SX
14	Huabei	Sichuan	SC
CN.SC	51	Xinan	Tianjin
TJ	CN.TJ	12	Huabei
Xinjiang Uygur	XJ	CN.XJ	65
Xibei	Xizang	XZ	CN.XZ
54	Xinan	Yunnan	YN
CN.YN	53	Xinan	Zhejiang
ZJ	CN.ZJ	33	Buadong
Hongkong	HK	CN.HK	81
Zhongnan	Macau	MC	CN.MC
82	Zhongnan	Taiwan	TW
CN.TW	71	Huadong	name

The ChinaBG supports two sets of abbreviations for each county (province or metro area). No consistant source was found when the border group was originally created. Therefore, the two most common sets are included. The first abbreviation set can be referenced by setting the rowNames call argument to "ab". The second (alternate) abbreviation set can be used by setting the rowNames to "alt_ab".

The rowNames = "alias" features are not supported in the ChinaBG border group.