GeoPDF is a unique data format that brings the portability of PDF to geospatial data. A GeoPDF document can present raster and vector data and preserve the georeference information. This can be a useful format for non-GIS folks to consume GIS data without needing GIS-software. While GeoPDF is a proprietary format, we have a close alternative in the open Geospatial PDF format. GDAL has added support for creating Geospatial PDF documents from version 1.10 onwards. In this post, I will show how to create a GeoPDF document containing multiple vector layers.
Get the Tools
OsGeo4W is the best way to install GDAL on Windows. The default installation gives your GDAL tools with PDF format support. You can use the GDAL tools via the OsGeo4W Shell included in the install.
Once installed, add the path to GDAL library to your
.bash_profile file to be able to use the commands easily from the terminal. Launch a Terminal and type in the following commands.
echo 'export PATH=/Library/Frameworks/GDAL.framework/Programs:$PATH' >> ~/.bash_profile source ~/.bash_profile
Installation instructions will vary with the distribution. On Ubuntu, you can install the
sudo apt-get install gdal-bin
Verify GDAL Install
If you already have GDAL installed, or just installed it, run the following command in a terminal to verify that your GDAL installation is working and has support for GeoPDF format.
gdalinfo --formats | grep -i pdf
If you see Geospatial PDF printed in the output – you are all set. If you do not get any output or get an error, your install is not correctly configured.
Get the Data
For this example, I chose to use OpenStreetMap Metro Extracts from MapZen. Download the shapefiles (OSM2PGSQL SHP format) for the city of your choice. I am using the extract for Bangalore city in this example. Unzip the downloaded file to a folder on your computer.
The process for creating a GeoPDF file from a bunch of shapefiles is the matter of running a single
gdal_translatecommand. But we need to prepare the data and figure out the correct command-line options. So follow along to understand how you can arrive at the final command – or simply scroll to the end to see the final command-line.
latuviitta.org has a comprehensive overview of all the options available for GeoPDF creation via GDAL. The follow steps are adapted and simplified version of that guide.
- First step is to create a
.vrtfile that can hold all the vector layers we want in the PDF. If you just need a single layer in the PDF, you can skip creating the
.vrtfile and directly reference the layer in place of the VRT. Note the <SrcSQL> tag in the VRT file. This is for filtering out all features where the ‘name’ field is empty. You can leave that out or modify to suit your dataset. Name this file
osm.vrtand save it on the same folder with your data.
<OGRVRTDataSource> <OGRVRTLayer name="roads"> <SrcDataSource>bengaluru_india_osm_line.shp</SrcDataSource> <SrcLayer>bengaluru_india_osm_line</SrcLayer> <SrcSQL dialect="sqlite">SELECT name, highway, geometry from bengaluru_india_osm_line where name is not NULL</SrcSQL> <GeometryType>wkbLineString</GeometryType> <LayerSRS>WGS84</LayerSRS> </OGRVRTLayer> <OGRVRTLayer name="pois"> <SrcDataSource>bengaluru_india_osm_point.shp</SrcDataSource> <SrcLayer>bengaluru_india_osm_point</SrcLayer> <SrcSQL dialect="sqlite">SELECT name, geometry from bengaluru_india_osm_point where name is not NULL</SrcSQL> <GeometryType>wkbPoint</GeometryType> <LayerSRS>WGS84</LayerSRS> </OGRVRTLayer> </OGRVRTDataSource>
- GeoPDF is a raster format that can overlay vectors on top. So we need a raster layer as the base. If you have some satellite imagery or scanned raster for the area, you can use it as the base layer, or we can create an empty raster for the extent of the vector layer.
ogrtindexcommand creates a bounding box polygon from the given input layers.
gdal_rasterizecommand then fills this polygon with the given value and creates a raster. The
-troption specifies the pixel resolution of the raster in degrees. You can tweak that to get the output size you need.
cdto the directory where you have extracted the vector layers and run the following commands.
cd Users\Ujaval\Downloads\bengaluru_india.osm2pgsql-shapefiles ogrtindex -accept _different_schemas extent.shp osm.vrt gdal_rasterize -burn 255 -ot Byte -tr 0.0001 0.0001 extent.shp bangalore.tif
- Now we can convert the empty
bangalore.tifraster to a PDF – overlaying the vector layers from the
gdal_translate -of PDF -a_srs EPSG:4326 bangalore.tif bangalore.pdf -co OGR_DATASOURCE=osm.vrt -co OGR_DISPLAY_FIELD="name"
- Once the conversion finishes, you can open the resulting
bangalore.pdffile in any PDF viewer. Opening it in Adobe Acrobat viewer, you can see the map data layers. You can browse the features in the layer panel, search for any attribute value and zoom/pan the map.
- Another popular use of GeoPDF files is to use it as offline base maps using programs such as Avenza PDF Maps. Loading the
bangalore.pdffile on Avenza Maps on your mobile phone, you can use the GPS to view your current location or trace a GPS route on top. Search also works across layers in the PDF.
You can download the sample bangalore.pdf Geospatial PDF format file for exploring the format yourself.
Mapshaper is a free and open-source tool that is best known for fast and easy simplification. Other tools for simplification – like QGIS or ogr2ogr – do not preserve topology while simplifying. This means you may get sliver polygons or missing intersections. Mapshaper performs topologically-aware simplification and gives you much more control on the process.Continue reading
I was at #cartonama conference in Bangalore on 23rd September, 2012. It was wonderful to be among geogeeks and see the energy and enthusiasm. Got to see some great demos and LBS apps from startups in India. Here’s a run down from my notes and bookmarks.
- Traffic cams in Bangalore: This was probably the coolest demo for me. Love the simplicity and usefulness. Just open this URL in your smartphone browser and get real-time feed from the traffic-cam neareast to you from BTIS.http://hackday.freecrow.org/trafficam
- Thru the Gall: A Layar-based android app to solve the last-mile direcction problem in India. Bubbles guide you through the narrow-lanes (galli). http://www.layar.com/layers/galli/
- Padma: Search and Browse Indian documentaries through locations of the clips in the documentaries http://pad.ma/map
- DelightCircle: LBS app to discover offers and discounts near you. Surprised at the coverage and partnerships they are able to genrate in the short time. Powered by MongoDB at the backend.http://delightcircle.com/
- Commonfloor.com: Google Maps API app for property search. Nicely done and simple UI and fast lad times. The team talked about challenges and techniques they use to de-dup the listings and pin the individual listings to the apartment block. http://www.commonfloor.com/apartments-for-sale/maps/
- Yahoo: I had forgotten about yahoo as a geo player. But from the talk the team seems pretty excited about their geo APIs. The Geo APIs are used by many yahoo properties internally and available to developers too. The API to extract locations from free-form-text was cool. YQL is a SQL-like query interface for their API. http://developer.yahoo.com/yql/console/, APIS at http://developer.yahoo.com/geo/
- NextDrop: Very interesting idea. Most places in India do not have a regular water supply and people’s day revolves around when they are able to collecct water. They have built a system that alerts subscribers by sms when they can expect water based on the information from the utility company. Subscribers pay Rs.10/month to get this data. Their challenge revoled around locating their customers on a map – both for billing as well as determining which pipeline will supply them water. http://nextdrop.org
- Lokasi: Simple android app that allows you to share your current location by sms. Reverse-geocoding + location identifier. http://www.onze.in/ . collected POIs + street geometry for entire bangalore is about 6 months with a 10-person team.
- Brief history of map making: Fun talk with lot of pretty and interesting maps. No geo conference is complete without a passionate discussion on projections 🙂 http://www.slideshare.net/sumandro/sumandromapping-thecity27032012-12203410
- Chalo BEST: Bus route planner for Mumbai using OpenTripPlanner and GTFS feed from BEST. http://trip.chalobest.in/. Challenges in converting messy spreadsheet data from the agengy in to GTFS feed.
- Geohash: overview of the geohash system. Lots of discussion around what geohash is good for. http://geohash.org/
India’s first FOSS4G – India conference was organized on 25-26 October, 2012 at Hyderabad. This was a surprisingly low-profile event and there was very little buzz about it on the internet. I learnt about it just in time to register and make it to the event. Here I am sharing some notes and impressions. (notes are mostly from memory, so please excuse if I missed something)
- I haven’t been to other FOSS4G events, but this was unlike any other Geo conference I have attended. It was very formal and government-centric. All presentations were from government researchers, employees or students.
- The penetration of open-source software within government was deeper than I anticipated and the decision-makers – including the politicians recognize the benefits of using open technologies. The Chief Guest – Shri V. Aruna Kumar, MP from Rajahmundry district commented that he realizes that the real cost of software is not the upfront cost, but the lifetime maintenance cost and open-source and open-standards can really benefit in the longer run.
- Keynote’s main message was that we should really focus on delivering applications that solve real problems. According to the speaker – Shri Anoop Singh, Special Secretary to AP Government – we have not even begun to realize the full potential of GIS within governments. For most end-users and decision makers, the ‘Science’ or ‘System’ in GIS isn’t important and GIS should really be about Geographic Information Services.
- India is seen largely as a follower in the open source movement and no big open-source projects have come out of research institutions here. To address this, International Institute of Information Technology released one of their projects – LSIViewer as open-source. The github upload was done during the inauguration of the conference by the chief guest!
- Prof. Venkatesh Raghavan receiving 2012 Sol Katz award Prof. Venkatesh Raghavan, Osaka City University was chosen as the winner of the 2012 Sol Katz ward by OsGeo. The award was given to him during the conference.
- Postgrasql + PostGIS, Geoserver and Openlayers seem to be the platform of choice. Almost all applications I saw were built using one of these.
- ELOGeo portal was shown an example of learning resources available for open source geo tools.
- There is virtually no open data for India given the strict geo data policy. But even within the government departments – there is a lot of reluctance in data sharing. Everyone talked about this problem of data being guarded very closely and seldom shared. But some forward thinking departments, especially in Tamil Nadu, have found a way around it by promoting Web Services. They publish a WMS feed for the datasets. That way other departments can use the data without really having any ownership of it. This seems to be working well.
- Ms. Mahalakshmi from National Informatics Center (NIC) in Tamil Nadu demonstrated some of most interesting internal applications built by them. They have built web services for different departments and each department uses these web services for their application. Administrative boundaries, census data, land use maps, land parcels, police data and planning related data are some examples which are available via WMS. She also showed a pretty cool app that BSNL – Chennai uses to identify fault points in their 2G network. The map is updated in real-time with pings from their different 2G sites around Chennai.
- BHUVAN – Indian Space Research Organization’s (ISRO) portal for disseminating geodata has come a long way since it’s launch a few years back. It’s built completely using open-source stack and it’s a pretty snappy app. For the first time, a lot of thematic datasets are available freely to the public via WMS. They are also making some medium and low resolution raw/derived data from Indian remote sensing satellites available for download. The downloads are for personal use only, but this is a big step forward in India’s data access policy which has been very restrictive so far.
In summary, some positives and challenges for Open-source software described by various speakers.
- No upfront cost. Don’t have to navigate complicated and time-consuming approval and procurement process. Easy to get started at low-cost and do a proof-of-concept.
- Standards Compliant. Rising awareness within the government of being standards compliant. Choosing a proprietary solution which is not standards compliant can cause problems and raise questions from others in future.
- No vendor lock-in. Can hire another consultant to run or develop services since all code is available.
- Lack of support. Not many companies providing development and support. Most applications shown were written and maintained by in-house staff. Big opportunities for consultants who can provide support for open source tools.
- Change aversion: On the desktop, most people are used to proprietary software from their education or prior work. One example given was reluctance in the government to switch to Open Office. Free versions of MS Office is easy to come by and no incentive to learn and adopt open source solution. Using open-source software in education is a way to increase the adoption.
- Lack of Mature solutions: Politicians and administrators felt they had limited time in their tenure to implement whatever changes they want and show progress. There is always the attraction to choose a well known solution and get the results. The key message was that they feel the open-source software is mature but there are no mature solutions based on these that the governments can adopt without much risk.
Many students have asked me for ideas on what topic they should choose for their Thesis. I have debated this myself when I was a student. The ideal topic would be the one that allows you to dive into a topic deeply as well as give you some practical skills that will help you landing a job. Here are some pointer that may help you make that decision.
A mashup is created by merging 2 or more sources of location data. There are variety of free data available for you to experiment with and create unique applications. Map mashups can be created using free tools such as Google Maps, OpenLayers, GeoCommons Maker!
There is always a need to implement new features for open-source GIS software like QGIS or MapWindowGIS. You can implement a cool feature or customize the software for a particular domain. You will not only gain valuable experience developing among the best programmers but also this will be an impressive addition to your resume.
Most often students struggle to find good quality free GIS data which can be used in interesting ways. Contact local NGOs to see if you can help them analyze their location-specific data. Most NGOs collect some form of loation data and your GIS skills can come in handy to them. The result of such a project could be a unique GIS project that uses real on-the-ground data.
If you are at a university, a good project would be to put together a web-accessible campus information system. You could model the campus buildings in 3D, use satellite imagery via an API and overlay data about your campus. Such a system could be attractive to the administrator as well.
You can buy a cheap GPS receiver and implement a vehicle tracking system. This will get you exposed to GPS/GSM protocols and get you hands-on knowledge that many companies worldwide are looking for. Add your own twist to the traditional tracking system by specializing it for walking directions, bus travel, toursut sightseeing, navigating the blind etc.
Everyone is turning to green and sustainable technologies. As an intern or a researcher, you could use your analytical skills to further the knowledge in this area. Wind power, solar energy, climate change etc. are great topics for GIS and Remote Sensing research.Analysing wind data to find best locations for wind turbines or using remote sensing images to detect climate change are some examples of projects. If you are a PhD student, you’ll find these topics complex and challenging enough for yor dissertation and you’ll stand to recieve grants or funds from governments as well.
Do you have more ideas to share? What project are you thinking of? Please leave a comment and help the GIS student community!