Public Lab Wiki documentation

MapMill is the Public Lab tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps of the Gulf Coast and beyond. Help us with these projects by choosing the sharpest, clearest, best images.

If you are creating your own maps, MapMill is a great way to offer a more accessible and inclusive first step in the process of turning images into maps. Email the link to your MapMill site to your community, post it on your blog or on Facebook. It's a great lightweight way to keep people engaged after the flight is over, to reach out to a wider group of folks with new opportunities to participate, and to raise public awareness around the subject of your map.

To start using MapMill, contact on the "plots-dev" developers mailing list

Setting up your own local copy of MapMill

If you have low bandwidth or don't want to share your map data, you can run MapMill yourself, on your computer. Follow these steps and email plots-dev@googlegroups.com (or join the developers mailing list) with questions or for troubleshooting.

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill into the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• Start uploading and sorting!

To keep in mind:

• This may run slowly on a small, weak computer like my netbook
• We'll try to get Passenger installed or something soon so it can be multi-threaded, in the meantime it may only be able to handle one pageload at a time.
• To connect other computers, find out your IP address (linux/mac: type "ifconfig" and it's the one that looks like 192.x.x.x or something) and any computer on the same local network should be able to use it by going to 192.0.0.1:3000 (or whatever your IP address was plus ":3000".

MapMill is the PLOTS tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps of the Gulf Coast and beyond. Help us with these projects by choosing the sharpest, clearest, best images.

If you are creating your own maps, MapMill is a great way to offer a more accessible and inclusive first step in the process of turning images into maps. Email the link to your MapMill site to your community, post it on your blog or on Facebook. It's a great lightweight way to keep people engaged after the flight is over, to reach out to a wider group of folks with new opportunities to participate, and to raise public awareness around the subject of your map.

To start using MapMill, contact staff@publiclaboratory.org

Roadmap

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local copy of MapMill

If you have low bandwidth or don't want to share your map data, you can run MapMill yourself, on your computer. Follow these steps and email jeff@publiclaboratory.org with questions or for troubleshooting.

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• Import your images
  • Copy a folder of JPG images into "/rubystack-2.2-2/projects/mapmill/public/sites/your-folder-here"
  • Go to "http://localhost:3000/admin" in your web browser
  • Click "Import sites"
  • Your site should appear in the list. Click "Import images"
  • After what may be a while (it has to actually scan each image and insert it into the database) the Admin page should reload showing how many images you've imported. Go to "http://localhost:3000/" or click on your site to see your images.
• Start sorting!

To keep in mind:

• This may run slowly on a small, weak computer like my netbook
• We'll try to get Passenger installed or something soon so it can be multi-threaded, in the meantime it may only be able to handle one pageload at a time.
• To connect other computers, find out your IP address (linux/mac: type "ifconfig" and it's the one that looks like 192.x.x.x or something) and any computer on the same local network should be able to use it by going to 192.0.0.1:3000 (or whatever your IP address was plus ":3000".

MapMill is the PLOTS tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source of the Gulf Coast and beyond. Help us with these projects by choosing the sharpest, clearest, best images.

If you are creating your own maps, MapMill is a great way to offer a more accessible and inclusive first step in the process of turning images into maps. Email the link to your MapMill site to your community, post it on your blog or on Facebook. It's a great lightweight way to keep people engaged after the flight is over, to reach out to a wider group of folks with new opportunities to participate, and to raise public awareness around the subject of your map.

To start using MapMill, contact staff@publiclaboratory.org

Roadmap

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local copy of MapMill

If you have low bandwidth or don't want to share your map data, you can run MapMill yourself, on your computer. Follow these steps and email jeff@publiclaboratory.org with questions or for troubleshooting.

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• Import your images
  • Copy a folder of JPG images into "/rubystack-2.2-2/projects/mapmill/public/sites/your-folder-here"
  • Go to "http://localhost:3000/admin" in your web browser
  • Click "Import sites"
  • Your site should appear in the list. Click "Import images"
  • After what may be a while (it has to actually scan each image and insert it into the database) the Admin page should reload showing how many images you've imported. Go to "http://localhost:3000/" or click on your site to see your images.
• Start sorting!

To keep in mind:

• This may run slowly on a small, weak computer like my netbook
• We'll try to get Passenger installed or something soon so it can be multi-threaded, in the meantime it may only be able to handle one pageload at a time.
• To connect other computers, find out your IP address (linux/mac: type "ifconfig" and it's the one that looks like 192.x.x.x or something) and any computer on the same local network should be able to use it by going to 192.0.0.1:3000 (or whatever your IP address was plus ":3000".

MapMill is the PLOTS tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

If you are creating your own maps, MapMill is a great way to offer a more accessible and inclusive first step in the process of turning images into maps. Email the link to your MapMill site to your community, post it on your blog or on Facebook. It's a great lightweight way to keep people engaged after the flight is over, to reach out to a wider group of folks with new opportunities to participate, and to raise public awareness around the subject of your map.

To start using MapMill, contact staff@publiclaboratory.org

Roadmap

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local copy of MapMill

If you have low bandwidth or don't want to share your map data, you can run MapMill yourself, on your computer. Follow these steps and email jeff@publiclaboratory.org with questions or for troubleshooting.

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• Import your images
  • Copy a folder of JPG images into "/rubystack-2.2-2/projects/mapmill/public/sites/your-folder-here"
  • Go to "http://localhost:3000/admin" in your web browser
  • Click "Import sites"
  • Your site should appear in the list. Click "Import images"
  • After what may be a while (it has to actually scan each image and insert it into the database) the Admin page should reload showing how many images you've imported. Go to "http://localhost:3000/" or click on your site to see your images.
• Start sorting!

To keep in mind:

• This may run slowly on a small, weak computer like my netbook
• We'll try to get Passenger installed or something soon so it can be multi-threaded, in the meantime it may only be able to handle one pageload at a time.
• To connect other computers, find out your IP address (linux/mac: type "ifconfig" and it's the one that looks like 192.x.x.x or something) and any computer on the same local network should be able to use it by going to 192.0.0.1:3000 (or whatever your IP address was plus ":3000".

MapMill is the PLOTS tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

If you are creating your own maps, MapMill is a great way to offer a more accessible and inclusive first step in the process of turning images into maps. Email the link to your MapMill site to your community, post it on your blog or on Facebook. It's a great lightweight way to get people more engaged after the flight is over.

To start using MapMill, contact staff@publiclaboratory.org to

Roadmap

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local copy of MapMill

If you have low bandwidth or don't want to share your map data, you can run MapMill yourself, on your computer. Follow these steps and email jeff@publiclaboratory.org with questions or for troubleshooting.

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• Import your images
  • Copy a folder of JPG images into "/rubystack-2.2-2/projects/mapmill/public/sites/your-folder-here"
  • Go to "http://localhost:3000/admin" in your web browser
  • Click "Import sites"
  • Your site should appear in the list. Click "Import images"
  • After what may be a while (it has to actually scan each image and insert it into the database) the Admin page should reload showing how many images you've imported. Go to "http://localhost:3000/" or click on your site to see your images.
• Start sorting!

To keep in mind:

• This may run slowly on a small, weak computer like my netbook
• We'll try to get Passenger installed or something soon so it can be multi-threaded, in the meantime it may only be able to handle one pageload at a time.
• To connect other computers, find out your IP address (linux/mac: type "ifconfig" and it's the one that looks like 192.x.x.x or something) and any computer on the same local network should be able to use it by going to 192.0.0.1:3000 (or whatever your IP address was plus ":3000".

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Roadmap

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local copy of MapMill

If you have low bandwidth or don't want to share your map data, you can run MapMill yourself, on your computer. Follow these steps and email jeff@publiclaboratory.org with questions or for troubleshooting.

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• Import your images
  • Copy a folder of JPG images into "/rubystack-2.2-2/projects/mapmill/public/sites/your-folder-here"
  • Go to "http://localhost:3000/admin" in your web browser
  • Click "Import sites"
  • Your site should appear in the list. Click "Import images"
  • After what may be a while (it has to actually scan each image and insert it into the database) the Admin page should reload showing how many images you've imported. Go to "http://localhost:3000/" or click on your site to see your images.
• Start sorting!

To keep in mind:

• This may run slowly on a small, weak computer like my netbook
• We'll try to get Passenger installed or something soon so it can be multi-threaded, in the meantime it may only be able to handle one pageload at a time.
• To connect other computers, find out your IP address (linux/mac: type "ifconfig" and it's the one that looks like 192.x.x.x or something) and any computer on the same local network should be able to use it by going to 192.0.0.1:3000 (or whatever your IP address was plus ":3000".

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local version of MapMill

• Download the Bitnami "native" RubyStack for your computer: http://bitnami.org/stack/rubystack
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• go to "http://localhost:3000" in your web browser

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image

Setting up your own local version of MapMill

• Download the Bitnami RubyStack: link
• Run the installer.
• Go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
• Download this version of MapMill and unzip it in the "projects" folder inside "rubystack-2.2-2".
• From the commandline:
  • go to the main Bitnami folder which was just installed, called "rubystack-2.2-2"
  • type ".rubyconsole"
  • you're now in the local Bitnami ruby shell
  • type "cd projects/mapmill" to get to the mapmill folder
  • type "rake db:migrate"
  • if it runs with no errors, type "script/server"
• go to "http://localhost:3000" in your web browser

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• display lowest vote count for a mapmill site, and average votecount
• offer to "stash" site
• paginate the full site display
• allow sorting within just one set, sort by rank or time(original order)
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image
• put all other information in the sidebar so its out of the way
• change link to buy posters, or donate to PLOTS
• ability to go to prev. or next image in a set with arrow keys

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image
• add a link to open the photo in Cartagen Knitter

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• display lowest vote count for a mapmill site, and average votecount
• offer to "stash" site
• paginate the full site display
• allow sorting within just one set, sort by rank or time(original order)
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image
• put all other information in the sidebar so its out of the way
• change link to buy posters, or donate to PLOTS

Long-term goals & features

• add a map of the site so you can make a guess where it fits, and possible use of a base map to assess the quality of a particular image
• add a link to open the photo in Cartagen Knitter

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• display lowest vote count for a mapmill site, and average votecount
• offer to "stash" site
• paginate the full site display
• allow sorting within just one set, sort by rank or time(original order)
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image
• put all other information in the sidebar so its out of the way
• change link to buy posters, or donate to PLOTS

Long-term goals & features

• add a map of the site so you can make a guess where it fits
• add a link to open the photo in Cartagen Knitter

MapMill is our tool for sorting imagery produced with balloon mapping.

It takes hours to go through the thousands of images we're capturing from balloons and kites, to pick out the best ones for inclusion in our free and open source maps. Help us by choosing the sharpest, clearest, best images.

Planning & proposed features

• make mapmill able to rename sites -- also in database
• make mapmill able to store links to all formats
• display lowest vote count for a mapmill site, and average votecount
• offer to "stash" site
• paginate the full site display
• allow sorting within just one set
• tag sites "gulf coast" etc, and .org/sort/gulf-coast/ should let you sort just that tag
• use AJAX to load a new image
• put all other information in the sidebar so its out of the way
• change link to buy posters, or donate to PLOTS

Long-term goals & features

• add a map of the site so you can make a guess where it fits
• add a link to open the photo in Cartagen Knitter