]>
gitweb.michael.orlitzky.com - dead/census-tools.git/blob - bin/wkt2pop
4 Find the total population contained within a geometric object.
8 Our input is an OGC Well-Known Text[1] string. This string is used as
9 part of a database query that finds the population contained within
10 (i.e. 'underneath') the geometric object corresponding to the WKT
13 [1] http://en.wikipedia.org/wiki/Well-known_text
20 from optparse
import OptionParser
22 # Basically, add '../src' to our path.
23 # Needed for the imports that follow.
24 site
.addsitedir(os
.path
.dirname(os
.path
.abspath(sys
.argv
[0])) + '/../src')
26 import Configuration
.Defaults
29 usage
= '%prog [options] <well-known text representation>'
31 # -h (help) Conflicts with -h HOSTNAME
32 parser
= OptionParser(usage
=usage
, add_help_option
= False)
34 # Use this module's docstring as the description.
35 parser
.description
= __doc__
.strip()
37 parser
.add_option('-h',
39 help='The hostname/address where the database is located.',
40 default
=Configuration
.Defaults
.DATABASE_HOST
)
42 parser
.add_option('-d',
44 help='The database in which the population data are stored.',
45 default
=Configuration
.Defaults
.DATABASE_NAME
)
47 parser
.add_option('-U',
49 help='The username who has access to the database.',
50 default
=Configuration
.Defaults
.DATABASE_USERNAME
)
52 parser
.add_option('-s',
55 help="SRID of the input geometry. Defaults to %s." % Configuration
.Defaults
.SRID
,
56 default
=Configuration
.Defaults
.SRID
)
59 (options
, args
) = parser
.parse_args()
62 print "\nERROR: You must supply a geometric object in Well-Known Text format.\n"
64 print '' # Print a newline.
65 raise SystemExit(ExitCodes
.NOT_ENOUGH_ARGS
)
68 conn
= pgdb
.connect(host
=options
.host
,
69 database
=options
.database
,
70 user
=options
.username
)
72 cursor
= conn
.cursor()
74 # We're ready to build our query, one step at a time. Firsy, we store
75 # the Text->Geom conversion in a variable; this just makes the query a
76 # little easier to read.
77 geometric_object
= "ST_GeomFromText('%s', %d)" % (args
[0], options
.srid
)
79 # We want to compute the population "under" the geometric object. We
80 # can compute the percentage of a block that is covered by taking the
81 # area of (the intersection of the object and the block) divided by
82 # the total area of the block.
84 # Once we know the percentage covered, we just multiply that value by
85 # the total population in the block to find the population that is
86 # covered. The sum of these values over all blocks is our final
90 SELECT SUM(sf1_blocks.pop100 *
91 ( ST_Area(ST_Intersection(%s, tiger.the_geom))
92 / ST_Area(tiger.the_geom) )
93 ) AS covered_population
94 """ % geometric_object
97 # Join our two block tables, so that we have both the demographic
101 FROM (sf1_blocks INNER JOIN tiger
102 ON sf1_blocks.tiger_blkidfp00 = tiger.blkidfp00)
106 # We only need to calculate the covered population for the blocks
107 # that actually intersect our object.
110 WHERE (ST_Intersects(%s, tiger.the_geom))
111 """ % geometric_object
114 # And we only take the first result, since they're all going to be the
115 # same (our query returns the sum once for each block).
121 cursor
.execute(query
)
122 rows
= cursor
.fetchall()
125 population
= rows
[0][0]
128 print 'Error: No rows returned.'
129 raise SystemExit(ExitCodes
.NO_RESULTS
)