Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 67 lines (51 sloc) 3.541 kb
5854c3f @nvkelso explicately marked readme as markdown for GH styling
nvkelso authored
1 Field Papers is the codebase behind http://fieldpapers.org.
2
336d2ef @nvkelso Update README.md
nvkelso authored
3 See [INSTALL.md](https://github.com/stamen/fieldpapers/blob/master/INSTALL.md) for a guide to installing Field Papers.
5854c3f @nvkelso explicately marked readme as markdown for GH styling
nvkelso authored
4
5 ## About Field Papers
6
7 Field Papers allows you to print a multipage paper atlas of anywhere in
8 the world and take it outside, offline, in the field. You can scribble
9 on it, draw things, make notes.
10
11 When you upload a snapshot of your print to Field Papers, we'll do some
12 magic on the server to put it back in the right spot on the map. You can
13 transcribe your notes into digital form and share the result with your
14 friends or download the notes for later analysis.
15
16 You don't need a [GPS](http://en.wikipedia.org/wiki/Global_Positioning_System)
17 to make a map or learn complicated desktop [GIS](http://en.wikipedia.org/wiki/Geographic_information_system)
18 software to use Field Papers. It's as easy as print, mark, scan.
19
20 This project is a continuation of [Walking Papers](http://walkingpapers.org),
21 which was built for the OpenStreetMap (OSM) editing community. Field Papers
22 allows you to print multiple-page atlases using several map styles (including
23 satellite imagery and black and white cartography to save ink) and has built
24 in note annotation tools with GIS format downloads. Field Papers also
25 supports user accounts so you can save “your stuff” for later, or use the
26 service anonymously. Maps from the two systems work together if you want OSM editing (see below).
27
28 Curious about [OpenStreetMap](http://openstreetmap.org)? It's a wiki-style
29 map of the world that anyone can edit and it needs your help to add content.
30 Field Papers and Walking Papers both provide tools to “round trip” map data
31 through paper, to make it easier to perform the kinds of eyes-on-the-street
32 edits, as well as distributing the load by making it possible for legible,
33 easy notes to be shared and turned into real geographical data. Don't see
34 your street on OpenStreetMap? Please add it!
35
aa72372 @nvkelso formatting
nvkelso authored
36 ## Technical bits
5854c3f @nvkelso explicately marked readme as markdown for GH styling
nvkelso authored
37
38 This program is free software; you can redistribute it and/or modify it under
39 the terms of the GNU General Public License as published by the Free Software
40 Foundation; either version 2 of the License, or (at your option) any later
41 version.
42
43 This program is distributed in the hope that it will be useful, but WITHOUT ANY
44 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
45 PARTICULAR PURPOSE. See the GNU General Public License for more details.
46
47 You should have received a copy of the GNU General Public License along with
48 this program; if not, write to the Free Software Foundation, Inc., 51 Franklin
49 Street, Fifth Floor, Boston, MA 02110-1301 USA.
50
aa72372 @nvkelso formatting
nvkelso authored
51 ###There are two main components here:###
5854c3f @nvkelso explicately marked readme as markdown for GH styling
nvkelso authored
52
6449f23 @nvkelso formatting
nvkelso authored
53 1. **Site** - The user-facing website is written in PHP and MySQL, and has been developed
5854c3f @nvkelso explicately marked readme as markdown for GH styling
nvkelso authored
54 to work adequately well in a commodity shared hosting environment, such as
55 the Pair.com "webmaster" account I use to host Walking Papers.
56
6449f23 @nvkelso formatting
nvkelso authored
57 2. **Decoder** - The ugly math bits are done in an offline process that consumes a queue
5854c3f @nvkelso explicately marked readme as markdown for GH styling
nvkelso authored
58 of freshly-scanned images from the main site, runs them through the
59 image-recognition algorithm, and posts back georectified image tiles
60 for editing. You can run a bunch of these in parallel to make jobs go
61 faster, and they should be perfectly fine on small EC2 instances or
62 a box plugged into plain old residential DSL.
63
64 It's worth mentioning that the image recognition part of the work relies
65 on a patented algorithm called SIFT:
66 http://en.wikipedia.org/wiki/Scale-invariant_feature_transform
Something went wrong with that request. Please try again.