Clipping Geodata - cut the boundaries of the area to your city or county boundaries

• Click Vector... Geoprocessing Tools... Clip to open the clip menu. Set Input Vector to City_BBand_Select and Clip Layer to the city or county limits. Use Browse to select a name such as City_BBand_Clip as the name for the shapefile.
• Click OK and wait (up to several minutes) while the Clip operation runs.

Dividing into Polygons

• The output shapefile is a mix of different ISPs. From the Vector menu, select Data Management Tools > Split Vector Layer
• Select your clipped broadband layer as the Input Vector and DBANAME as the Unique ID Field.
• For output file, create a new folder and select it with the file tool. Click OK to create the layers.
• Add the shapefile layers to the map - they will have names such as City_BBand_Clip_DBANAME__ISP NAME.shp.

Saving as Google Earth KML

• You can right-click each layer in the QGIS menu and save it as a KML file, to view them in Google Earth

Extracting Holes

• Run the included findholes.py script to create KML and JavaScript files

python findholes.py SOURCE_FILE.kml OUTPUT_NAME

• OUTPUT_NAME.kml is a file you can open in Google Earth and other mapping applications

• OUTPUT_NAME.js is a script which adds coordinates of all of the holes to an array. Attach it to macon.erb or other template

Forking Manchester Make these changes to manchester.erb

• Replace manchester.js with the URL of your generated JavaScript file.

• Change the config object

  var config = { latitude: 42.992124, longitude: -71.448266, zoom: 13, city: "Manchester", latmin: 42.943387, latmax: 43.023758, lngmin: -71.49478, lngmax: -71.379773 };

Add your city to pdf_archive.rb. Using Honolulu as an example:

get '/honolulu' do
  erb :honolulu
end

git clone git://github.com/mapmeld/BBandXplor.git
cd BBandXplor
gem install bundle
bundle

bundle exec rake

gem install foreman
foreman start

You can now open the app in your browser http://localhost:3000

Running this on Heroku requires the following steps:

gem install heroku
heroku apps:create YOUR_APP_NAME_HERE --stack cedar

We also need to configure it to run in production

heroku config:add RACK_ENV=production

The MongoHQ or MongoLab Addons will give us a small free MongoDB instance for storing our documents.

heroku addons:add mongohq:free

git push heroku master
heroku scale web=1 worker=1

Log into heroku.com and open the app's page On the right, under the banner, select MongoHQ from Addons On the MongoHQ page, select the sv_reports collection On the row of tabs (Documents open by default) select Indexes Click "Create a Geospatial Index". Set Location Field to "latlng" with Min -180 and Max 180 Click "Create Index" to enable searching reports by location

Free BSD licensed

Copyright (c) 2011 Jonathan Hoyt Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.