updating docs

ireapps · Jun 20, 2011 · 1df3fc0 · 1df3fc0
1 parent e853a42
commit 1df3fc0
Show file tree

Hide file tree

Showing 16 changed files with 211 additions and 63 deletions.
diff --git a/docs/_build/doctrees/data.doctree b/docs/_build/doctrees/data.doctree
diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle
diff --git a/docs/_build/doctrees/quickstart.doctree b/docs/_build/doctrees/quickstart.doctree
diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo
@@ -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
diff --git a/docs/_build/html/_sources/data.txt b/docs/_build/html/_sources/data.txt
@@ -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

diff --git a/docs/_build/html/_sources/quickstart.txt b/docs/_build/html/_sources/quickstart.txt
@@ -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:
 

diff --git a/docs/_build/html/data.html b/docs/_build/html/data.html
@@ -45,31 +45,63 @@ <h3>Navigation</h3>
 
   <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>JSON<a class="headerlink" href="#json" title="Permalink to this headline">¶
   <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 @@ <h3>Navigation</h3>
       </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>

diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html
@@ -82,7 +82,7 @@ <h3>Navigation</h3>
       </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>

diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html
@@ -98,7 +98,7 @@ <h3>Navigation</h3>
       </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>

diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv
diff --git a/docs/_build/html/quickstart.html b/docs/_build/html/quickstart.html
@@ -59,7 +59,7 @@ <h2>Question 1: How does the racial/ethnic make-up of my town compare to my coun
 <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 @@ <h2>Question 1: How does the racial/ethnic make-up of my town compare to my coun
 <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 @@ <h3>Navigation</h3>
       </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>

diff --git a/docs/_build/html/search.html b/docs/_build/html/search.html
@@ -88,7 +88,7 @@ <h3>Navigation</h3>
       </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>