Return to README CVS log

Up to [Research Unix] / researchv10no / cmd / map / export

Annotation of researchv10no/cmd/map/export/README, revision 1.1.1.1

1.1       root        1: MATERIALS
                      2: 
                      3: Manuals are included in two forms.
                      4:        formatted ASCII file:
                      5:                map.man
                      6:        input for troff -man:
                      7:                map.5, map.7, proj.3, proj.5, route.1
                      8: 
                      9: The source directory has two subdirectories: 
                     10:        libmap          source for all the projection subroutines
                     11:        mapdata         World Data Bank I, etc.
                     12: 
                     13: The source is written in ANSI C.  Check CFLAGS and CC in the
                     14: Makefile and make them reflect your system's conventions.
                     15: 
                     16: QUICK TEST
                     17: 
                     18: For a quick test, to see whether you can compile and compute, try this
                     19: test, which makes "map" and checks its output for a bit of Africa:
                     20: 
                     21:        make quicktest
                     22: 
                     23: PLOTTING FILTERS
                     24: 
                     25: Map produces output for a plotting filter (not included).
                     26: Unfortunately there is no Unix standard for plotting.
                     27: Here are ways to compile for various filters.
                     28: 
                     29:        make            For System V and SunOS filters plot(1)
                     30:                        or tplot(1).
                     31: 
                     32:        make v10        For v10 research system plot(1), not
                     33:                        compatible with System V.
                     34: 
                     35:        make ps         PostScript.  Maps are drawn in a 6.5-inch
                     36:                        square centered 1 inch from the top of an
                     37:                        8.5x11 page.  To change, edit the
                     38:                        PostScript or plotPS.c.
                     39: 
                     40:        As map uses only simple plotting features, it is usually
                     41:        easy to interface to other plotting packages. See
                     42:        iplot.h (used with "make v10") for details.
                     43: 
                     44: When you have a plotting filter, you can test map in the current
                     45: directory as follows.  For sample arguments, see EXAMPLES on the
                     46: map(7) man page.
                     47: 
                     48:        MAPDIR=./mapdata MAPPROG=./map  map.sh arguments | filter
                     49: 
                     50: INSTALLATION
                     51: 
                     52: For real installation, examine the recipe for
                     53: 
                     54:        make install
                     55: 
                     56: It puts the map shell script in /usr/bin and everything else
                     57: in /usr/lib/map.  If you want to put things elsewhere, adjust
                     58: variables MAPDIR and MAPPROG in map.sh.  map.sh will become
                     59: the command "map".  After installation it will be run thus:
                     60: 
                     61:        map arguments | filter
                     62: 
                     63: POSSIBLE PROBLEMS
                     64: 
                     65: Options 
                     66:        Option -f oes not work because World Data Bank II is
                     67:        not in this distribution on account of its size (13Mb).
                     68: 
                     69:        -y files are like v10, not Sys V, plot files.
                     70:        The plot(5) man page from v10 is included for reference,
                     71:        although most of it is irrelevant for this application.
                     72: 
                     73: Library 
                     74:        At least one version of tplot(1) has been seen to garble
                     75:        the output.  In this case the trouble went away by
                     76:        compiling map with -l4014 instead of -lplot; see plot(3).
                     77: 
                     78:        Collisions with a nonstandard library function sincos()
                     79:        have been observed.  sincos will have to be renamed 
                     80:        in map.h and all .c files.
                     81: 
                     82: Man pages
                     83:        The man pages were produced with a -man macros slightly
                     84:        different from Sys V.  If you change font L to B throughout
                     85:        you will probably get a passable result.
                     86: 
                     87: REFERENCES
                     88: 
                     89: Most standard texts on cartography discuss the major projections
                     90: and their uses.  Some thorough works:
                     91:   
                     92:   J. P. Snyder, An Album of Map Projections, US Geological Survey
                     93:   Professional Paper 1453, USGPO Washington (1989)
                     94:   
                     95:   J. P. Snyder, Map Projections - A Working Manual, US Geological
                     96:   Survey Professional Paper 1395, USGPO Washington (1987)
                     97:   
                     98:   D. H. Maling, Coordinate Systems and Map Projections, George
                     99:   Philip and Son, London (1973)
                    100:   
                    101:   J. A. Steers, An Introduction to the Study of Map Projections,
                    102:   Univ. London Press (1970)
                    103: 
                    104: A short introduction, with 24 sample maps drawn by the "map"
                    105: program itself and the commands to draw them:
                    106: 
                    107:   M. D.        McIlroy, Projections: Mapmakers' Answers to the Riddle of
                    108:   Presenting a Round Earth on Flat Paper, AT&T Bell Labs Computing
                    109:   Science Tech. Report 140 (1987), order from Computing Science
                    110:   Reports, Room 2C579, AT&T Bell Labs Murray Hill, NJ 07974
                    111: 
                    112:   [In this report, option -s is used in an obsolete way.  It
                    113:   should always be replaced by -s2, with -s1 added to the
                    114:   preceding command.]
                    115: 
                    116: Doug McIlroy
                    117: 201-582-6050
                    118: research!doug
                    119: [email protected]

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.