| ChinaBG {micromapST} | R Documentation |
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.