Permalink
Browse files

updating docs

  • Loading branch information...
1 parent e853a42 commit 1df3fc0760c2a564a83e44c32f50b9f426b02158 Curt Merrill committed Jun 20, 2011
Binary file not shown.
Binary file not shown.
Binary file not shown.
@@ -1,4 +1,4 @@
# Sphinx build info version 1
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: f2adb26c4ce0ac96fa94035bb8ef848d
+config: 5a2f905bee8d717cde7cf41129d4697b
tags: fbb0d17656682115ca4d033fb2f83ba1
@@ -2,35 +2,89 @@
Data Overview
=============
-The census.ire.org site will contain data from Summary File 1 of the 2010 Decennial Census. For full details about the data contained in these tables, please refer to Chapter 6 of the `Technical Documentation`_ provided by the Census Bureau.
+The census.ire.org site will contain data from Summary File 1 of the 2010 Decennial Census.
+For full details about the data contained in these tables,
+please refer to Chapter 6 of the `Technical Documentation`_ provided by the Census Bureau.
.. _Technical Documentation: http://www.census.gov/prod/cen2010/doc/sf1.pdf
-The Census Bureau is releasing the Summary File 1 data on a rolling basis beginning in mid June. Data for a few states will be released each week and added to the census.ire.org site until all data are available sometime in August.
+The Census Bureau is releasing the Summary File 1 data on a rolling basis
+beginning in mid June.
+Data for a few states will be released each week
+and added to the census.ire.org site until all data are available sometime in August.
+Deltas
+======
+
+For many tables and fields we were able to calculate the amount of change between 2000 and 2010.
+However, due to changes in the Census questionaire, not all fields have direct equivalents.
+
+For instance: In 2000, questions about family households asked about "own" children in the household,
+but in 2010, the questions were about "related" children, so the figures are not directly comparable.
+
+Also, some questions had more responses available in 2010 than in 2000, or vice versa.
+
+For example: The Housing Tenure table in 2000 includes number of housing units owned. But in 2010,
+the table includes units owned with a mortgage or loan and units owned free and clear.
+
+Because the responses were not separated in 2000, we can only provide a delta for the total number owned.
+
+.. _geography-label:
Geographies
===========
-The census.ire.org site will provide data at several key levels of geography: place, county subdivision, county and state.
+The census.ire.org site will provide data at several key levels of geography:
+census tract, place, county subdivision, county and state.
+
+Tract
+-----
+
+Tracts are created by the Census Bureau to contain an average of 4,000 people.
+Their boundaries may change between decennial censuses and vary in size from city blocks to entire counties, depending on population density
+
+In order to compare 2000 tracts to 2010 tracts,
+we've calculated how the population and housing units from 2000 boundaries
+would be distributed in the new 2010 boundaries using formulas provided by the Census Bureau.
+
+U.S. Census: `Tract definition`_
+
+.. _Tract definition: http://www.census.gov/geo/www/geo_defn.html#CensusTract
+
+
+Place
+-----
+
+Places in Census Parlance include incorporated places legally established under state law;
+consolidated cities, where functions of local and county governments have merged;
+and Census Designated Places, areas of significant population with a well-known name, but not legally incorporated.
+
+U.S. Census: `Place definition`_
+
+.. _Place definition: http://www.census.gov/geo/www/geo_defn.html#Place
+
+
+County Subdivision
+------------------
+
+In some states, townships are considered County Subdivisions, not "places."
-Places and county subdivisions
-------------------------------
+U.S. Census: `County Subdivision definition`_
-Counties
---------
+.. _County Subdivision definition: http://www.census.gov/geo/www/geo_defn.html#CountySubdivision
-Counties in most states.
-Parishes in Louisiana.
+County and county equivalents
+-----------------------------
-Alaska has boroughs, and county-equivalents for areas of the state not part of borough.
+Counties are the primary division of most states.
+In Alaska, county-equivalent areas are known as "boroughs,"
+and in Louisiana they are known as "parishes."
+U.S. Census: `County definition`_
-States
-------
+.. _County definition: http://www.census.gov/geo/www/geo_defn.html#County
-Self explanatory.
Formats
@@ -41,7 +95,7 @@ CSV
These are comma-separated-value files. They are plain-text files that can be opened in Excel or other programs for further analysis of the data.
-The fields in the CSV files will be transposed.
+CSV files will be transposed from the format seen on the web site.
KML
@@ -12,7 +12,9 @@ Question 1: How does the racial/ethnic make-up of my town compare to my county a
.. note:: For the purposes of this tutorial, you live in Anniston, Alabama.
When census.ire.org first loads, you'll be asked what geography level you're interested in.
-For a detailed explanation of these terms, please see <tk>.
+For a detailed explanation of these terms, please see the `Census Geography Documentation`_.
+
+.. _Census Geography Documentation: http://www.census.gov/geo/www/geo_defn.html
We are interested in the town of Anniston,
which is a place according to the Census Bureau,
@@ -26,7 +28,7 @@ We're looking for a place in Alabama, so find the link for Alabama and click it.
You should now see several columns of places in Alabama.
-.. note:: The Census Bureau has several suffixes for "places": town, city and CDP. For details on what these mean, please see <tk>.
+.. note:: The Census Bureau has several suffixes for "places": town, city and CDP. For details on what these mean, please see :ref:`geography-label`.
The list of places is fairly long; you have two options:
@@ -45,31 +45,63 @@
<div class="section" id="data-overview">
<h1>Data Overview<a class="headerlink" href="#data-overview" title="Permalink to this headline">¶</a></h1>
-<p>The census.ire.org site will contain data from Summary File 1 of the 2010 Decennial Census. For full details about the data contained in these tables, please refer to Chapter 6 of the <a class="reference external" href="http://www.census.gov/prod/cen2010/doc/sf1.pdf">Technical Documentation</a> provided by the Census Bureau.</p>
-<p>The Census Bureau is releasing the Summary File 1 data on a rolling basis beginning in mid June. Data for a few states will be released each week and added to the census.ire.org site until all data are available sometime in August.</p>
+<p>The census.ire.org site will contain data from Summary File 1 of the 2010 Decennial Census.
+For full details about the data contained in these tables,
+please refer to Chapter 6 of the <a class="reference external" href="http://www.census.gov/prod/cen2010/doc/sf1.pdf">Technical Documentation</a> provided by the Census Bureau.</p>
+<p>The Census Bureau is releasing the Summary File 1 data on a rolling basis
+beginning in mid June.
+Data for a few states will be released each week
+and added to the census.ire.org site until all data are available sometime in August.</p>
+<div class="section" id="deltas">
+<h2>Deltas<a class="headerlink" href="#deltas" title="Permalink to this headline">¶</a></h2>
+<p>For many tables and fields we were able to calculate the amount of change between 2000 and 2010.
+However, due to changes in the Census questionaire, not all fields have direct equivalents.</p>
+<p>For instance: In 2000, questions about family households asked about &#8220;own&#8221; children in the household,
+but in 2010, the questions were about &#8220;related&#8221; children, so the figures are not directly comparable.</p>
+<p>Also, some questions had more responses available in 2010 than in 2000, or vice versa.</p>
+<p>For example: The Housing Tenure table in 2000 includes number of housing units owned. But in 2010,
+the table includes units owned with a mortgage or loan and units owned free and clear.</p>
+<p>Because the responses were not separated in 2000, we can only provide a delta for the total number owned.</p>
+</div>
<div class="section" id="geographies">
-<h2>Geographies<a class="headerlink" href="#geographies" title="Permalink to this headline">¶</a></h2>
-<p>The census.ire.org site will provide data at several key levels of geography: place, county subdivision, county and state.</p>
-<div class="section" id="places-and-county-subdivisions">
-<h3>Places and county subdivisions<a class="headerlink" href="#places-and-county-subdivisions" title="Permalink to this headline">¶</a></h3>
+<span id="geography-label"></span><h2>Geographies<a class="headerlink" href="#geographies" title="Permalink to this headline">¶</a></h2>
+<p>The census.ire.org site will provide data at several key levels of geography:
+census tract, place, county subdivision, county and state.</p>
+<div class="section" id="tract">
+<h3>Tract<a class="headerlink" href="#tract" title="Permalink to this headline">¶</a></h3>
+<p>Tracts are created by the Census Bureau to contain an average of 4,000 people.
+Their boundaries may change between decennial censuses and vary in size from city blocks to entire counties, depending on population density</p>
+<p>In order to compare 2000 tracts to 2010 tracts,
+we&#8217;ve calculated how the population and housing units from 2000 boundaries
+would be distributed in the new 2010 boundaries using formulas provided by the Census Bureau.</p>
+<p>U.S. Census: <a class="reference external" href="http://www.census.gov/geo/www/geo_defn.html#CensusTract">Tract definition</a></p>
+</div>
+<div class="section" id="place">
+<h3>Place<a class="headerlink" href="#place" title="Permalink to this headline">¶</a></h3>
+<p>Places in Census Parlance include incorporated places legally established under state law;
+consolidated cities, where functions of local and county governments have merged;
+and Census Designated Places, areas of significant population with a well-known name, but not legally incorporated.</p>
+<p>U.S. Census: <a class="reference external" href="http://www.census.gov/geo/www/geo_defn.html#Place">Place definition</a></p>
</div>
-<div class="section" id="counties">
-<h3>Counties<a class="headerlink" href="#counties" title="Permalink to this headline">¶</a></h3>
-<p>Counties in most states.</p>
-<p>Parishes in Louisiana.</p>
-<p>Alaska has boroughs, and county-equivalents for areas of the state not part of borough.</p>
+<div class="section" id="county-subdivision">
+<h3>County Subdivision<a class="headerlink" href="#county-subdivision" title="Permalink to this headline">¶</a></h3>
+<p>In some states, townships are considered County Subdivisions, not &#8220;places.&#8221;</p>
+<p>U.S. Census: <a class="reference external" href="http://www.census.gov/geo/www/geo_defn.html#CountySubdivision">County Subdivision definition</a></p>
</div>
-<div class="section" id="states">
-<h3>States<a class="headerlink" href="#states" title="Permalink to this headline">¶</a></h3>
-<p>Self explanatory.</p>
+<div class="section" id="county-and-county-equivalents">
+<h3>County and county equivalents<a class="headerlink" href="#county-and-county-equivalents" title="Permalink to this headline">¶</a></h3>
+<p>Counties are the primary division of most states.
+In Alaska, county-equivalent areas are known as &#8220;boroughs,&#8221;
+and in Louisiana they are known as &#8220;parishes.&#8221;</p>
+<p>U.S. Census: <a class="reference external" href="http://www.census.gov/geo/www/geo_defn.html#County">County definition</a></p>
</div>
</div>
<div class="section" id="formats">
<h2>Formats<a class="headerlink" href="#formats" title="Permalink to this headline">¶</a></h2>
<div class="section" id="csv">
<h3>CSV<a class="headerlink" href="#csv" title="Permalink to this headline">¶</a></h3>
<p>These are comma-separated-value files. They are plain-text files that can be opened in Excel or other programs for further analysis of the data.</p>
-<p>The fields in the CSV files will be transposed.</p>
+<p>CSV files will be transposed from the format seen on the web site.</p>
</div>
<div class="section" id="kml">
<h3>KML<a class="headerlink" href="#kml" title="Permalink to this headline">¶</a></h3>
@@ -91,10 +123,12 @@
<h3><a href="index.html">Table Of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">Data Overview</a><ul>
+<li><a class="reference internal" href="#deltas">Deltas</a></li>
<li><a class="reference internal" href="#geographies">Geographies</a><ul>
-<li><a class="reference internal" href="#places-and-county-subdivisions">Places and county subdivisions</a></li>
-<li><a class="reference internal" href="#counties">Counties</a></li>
-<li><a class="reference internal" href="#states">States</a></li>
+<li><a class="reference internal" href="#tract">Tract</a></li>
+<li><a class="reference internal" href="#place">Place</a></li>
+<li><a class="reference internal" href="#county-subdivision">County Subdivision</a></li>
+<li><a class="reference internal" href="#county-and-county-equivalents">County and county equivalents</a></li>
</ul>
</li>
<li><a class="reference internal" href="#formats">Formats</a><ul>
@@ -145,7 +179,7 @@
</ul>
</div>
<div class="footer">
- &copy; Copyright 2011, Curt.
+ &copy; Copyright 2011, IRE.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
@@ -82,7 +82,7 @@ <h1 id="index">Index</h1>
</ul>
</div>
<div class="footer">
- &copy; Copyright 2011, Curt.
+ &copy; Copyright 2011, IRE.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
@@ -98,7 +98,7 @@
</ul>
</div>
<div class="footer">
- &copy; Copyright 2011, Curt.
+ &copy; Copyright 2011, IRE.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
Binary file not shown.
@@ -59,7 +59,7 @@
<p class="last">For the purposes of this tutorial, you live in Anniston, Alabama.</p>
</div>
<p>When census.ire.org first loads, you&#8217;ll be asked what geography level you&#8217;re interested in.
-For a detailed explanation of these terms, please see &lt;tk&gt;.</p>
+For a detailed explanation of these terms, please see the <a class="reference external" href="http://www.census.gov/geo/www/geo_defn.html">Census Geography Documentation</a>.</p>
<p>We are interested in the town of Anniston,
which is a place according to the Census Bureau,
so we&#8217;ll click on the &#8220;Places&#8221; link.</p>
@@ -72,7 +72,7 @@
<p>You should now see several columns of places in Alabama.</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
-<p class="last">The Census Bureau has several suffixes for &#8220;places&#8221;: town, city and CDP. For details on what these mean, please see &lt;tk&gt;.</p>
+<p class="last">The Census Bureau has several suffixes for &#8220;places&#8221;: town, city and CDP. For details on what these mean, please see <a class="reference internal" href="data.html#geography-label"><em>Geographies</em></a>.</p>
</div>
<p>The list of places is fairly long; you have two options:</p>
<ol class="arabic simple">
@@ -156,7 +156,7 @@
</ul>
</div>
<div class="footer">
- &copy; Copyright 2011, Curt.
+ &copy; Copyright 2011, IRE.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
@@ -88,7 +88,7 @@ <h1 id="search-documentation">Search</h1>
</ul>
</div>
<div class="footer">
- &copy; Copyright 2011, Curt.
+ &copy; Copyright 2011, IRE.
Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.0.7.
</div>
</body>
Oops, something went wrong.

0 comments on commit 1df3fc0

Please sign in to comment.