Browse files

A few minor doc tweaks in honor of @flowingdata reference

  • Loading branch information...
1 parent a7f7510 commit 7d7a306940b5cdd7f50ec6e2b016254d40184ace @JoeGermuska JoeGermuska committed Aug 29, 2011
View
13 censusweb/api/templates/bulkdata.html
@@ -19,8 +19,15 @@
<span class="button" id="shapefile-download">Download Shapefile</span>
</div>
</form>
+<p>
+ If you are using a SQL database to analyze this data, you can use <code>CREATE TABLE</code> scripts for all 331 tables from <a href="https://github.com/ireapps/census/tree/master/tools/sql/ire_export">the IRE Census GitHub website</a>. There you can also find <a href="https://github.com/ireapps/census/tree/master/tools/metadata">keys to the column header codes</a> in CSV and JSON format.
+</p>
+
+<p>
+ The first several columns in each of these data files are selected values from the "geographic headers" files. For details, consult chapter 6 ("Data Dictionary") of the <a href="http://2010.census.gov/news/press-kits/summary-file-1.html">SF1 Technical Documentation</a>. The remaining columns (the specific data for each table) are named according to the table name and field number. Comparative values from the 2000 census have the same column header followed by ".2000", e.g. the total population for a geography, from table P1, field 1, has a header <strong>P001001</strong> and the 2000 comparable value is <strong>P001001.2000</strong>. Note that for convenience, each file repeats the total population count (<strong>POP100</strong>, <strong>POP100.2000</strong>) and housing unit count (<strong>HU100</strong>,<strong>HU100.2000</strong>) for the covered geography. The exact codes for these column headers are logically equivalent to those in the SF1 technical documentation, but sometimes vary by the number of padding characters.
+</p>
<p id="bulk-download-url-format-explainer">
- Instead of the form, you can build your own download URLs using this simple pattern: <div id="bulk-download-url-format"><span>{{ settings.API_URL }}/<strong>SS</strong>/all_<strong>LLL</strong>_in_<strong>SS</strong>.<strong>TT</strong>.csv</span></div> with the following substitutions:</p>
+ Instead of the form, you can build your own download URLs using this simple pattern: <span id="bulk-download-url-format"><span>{{ settings.API_URL }}/<strong>SS</strong>/all_<strong>LLL</strong>_in_<strong>SS</strong>.<strong>TT</strong>.csv</span></span> with the following substitutions:</p>
<dl id="bulk-download-url-format-explainer-list">
<dt>SS</dt><dd>The two-digit State FIPS code (note this appears twice in the URL)</dd>
<dt>LLL</dt><dd>The three-digit summary level code.</dd>
@@ -35,9 +42,7 @@
<code>wget -O - {{ settings.API_URL }}/09/all_060_in_09.PCT7.csv | gzcat &gt; all_060_in_09.PCT7.csv</code>
</li>
</ul>
-<p>
- The first several columns in each of these data files are selected values from the "geographic headers" files. For details, consult chapter 6 ("Data Dictionary") of the <a href="http://2010.census.gov/news/press-kits/summary-file-1.html">SF1 Technical Documentation</a>. The remaining columns (the specific data for each table) are named according to the table name and field number. Comparative values from the 2000 census have the same column header followed by ".2000", e.g. the total population for a geography, from table P1, field 1, has a header <strong>P001001</strong> and the 2000 comparable value is <strong>P001001.2000</strong>. Note that for convenience, each file repeats the total population count (<strong>POP100</strong>, <strong>POP100.2000</strong>) and housing unit count (<strong>HU100</strong>,<strong>HU100.2000</strong>) for the covered geography. The exact codes for these column headers are logically equivalent to those in the SF1 technical documentation, but sometimes vary by the number of padding characters. A convenient way to "decode" the column headers is the <code>sf1_labels</code> metadata file on the <a href="https://github.com/ireapps/census/tree/master/tools/metadata">IRE Census GitHub website</a>.
-</p>
+
For complete Census Bureau Data, see:
<ul id="census-data-links">
<li><a href="http://www2.census.gov/census_2010/04-Summary_File_1/">Census 2010 Summary File 1</a> (raw data)</li>
View
3 censusweb/api/templates/docs/json.html
@@ -46,6 +46,9 @@
<p>
If the code above is included in a page, then when the data is loaded, a simple alert pop-up will appear indicating the total population for the Urban Honolulu CDP (Census Designated Place)
</p>
+<p>
+ The beginnings of a javascript library which encapsulates this and other basic data access can be found at <a href="https://github.com/ireapps/census/blob/master/tools/js/ire_census.js">the IRE Census GitHub repository.</a> The code there is fully usable, but has minimal documentation. Feel free to fork it and improve it!
+</p>
<h2>What does JSONP mean for me if I'm trying to use the data in a non-JavaScript programming language?</h2>
<p>First, consider whether the JSON API is right for you in the first place. In most cases, we guess that you might actually prefer our <a href="{% url bulkdata %}">bulk data in CSV format</a>.</p>
<p>Next, note that for web-efficiency, data on the server is gzip-encoded. Most browsers decode this automatically, but many http client libraries do not.</p>
View
6 censusweb/media/css/census.css
@@ -391,9 +391,9 @@ nav {
#bulk-download-url-format { margin: 5px 5px;}
#bulk-download-url-format span { background-color: #eeeeee; border: 1px solid #aaaaaa; font-family: monospace; padding: 3px 3px; clear: both;}
p#bulk-download-url-format-explainer {margin-top: 15px;}
-dl#bulk-download-url-format-explainer-list {margin-top: 5px; margin-left: 10px;}
-dl#bulk-download-url-format-explainer-list dt { font-weight: bold;}
-dl#bulk-download-url-format-explainer-list dd { margin-left: 10px; }
+dl#bulk-download-url-format-explainer-list {margin-top: 5px; margin-left: 10px; margin-bottom: 10px;}
+dl#bulk-download-url-format-explainer-list dt { font-weight: bold; float: left; clear: left; margin-right: 10px;}
+dl#bulk-download-url-format-explainer-list dd { margin-left: 35px; }
#gzip-note { margin: 15px 0 0 0; }
#gzip-code-example { margin: 0 20px 20px;}
#census-data-links { margin: 0 20px 20px;}

0 comments on commit 7d7a306

Please sign in to comment.