ChinaBG: ChinaBG border group datasets to support creating micromaps...

In micromapST: Linked Micromap Plots for U. S. and Other Geographic Areas

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.

Details

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

areaParms

- contains specific parameters for the border group

areaNamesAbbrsIDs

- containing the names, abbreviations, and numerical identifier for the providences and municipalities of China.

areaVisBorders

- the boundary point lists for each area in China.

L2VisBorders

- the boundaries for an intermediate level. This level is not used in this border group.

RegVisBorders

- the boundaries for an regional level for China. This set of boundaries are used in conjunction with the regions call parameter.

L3VisBorders

- the boundary of the country of China.

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 <statsDFrame> 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 Mongol	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
Hong Kong	HK	CN.HK	81	Zhongnan
Macao	MC	CN.MC	82	Zhongnan
Taiwan	TW	CN.TW	71	Huadong

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.

micromapST documentation built on Nov. 12, 2023, 5:06 p.m.