Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Use Public Lab's MapKnitter to turn your aerial images into projected maps for print and web
HTML Ruby JavaScript CSS
tree: 0e86bd9eb6

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
app
config
db
doc
lib
log
public
release
script
test
vendor/plugins
.gitignore
.gitmodules
APACHE-REVERSE-PROXY-EXAMPLE
LICENSE
LICENSE-RAILS
README
README-RAILS
Rakefile

README

oooo                     o8o      .       .                      
`888                     `"'    .o8     .o8                      
 888  oooo  ooo. .oo.   oooo  .o888oo .o888oo  .ooooo.  oooo d8b 
 888 .8P'   `888P"Y88b  `888    888     888   d88' `88b `888""8P 
 888888.     888   888   888    888     888   888ooo888  888     
 888 `88b.   888   888   888    888 .   888 . 888    .o  888     
o888o o888o o888o o888o o888o   "888"   "888" `Y8bod8P' d888b    


Use Public Laboratory's Map Knitter to upload your own aerial imagery and combine it into a GeoTiff and TMS/OpenLayers map.

Copyright 2010-2011 Jeffrey Warren

==========================
LICENSE
==========================

PLOTS Map Knitter is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

PLOTS Map Knitter is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with PLOTS Map Knitter.  If not, see <http://www.gnu.org/licenses/>.

==========================
ABOUT
==========================

Use Public Laboratory's Map Knitter to upload your own aerial imagery and combine it into a GeoTiff and TMS/OpenLayers map.

Read more about PLOTS Map Knitter at: http://publiclaboratory.org/wiki/plots-map-toolkit

The Public Laboratory for Open Technology and Science (PLOTS) is a community which develops and applies open-source tools to environmental exploration and investigation. By democratizing inexpensive and accessible “Do-It-Yourself” techniques, Public Laboratory creates a collaborative network of practitioners who actively re-imagine the human relationship with the environment.

The core PLOTS program is focused on “civic science” in which we research open source hardware and software tools and methods to generate knowledge and share data about community environmental health. Our goal is to increase the ability of underserved communities to identify, redress, remediate, and create awareness and accountability around environmental concerns. PLOTS achieves this by providing online and offline training, education and support, and by focusing on locally-relevant outcomes that emphasize human capacity and understanding.

Join now at: http://publiclaboratory.org/join

==========================
INSTALLATION
==========================

You'll need Ruby on Rails ~2.3.11, Ruby 1.8.7 (Ruby 1.9.x doesn't work for now as there is no packaged version of the geohash gem yet for 1.9.x), and GDAL >=1.7.x (gdal.org)

1) Download source from http://github.com/jywarren/mapknitter
2) Run rake gems:install from Rails root to install mysql, geokit, image_science, recaptcha, will_paginate.
3) Install davetroy-geohash from github source; first add github source with "gem sources -a http://gems.github.com" then run "gem install davetroy-geohash". (probably not needed anymore really)
3) Manually run "gem install RubyInline" - this was causing trouble when done from environment.rb
4) Install Amazon S3 gem with "gem install aws-s3" if you are using Amazon S3 for most image storage
5) Copy and configure config/database.yml from config/database.yml.example
6) Initialize database with "rake db:migrate"
7) Change the Google Maps API key at config/config.yml, which you can copy from config/config.yml.example. If you're running it locally, you can use the default which is provided; it's set up for http://localhost:3000. For a new one visit http://code.google.com/apis/maps/signup.html
8) Enter the ReCaptcha public and private keys in config/initializers/recaptcha.rb, copied from recaptcha.rb.example
9) Start rails with "script/server -p 3000" or "passenger start -p 3000" from the Rails root and open http://localhost:3000 in a web browser.

==========================
BITNAMI INSTALLATION
==========================

This is experimental, but if it works, you'll have a local version which you can carry around on a USB stick. We hope it will be useful for low-bandwidth situations. But beware - it hasn't been tested!

From the Bitnami RubyStack README:
To install BitNami RubyStack you will need:

    - Intel x86 or compatible processor
    - Minimum of 512 MB RAM 
    - Minimum of 150 MB hard drive space
    - TCP/IP protocol support
    - Compatible operantig systems:
      - An x86 Linux operating system.
      - A 32-bit Windows operating system such as Windows 2000, XP, Vista
      or Windows Server 2003.
      - An OS X operating system (PowerPC or x86).

You will also need: 
    - GDAL >= 1.7.x (gdal.org)
    - some source of local tiles, such as from TileStream (mapbox.com)

1) Download the Bitnami.org RubyStack: http://bitnami.org/stack/rubystack, and run the installer.
2) Place this MapKnitter folder in the resulting "projects" folder inside "rubystack-2.2-2" (get MapKnitter at http://github.com/jywarren/mapknitter or https://github.com/jywarren/mapknitter/zipball/master)
3) Open a shell prompt/terminal, and enter the "rubystack-2.2-2" folder.
4) Type ".rubyconsole" to start the Bitnami ruby console.
5) Type "cd projects/mapknitter" to enter the MapKnitter project folder.
6) Follow the above steps for a normal installation. 

Something went wrong with that request. Please try again.