GIS Support Materials: Procedures and Arc/Info AML Scripts

Procedures

Choropleth Mapping

From data file to map

Scanning and Vectorizing

From tracing paper to Arc/Info coverage

Qu Centers

Program for adding Qu Center points

Map Accuracy Table

Ground accuracy standards for various map scales

Data Development

Take note! Recordkeeping requirements

HP Plotter

Instructions for setting up the Vis Lab's plotter

mkisofs CD-R

Instructions for using mkisofs to make backup files, which can be written to Qing's CD-R drive

MC Mergers

Managing mergers and splits of county-level units (MQ, MC, and XT) in the China-A political boundaries coverage

CPZ (a4074)

Spatial analysis tools for assigning core-periphery zones to counties

RCS (t990-994)

Spatial analysis tools for assigning towns and counties to Regional City Systems and Macroregions

Commonly used Arc/Info AML macro scripts are documented here. Most AMLs are stored in subdirectories of the atool directory:

AMLs for cartographic output, such as Regmap/Pagemap Theme and Key AMLs are stored in various data directories.


Arc subdirectory

AMLs for use at the Arc prompt.

Ap_or_eps.aml

Send output to Arcplot canvas if started by Arcplot or to .eps (Postscript) file if started by Arc

Usage: ap_or_eps <output file name>

ApOr1040.aml

Send output to Arcplot canvas if started by Arcplot or to .gra file if started by Arc

arcbatch.aml

Prepares and runs another AML (called by arcat script)

eps2jpg.aml (also named jpeg.aml)

convert Postscript file to .JPG (for HTML use)

imageline.aml

converts raster images to arcs in a batch process

using a consistant name that ends in incrimental numbers

infoRM.aml

removes info files if they have no associated coverage

expects input from $DBF/infodir -l command

nettic.aml

add tics at each node (for use in registering map sheets)

Usage: nettic <input line coverage>

(Input coverage can be created with GENERATE/FISHNET LABEL)

psfix.aml

runs psfix script, which fixes Postscript header for HP650C plotters

rtlplot.aml

create an RTL file from an EPS file

Optionally, delete .eps file and/or print .rtl file immediately.

runmacro.aml

Runs the specified AML for each record in the specified list

Usage: RUNMACRO <AML_macro_filename> <parameter_list_filename> {constants}

transappend.aml

appends a series of tiles, keeping all attributes.

The first tile MUST have all of the relevant attribute items

 Return to top


Arcplot subdirectory

AMLs for use in Arcplot.

ailayer.aml

Begin a new Adobe Illustrator file within the current Arcplot session (but only if current output is *not* to the screen, i.e. DISP 9999). Useful for placing different "layers" into Freehand for later editing—Commonly used within Pagemap themes.

Usage: AILAYER <layername> {BOX | NOBOX}

Begins a new Adobe Illustrator file <layername>.ai.

{BOX} specifies that a box around the current maplimits will be drawn.

comma000.aml

Inserts commas into long numbers (1000s or 10000s place) for output in any Arc/Info module

Usage: comma000 <number> {3 | 4}

Use 3 option (default) for English, 4 for Chinese

Note: each of the following CREATE___.aml scripts create or invoke a customized Arc/Info shadeset, lineset, or markerset.

create5pastels.aml

creates five-pastel shadeset, syspoly.shd

createbgr.aml

creates Blue-Grey-Red shadeset (for bipolar choropleth mapping), bgr.shd

createbr.aml

Sets up BROWNS.SHD as 8-symbol brown-tone shadeset Note: this shadeset cannot be used with RTLPLOT. Plot as .eps file only.

createbr2.aml

Sets up BROWNS2.SHD as 7-symbol brown-tone shadeset

(differs from BROWNS.SHD: boosts intensity of each symbol by 1 level) Note: this shadeset cannot be used with RTLPLOT. Plot as .eps file only.

createbrowngreen.aml

Sets up BROWNgreen.SHD as 12-symbol brown-to-green shadeset

createbrowns.aml

Sets up BROWNS-lohi.SHD as 8-symbol brown-tone shadeset based on CreateBr.aml but with shades 1..7 from low to high, not high to low

createce.aml

Create CENTRALPL.MRK markerset for central place points (5 classes)

CreateElevShd.aml

create shadeset of 8 elevation tints

creategr.aml

Sets up GREY8.SHD as 8-symbol grey-tone shadeset

createri.aml

Sets up RIVERS.LIN as 5-symbol lineset + 2 canal linesymbols

createrivers-ck.aml

Sets up RIVERS.LIN as 5-symbol lineset + 2 canal linesymbols; ck (Checkplot) version allows different halftones of strange colors

createrivnav.aml

Sets up RIVNAV.LIN as 5-symbol lineset + 2 canal linesymbols, based on CREATERI.AML but distinguishes navigable rivers by color

createshaderange.aml

Sets 6 intensifying shade symbols (1..6) based on 5-digit binary input. (First digit ignored; remaining digits = CMYK); random chance variation added to make colors more interesting

Usage: createshaderange <binaryinput>

try 00110 red, 01010 green, 01100 blue, 01000 cyan, 00100 magenta, 00010 yellow

createsolidcp.aml

Create SOLIDCP-<color>.MRK markerset for central place points (9 classes)

CreateSubSysShade.aml

create shadeset of pastels for all of the China macroregional subsystems

CreateSyspolyShd.aml

create shadeset of 4 pastels

createtrans.aml

Initializes Transport linesymbols (for roads, rails, and navigable waterways)

Based on plottrans.aml and $CHINA/trans/modecodes.dat

datemark.aml

stamps current date: DD Month YYYY, User name, UCD Visualization Lab

dmstext.aml

place text for degrees-minutes-seconds

grey.aml

Sets up GREY%number%.SHD as %number%-symbol grey-tone shadeset

%number% is typically the number of zones plus 1 (for black)

see also greys.aml, greysets.aml

mapedge.aml

adjust maplimits inward so as to avoid printing text on map edges or adjust maplimits outward after text has been drawn

Usage: mapedge <distance>

negative <distance> adjusts maplimits inward.

positive <distance> adjust maplimits outward.

movectr.aml

move Arcplot cursor to center of box defined by x1,y1,x2,y2

Note: each of the following PLOT___.aml scripts draws some combination of features, usually from our China data coverages. These scripts are often called by Regmap/Pagemap Themes.

plotbase.aml

plots base map features: PHYSIO, RCS, DCW RIVERS, RR, ROADS

plotcity.aml

Plots low-resolution central places according to specifications in .PAT.

plotcp-prov.aml

Plot ACASIAN Central Places coverage for a single province

Usage: plotcp-prov <province-ID> <# | pointmarker_lookup_table> {labeltext_item|<CP//>ChinaT_item}

plotcp.aml

Plot ACASIAN Central Places coverage, labelled with only one item

Usage: plotcp <# | pointmarker_lookup_table> {labeltext_item|<CP//>ChinaT_item}

plotrivers.aml

Plots all the rivers in China from ACASIAN HYLP coverages

Specify ARC and/or POLY features, or specify NAV rather than ARC to distinguish navigable arcs (TCODE > 1). Optional features ANNO (DCW river names) and FOREIGN (CHrivers outside of China).

plottrans.aml

Plot ACASIAN China roads & rails coverages for any & all provinces in mapextent

POarcs.aml

Plot arcs for China Political Boundaries (specified subclass MQ, MC, etc)

prjtext.aml

prints map projection info at current text position & specifications

r4map.aml

Page layout for maps of the Upper Yangzi macroregional system as prepared by Jian Dai, 1996. Retained for historical purposes.

See also r4mrzon.aml

roadback.aml

colors lines for a background from old road coverage that is being replaced

roundmapscale.aml

rounds map scale to a reasonable number of zeroes

SCALEBAR.AML

This is a tool for drawing a scalebar that best fits the space allowed. Requires mapunits = meters or feet, not kilometers. Adapted from coding by Randy Deardorff, EPA Region 10, Seattle.

selpoly.aml

interactively select a polygon, then change its value (for a specified PAT item)

See also selpolymany and selpolypoly. For regions, see selregmany.

Return to top 


Arcedit subdirectory

AMLs for use in Arcedit. (See D. Messenger.)

Return to top


Chinatool subdirectory

AMLs specifically for use with China data--may be adapted for use with other datasets. (See M. Henderson.) Highlighted AMLs are particularly important for macroregional analysis and data management procedures.

a1match.aml

Verify that all records in an INFO table have a corresponding MC or MQ unit in the China-A political boundaries coverage (related by A1 value)

Usage: A1MATCH.AML <.DAT table> {MC|MQ}.DAT table must have A1 item.

addone.aml

Interactively adds a record to an INFO table (in Arcedit) and populate two items (A1XT and Z1XT) (Used to maintain the GISAZXT.DAT table which links ChinaZ and ChinaA Ids.

addsource-trans.aml

add SOURCE item to AAT and populate with coverage name (intended for use with roads and rails coverages of provinces) also adds CLASS item with standard field definition (2 2 I)

addsource.aml

add SOURCE item to AAT and populate with coverage name (intended for use with map tile coverages) also replaces BTYPE item with standard field definition (3 3 I)

addzhen.aml

interactive program to add central place points to the CPQU coverage and give them names and numbers. Note: aggregated CP coverages such as CP-ALL must be regenerated if any more central places are added.

apportioncounties.aml

process China MQ|MC units and Macroregions to determine proportion of each county in each regional subsystem (Uses cantonzones.aml and cantonzoneanno.aml in $CHINA/po) Calls DividedCounties.aml. Uses $CHINA/po/china-a and $CHINA/hrs/rcs coverages as sources for county units and macroregions.

assignRCS2t1.aml

Determines in which RCS polygon(s) a Central Place point resides and outputs a list of CP-T1 and RCS-T1 pairs. Janus-faced Central Places are recorded as being in multiple RCS polygons (and appear multiple times in the output listing).

Usage: assignRCS2t1.aml <CP_cover> <RCS_cover> <out_INFO_table> {select_for_janus}

If {select_for_janus} is specified, only points which match the selection statement will be evaluated for possible inclusion in multiple regional city systems. (Used to exclude lower-order towns from consideration.)

buildl2r.aml

Create a table listing each Left-to-Right and Right-to-Left adjacency.

Called by SELADJAC.AML (part of the adjacency suite)

cantonzoneanno.aml

Creates an N1 file listing the percentages of each canton in each zone (or of each county in each region, etc.) and summarizing the results in a single text item, ZONETEXT, which may be used to label polygons on maps.

Usage: cantonzoneanno <APPfile> {zoneitem CP_ZONE|CP_VALUE|SYSTEM} {unitsitem MMCID|A1}

<APPfile> is INFO table produced by CantonZones.AML

(<APPfile> may first be modified by DividedCounties.aml, which removes extra entries for counties which should not be divided.)

Specify the Unit ID item (e.g., A1, N1, MMCID) and ZONE item

cantonzonerules.aml

take results of cantonzoneanno.aml (.N1 file) and repair handling of cases set by special rules (>90% in one zone, SPLIT=9)

Usage: cantonzonerules <N1file> <LZfile>

<N1file> has one record per canton/county, with SPLIT and ZONETEXT items

<LZfile> has one record per zone/region (listed in its 3rd item)

cantonzones.aml

Determine proportion of MC in a zone. Output .APP file may be used as input to DividedCounties.aml and CantonZoneAnno.aml. (Alternative approach cf. cantonreg.aml, which only indicates presence in a zone). This can be run on Regions (CP_ZONE) /or/ Core-Periph Zones (CP_VALUE). This can be run on France (MMCID) or China (A1)

Usage: CANTONZONES <cantoncov> <zonecov> {zoneitem CP_ZONE|CP_VALUE} {mcitem A1|MMCID}{Overwrite | Saveold}

ChangeA1.aml

Interactively change A1 assignments for MQ, MC, and XT units in China-A. (Effects changes to GISMQMC.DAT and GISMCXT.DAT)

chi-indexmap.aml

index map using standard China-centered Albers perspective

chindex.aml

Perspective Index Map of China, highlighting a specific region

Note: the following scripts prefixed with cp- were used to process China Central Places coverages.

cp-chengguan.aml

Where CPxx.PAT's CHARACTER_NAME = '³Ç¹ØÕò' (Chengguan), replace with value of ADMIN_UNIT_CHARA from CPxx.CTC

cp-hanzi.aml

replace original (scrambled) Hanzi in .PAC table (.PAT from ACASIAN) with a new INFO table (.CTC) imported from new ACASIAN .csv files

cutin.aml

generates <VARIABLE>.CUT and <VARIABLE>.PLUT files from text list of cutpoints (alternative to MAKECUTS.AML, which scans actual values in <VARIABLE> datafile)

de-zhen-zi.aml

removes Zhen, Shi, and Xian characters (zi) from CPxx.PAT CHARACTER_NAME field

deleteme.aml

kills an INFO table

Usage: deleteme <DF> <INFO_Table>. Use this AML with RUNMACRO.AML and a list from INFO's DIR command.

DividedCounties.aml

Determines whether counties should be considered divided among macroregions when CANTONZONES reports less than 15 percent in one macroregion, based on whether a town is found in the sliver portion of the county. Run this macro after CantonZones, but before CantonZoneAnno.aml, in order to exclude slivers without polygons from being counted as divided counties.

Usage: DividedCounties <ZON coverage> <Towns coverage> <county item (A1MC)> <region item (SYSTEM)>

<ZON coverage> is left in TEMP directory after running CantonZones.aml--it contains both county boundaries and macroregion boundaries.

<Towns coverage> contains points to be tested against polygons in <ZON coverage>.

<county item> is the ID item for counties in the <ZON coverage>.

<region item> is the ID item for macroregions in the <ZON coverage>.

dodoclist.aml

Make LUTs for many coverages and save results as text files, too. Calls MAKELUT.AML

dxfrails.aml

convert ACASIAN Railroads DXF files to Arc/Info coverages (includes unzipping source files & joining ACODE to AAT).

dxfroads.aml

convert ACASIAN Roads DXF files to Arc/Info coverages (includes unzipping source files & joining ACODE to AAT).

editRCS.aml

set up Arcedit environment to stitch together RCS arcs from tracings

elev16colors-even.aml

sets up 16 shadesymbols for displaying elevation data

elev8lin.aml

sets up 8 linesymbols for displaying elevation data,

based on elev16colors-even.aml 1-30-96\mgh

elevtint.aml

Make grid stack for display as shaded relief hypsotints, based on procedure in 1994 ESRI Conference Procedings, optionally supply existing hillshade grid, rather than creating from input grid (which need not be elevation data)

Usage: ElevTint <input_grid> {COLORMAP.TXT | user_colormap_file} {5 | classes} {elevshade_grid} {hill_already_done?}

<input_grid> may be an elevation DEM or some other type of data

{elev_grid} should be specified if <input_grid> is not a DEM

Specify {classes} = 0 if there is one COLORMAP entry for each value.

filterp.aml

For each record in a .DAT file, perform low-pass filter on VALUE by averaging values of adjacent polygons (proportional to length). Uses SELADJAC.AML to pick adjacent polys (part of Adjacency suite).

Usage: filter-poly <coverage> {.DAT table} {VALUE | valueitem} {AVG | averageitem}

findisle.aml

Performs low-pass filter to identify polys surrounded by "Lakes" which are then coded as "Islands". Uses SELADJAC.AML to pick adjacent polys.

Usage: findisle <coverage> {LAKE | valueitem}

findunit.aml

finds INFO or POLY records for a given MC or MQ <unit>; if no exact match, finds the entire prefecture

fixarcs.aml

interactive program to change an arc attribute in Arcedit (analogous to selpolymany.aml)

fixT1.aml

Interactively correct CTC-T1 assignment in CPxx.PAT.

fixval.aml

Interactive program to change values in an info file. For record with matching <match> item, change <change> item

getallcp.aml

Select and get CP points from provincial CP coverages based on a range of values in CHINAT.DAT, creating a new (aggregated) central place point coverage.

Usage: GetAllCP <new_coverage> <select_item> <select_min> <select_max>

Assumes <select_item> is in ChinaT.Dat, *not* in the CP coverages.

getcpmismatch.aml

Select and get CP points from provincial CP coverages that are *not* found in CHINAT.DAT (that is, georeferenced points that we will not use).

Usage: GetCPmismatch <new_coverage>

getnavarcs.aml

Select and get Navigable arcs from @##hylp_9 tile coverages

Usage: GetNavArcs <new_coverage>

getnavarcs-loop.aml

called by getnavarcs.aml

getnavpoly.aml

For all @##hylp_9 coverages, standardizes PAT/AAT attributes and extracts navigable polygons into a new coverage

Usage: Getnavpoly <output_coverage>

getnavpoly-loop.aml

called by getnavpoly.aml

getregioncp.aml

Select and get CP points from provincial CP coverages which have been assigned to a specific macroregion

Usage: GetRegionCP <region 0..9> <RCS-T1 assignment table>

getroads.aml

get arcs from a provincial coverage into the current edit coverage

(for use in Arcedit)

HeadNodePoint.aml

Construct a point coverage from the nodes representing heads (or tails) of navigation as shown in the Atlas of China. (Navigable river arcs are already coded TCODE>1.)

importRoadsZ.aml

Import roads and rails coverages for a specifed province. Expects to find compressed .E00 export files in %sourcedir%. Retains the source file. Puts imported coverages in %roaddir% and %raildir%.

importZ.aml

import a compressed .E00.Z export file, retaining the source file; customized for HYLP source and destination directories

Usage: importZ <input_e00.Z_file>

infoin-loop.aml

Called by infoin.aml to process records in input file.

infoin.aml

Read variable-width columns into 4-item info file. Assumes info file has 4 fields: A1, A3 (char), VALUE, and ZONE. Uses infoin-loop.aml to process records in input file.

Usage: infoin <input text file> <output INFO table> {APPEND | OVERWRITE}

infoin-loop.aml

Called by infoin.aml to process records in input file.

Note: the following AML scripts with names beginning le- were written for the Labelerrors procedure, used for comparing GIS coverages of China counties for 1982-85 (ChinaZ) and 1990 (ChinaA). The results of this procedure are stored in the INFO table $CHINA/po/gisazxt.dat.

le-check.aml

Checkplot for LABELERRORS (Conflation from 90 to 82-85)

le-process.aml

Processes output from labelerrors command

Usage: le-process.aml <labelerrors output file>

le-xref.aml

Crossreference ChinaA and ChinaZ MC units using Labelerrors output

Usage: le-xref <le_file>

list-le.aml

Checklist for LABELERRORS (Conflation from 90 to 82-85).

LinePAT.aml

Find lines based on adjacent polygons' attributes

Usage: LinePAT <coverage> <PAT_item> <PAT_value> {FORCE_new_PAL_file}

LinePAT2.aml

Find lines based on adjacent polygons' attributes. This version (2) allows any selection statement.

Usage: LinePAT <coverage> <Selection_statement>

listitems.aml

list AAT and PAT items for specified coverage, output to <cover>.PATITEMS text file; used for verifying content/format of ACASIAN HYLP hydro coverages.

ListRCS-GC.aml

Take output from AssignRCS2T1 T702IS5 NEWRCS TAKE5.DAT and make a list showing the Mean T109 (urban population) for all greater cities in each Regional City System.

llgrat.aml

draw and label graticule (e.g., latitude/longitude arcs)

Usage: cover txtitem lut placemnt offset pos fr/to flip clip whicharcs

makecoastbuffer.aml

input: grid with offshore areas = NODATA

output: polygon coverage of buffered zones around coastline

Usage: makecoastbuffer {20000 | bufferwidth} {5 | numberofbuffers}

makecuts.aml

find value cutpoints between zones in a data file (assumes zones are numbered sequentially 1..numzones)

Usage: MAKECUTS <datafile> <zoneitem> <valueitem>

Output to <datafile>.CUT

makehylut.aml

Make Look-Up Table to document and symbolize AAT and PAT attribute fields

HY version writes all output to HYLP.___ in HYDRO directory

makeleg.aml

makes legend coverage for 4-8 zones

makelut.aml

Make Look-Up Table to document and symbolize AAT and PAT attribute fields

Usage: MakeLUT <Info_table> <Info_item>

Creates a new Info_table with <Info_item>, SYMBOL, DESCRIPTION, and TEXT fields and records for each unique <Info_item> value in <Info_table>

MakeMCCP.aml

Creates a list of A1MC and MCCP-T1. The MCCP for each MC (county) unit is the Central Place of the highest rank, administrative status, and urban population. The MCCP point will be used to represent the MC polygon unit in certain point-based analyses, such as transport network modelling.

makeR012.aml

Sets R012 values for MC units (# of counties removed from Regional City). Uses A1T1SEAT.DAT and CS-RCS.DAT to link counties to county seats to RCSes.

MakeRCSregions.aml (formerly RebuildRCS.aml)

Builds Region subclasses for the RCS coverage and sets .AAT item BTYPE along region boundaries: BTYPE = 3 (RCS only), 4 (RCS+subsystem), 5 (RCS+macroregion), 6 (subsystem, not RCS), 7 (extended vs. ordinary RCS). Does not overwrite BTYPE = 2 (underwater) or BTYPE >= 10 (intl boundary). Requires that SYSTEM (MR and SUB), RCS-T1, and EXTENDED poly values already be populated.

Usage: MakeRCSregions <backupcoverage>

mczanno.aml (formerly apportiontext.aml)

Add & populate a summary text item listing the percentage (of a county) in each region

Usage: mczanno <APPfile> { <datfile> <zoneitem> }

<APPfile> is INFO table produced by MCZONES.AML

Optional datfile and zoneitem list zone assignments by MC units; if provided, assigned zone will be flagged in ZONETEXT.

mergea981.aml

Merge MC units based on a981 file values. (Note: this procedure is no longer used for China data. See RebuildChina-A.aml for current procedures.)

mergext.aml

Merge XT units from MC units based on MASTER.MCXT file, then populate ChinaZ XT items in new XT Region subclass.

moveme.aml

move (copy and delete) a grid (for use with RUNMACRO)

moveup.aml

Move a coverage up one directory level

MRdistance.aml

Allocate central places in a macroregion to Metropolitan cities (or in fact any level of t702 hierarchy)

Usage: MRdistance {<linecoverage> <route>} <Macroregion 0..9> <t702>

<linecoverage> is a coverage with AAT items EQLENGTH and SEQLENGTH

<route> is a route system name--will be created if not already present

Centers will include cities of <t702> or higher (1=high,9=low).

If anything is specified for {purge}, new Centers and Stops will be generated.

nearsplit.aml

Split arcs where closest to points, and assign point# to new node#.

Usage: Nearsplit <line_cover> <point_cover> <PAT_item> {process_step}

Output is written to new coverages LNCOV and PTBAD in a new subdirectory called WORKDIR. (Old WORKDIR files are overwritten.)

pathtocore.aml

For all counties (MC units) in a macroregion or subsystem, determine the least-cost path from the MCCP to the region core and creates a route system named CORE<mr> with route systems for each county (numbered A1MC).

Usage: PathToCore <transport network coverage> <Macroregion 1..9|Subsystem 11..94>

PolyAAT.amlFind polygons based on adjacent lines' attributesUsage: PolyAAT <coverage> <AAT_item> <AAT_value> {RETAIN_tempfiles}Warning: code modified especially for DCW Hydro data--changes may be required.

projectme.aml

copy projection file from $CHINA/po/china-a (political boundaries)

railcodes.aml

For each ACASIAN RAILS coverage, add & populate a rail CLASS item (classes are listed in $CHINA/trans/railcodes.dat)

rcs-ap.aml

Arcedit background plotting for editing RCS boundaries from CP Analysis maps (invoked with Arcedit AP RCS-AP.AML command).

rcs-ap2.aml

Arcedit background plotting for editing RCS boundaries from CP Analysis maps; version 2 shows almost all features from CP Analysis maps.

rcs-hiorder.aml

Report numbers of higher-order cities for each class of RCS (1..27)

rcsclass.aml

Report distribution of populations of lower-order cities for each class of RCS (1..27)

RCSdistance.aml

Calculate distance to Regional Cities from all central places assigned to a Regional City System. <linecoverage> should be output from SetEqLength.aml (i.e., $CHINA/trans/transnet)

Usage: RCSdistance {<linecoverage> <route>} <RCS-T1> {purge}

<linecoverage> is a coverage with AAT items EQLENGTH and SEQLENGTH

<route> is a route system name--will be created if not already present

<RCS-T1> is the T1 ID of a Regional City whose system will be examined.

If anything is specified for {purge}, new Centers and Stops will be generated.

RebuildChina-A.aml

Rebuilds region subclasses for China-A (MQ, MC, and XT units). Using A1MQ, A1MC, and A1XT items in .PAT plus GISxxyy.DAT tables

Usage: RebuildChina-A <backupcoverage> {comment for log file}

<backupcoverage> will be created BEFORE changes are made to CHINA-A coverage

Warning: this will destroy the CHINA-A.PATxx region subclass tables in CHINA-A and rebuild them using the GISxxyy.DAT tables (GISMQMC, GISMCXT, and GISAZXT.DAT).

redwood.aml

Draw 1:350,000 map of Redwood City area using specified theme.

Usage: redwood <theme.aml> {'title'} {theme parameters}

registerchina.aml

transform a coverage using China tics ($CHINA/carto/mtix_r)

Usage: registerchina <Coverage prefix> <Input version#> <Output version#>

Example: registerchina R23 2 3 ...looks for R23_2, saves as R23_3

reorderitems.aml

Rearranges PAT and AAT to conform to current community standards and populates new, politically correct items (fields) with data from old, misordered or maldefined items.

ReportRCSdistance.aml

Combine output from rcsdistance.aml into a single INFO file in which, of two duplicate T1 entries, that with the smaller distance is retained and that with the larger distance is deleted. Outputs .dbf file.

ReportRCSdistance-loop.aml

AML subroutine called by ReportRCSdistance.aml.

roadcodes.aml

for each ACASIAN ROADS coverage, add & populate a road CLASS item; classes 1-8 are for superhighways, 9-16 are paved national, 17-24 are unpaved national, 25-32 are paved provincial, 33-40 are unpaved provincial, 41-48 are paved local, 49-56 are unpaved local, 55-63 are other, unknown, or who cares.

rrfixprj.aml

fix railroads projection (for ungeoreferenced SE China provinces) and remove provincial boundaries too

rrnoborder.aml

remove provincial border (for ungeoreferenced SE China provinces)

run-ta.aml

Runs TestAdjacent.aml for all data variables in a .dbf file (which is first converted to an INFO table)

RUNMACRO.AML

Runs the specified AML for each record in the specified list

Usage: RUNMACRO <AML_macro_filename> <parameter_list_filename> {constants}

Expects that <AML_macro> contains the directive &args <params1..n> {constants1..n}

seladjac.aml

Selects polygons which are adjacent to the currently selected polygons.

selinfo.aml

interactive program to select records from an info file

selme.aml

interactive program to asel arcs in Arcedit

setarcfrompoly.aml

Set line attributes based on adjacent polygons' attributes (based on linepat.aml). Arc will be set to the greatest value of its neighboring polygons.

Usage: SetArcFromPoly <coverage> <PAT_item> <AAT_item> {FORCE_new_PAL}

SetEQlength.aml

For each arc in a coverage which is in China Albers Projection (units=km), determine a more accurate arc length by copying into a UTM projection and then saving the UTM length back into the original .AAT. Requires coverage $CHINA/carto/utmzones-km and $AML/prj/ projection files. Requires cost-distance multiplier for each TCODE in $CHINA/trans/modecodes.dat table.

setprj.aml

check whether projection is set; if not, copy one

setregionpal.aml

Make sure a PAL file (sorted by ARC) exists for a Region subclass.

Usage: setregionpal <coverage> <region_subclass>

Creates <coverage>.PAL<region_subclass> sorted by ARC if table does not exist.

settol.aml

Sets conservative tolerances for 1:1m coverages (based on 1/10 of the accuracy standard for that scale)

setzones-rcs.aml

Start with selected polys (for which zoneitem will be %startzone%) and set concentric polys as zones 2..n until all are set.

setzones.aml

Start with selected polys (for which zoneitem will be %startzone%) and set concentric polys as zones 2..n until all are set.

Usage: setzones <coverage> {ZONE | zoneitem} {1 | startzone} {8 | maxzone}

snapon.aml

Set Arcedit snapping environment

StandardAAT.aml

Creates standardized AAT items from road, rail, or mesh coverages and populates these items from whatever configuration of nonstandard items currently exist in the coverage, as received from ACASIAN. This is necessary so that the coverages can be APPENDed into Transnet. Item definitions based on StandardHYLP.aml. Note: run ROADCODES.AML or RAILCODES.AML first to populate CLASS item.

Standardhylp.aml

Creates standardized PAT and AAT items from @##hylp hydrography coverages and populates these items from whatever configuration of nonstandard items currently exist in the coverage, as received from ACASIAN. This is necessary so that the coverages can be APPENDed. Some code taken from ReorderItems.aml

superleg.aml

Draw "superlegend" key including arrow, zones, keyboxes, and values

Usage: superlegend <cutpoints_table> <keyarea (x,y,x,y)>

testadjacent.aml

Tests the sequencing of a data variable's values across adjacent counties (which share a transport connection). Uses output from TransAdjacent.aml.

testadjacentanno.aml

Annotates the output from Testadjacent.aml: populates a single text item which reports all non-1.0 SCORES. This item can be used to draw a map summarizing the scores for up to 8 items.

Usage: TestadjacentAnno.aml <datatable> <Annoitem> <score1> {{score2}..{score8}}

testsequence.aml

Tests the sequencing of a data variable's values along a route system (as from Core to Periphery). Requires .SEQ<subclass> generated by TransSequence.aml

Usage: TestSequence <coverage> <subclass> <datatable> <dataitem> {outtable} {NODISPLAY|DISPLAY}

Example: TestSequence transnet core4 sasdata.dat a02138 a01238.test

tidycp.aml

Clean up CP coverages--remove obsolete INFO tables and PAT items.

tilemap.aml

Creates map of a 4x6 degree tile (used for ACASIAN HYLP rivers), calling a Regmap Theme AML.

Usage: tilemap <tile> <theme> {theme_parameters}

transadjacent.aml

Creates INFO tables listing China MC units (counties) which are immediately adjacent via transport connections (roads, rails, navigation). Output can be used by TestAdjacent.AML, which tests whether data values for counties progress from core to periphery. This approach replaces the approach used by TransSequence and TestSequence.aml. See $CHINA/po/xxmc.to and xxmc.from for examples of output

Usage: TransAdjacent <mc_polygon_coverage> <Transnet_arc_coverage>

TransferTCODE.aml

Transfers values from version _1 hylp to version _2 hylp coverage (necessary since hylp coverages were updated by ACASIAN after some TCODE coding was done at UCD).

transrivbuf.aml

Transfer attributes from buffered rivers coverage to detailed hydro.

Source: 1:4m navigable rivers coverage from ACASIAN, buffered by type.

Target: 1:1m LUMC rivers coverages (xHYLP)

Usage: transrivbuf <HYLP_coverage>

TransSequence.aml

Generate a Sequence file listing Central Places and their predecessors and successors along Routes in a Route Subclass. Designed for China Transnet coverage and CoreXX route subclasses.

Usage: TransSequence <Transnet coverage> <Route subclass> {step}

Generates Sequence INFO table <coverage>.SEQ<subclass>

verifyrcst1.aml

Check that the output of ASSIGNRCS2T1.AML contains all georeferenced points in the specified point coverage and .dat table.

Usage: VerifyRCST1 <rcst1.dat table> {CP coverage} {ChinaT Data table}

{CP coverage} defaults to $CHINA/cp/cp-all

{ChinaT Data table} defaults to $CHINA/cp/chinat.dat 

Return to top


Edittool subdirectory

AMLs for use in scanning, vectorizing, and editing GIS data. (See D. Messenger.)

Return to top 


Makemaps subdirectory

AMLs for use in generating standard map themes. For an overview of the standard mapping procedures, see the detailed documentation for regmap.aml.

ChinaRegionSetup.aml

Parses numeric Region arguments for Regmap.aml (Numeric regions indicate China Macroregions or Provinces.

Called by RegSetup.aml

getframe.aml

Set mapextent and title for many map frames of China, Japan, France, etc. (called by regmap.aml if %region% is not numeric)

Pagemap.aml

Page layout for maps of macroregional systems (8x10" format); uses specified THEME AML to draw map.

(Ignores KEY AML used by Regmap.AML; uses kp-<theme>.aml if found.)

Usage: pagemap <region (1..9|N,S,W,P|10..99)> <theme> {theme_parameters}

Output to p%region%%theme%.eps

Pagemap40.aml

Page layout for maps of macroregional systems (8x10" format); output to 1040 .GRA file.

pagemap_ai.aml

Page layout for maps of macroregional systems (8x10" format); output to %region%<layer>.ai Adobe Illustrator file.

PageSetup.aml

Sets up display output for PAGEMAP.AML.

regionmape.aml

mapextents and maplimits used for regional maps before 11/96

regmap.aml

Page layout for maps of macroregional systems; uses specified THEME and KEY AML to draw map. Accepts either THEME- or T- as theme macro prefix.

Usage: regionmap <region (1..9|N,S,W,P|10..99)> <theme> {theme_parameters}

regmap40.aml

Produces REGMAP output to small .jpg and .eps files for remote viewing.

RegSetup.aml

Sets up display output for REGMAP.AML and REGMAP40.AML.

Return to top


Revised July 28, 1998 (174 macros) by Mark Henderson