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.