Home

QGIS 0.9.1@let@token User Guide

1. D 3 Install development frameworks for QGIS dependencies 131 D 3 1 Additional Dependencies GSL o o o o e es 132 D 3 2 Additional Dependencies Expat o eee 132 D 3 3 Additional Dependencies SIP ra vc dre E ce Aa reas eRe 132 D 3 4 Additional Dependencies PyQt 20002 ees 133 D 3 5 Additional Dependencies Bison 0 134 D 4 Install CMAKE for OSX cit tek ee RS IRE AA oH K 134 D 5 Install subversion 10r OSX ea ee a Ye OS wR ke A RA e ex 134 D 6 Check out QGIS from SVN vos ss era E ER Ge 135 EZ Comigure te buildi ss 2443 0 ets rd BESS e A e 136 D8 GEOS ISSUSS be E Sens a Rh Sy e A ee ee 136 D 9 Building poes E ete a Da de Da de ee eter eae eee E 137 E Building on GNU Linux 137 Et Building QGIS with OIA SM 20 20 ss ERS a Bh eos a a A 137 E2 PEPA a A a e E E o de E de 137 E 3 Install i a ee ee e ee e ee alee E he eae 138 E 4 Install additional software dependencies required by QGIS 138 ED GRASS SDeCIIC St ps ssor ld tw eas 4 kw ba ew Beet eee EHX 139 E 6 Setup ccache Optional e ee ee is ee Se pee kt ey a 139 E 7 Prepare your development environment 139 E 8 Check out the QGIS Source Code
2. WKT 59 WMS PostGIS see PostGIS properties dialog renderers continuou s color 29 graduated symbol 29 single symbol 28 unique va symbology WFS 28 transparency 30 lue 29 remote server QGIS 0 9 1 User and Installation Guide Index capabilites 54 client 50 about 50 connection parameters 51 layers 52 limits 56 coordinate reference system 54 CRS 54 identify 54 image encoding 52 layer settings editing 56 layer transparency 54 metadata 54 properties 54 remote server authentication 56 layer ordering 53 selection 51 URL 52 URL 51 zoom mouse wheel 14 QGIS 0 9 1 User and Installation Guide 177
3. editing field names 27 importing data 26 loading 2 reserved words 27 PostgreSQL 7 connection testing connection manager 24 connection parameters database host 25 layer details 26 loading layers 24 25 password 25 port 25 PostGIS query builder 43 e 25 usernam Projections coordinate reference system 54 CRS 54 24 124 25 21 custom 61 enabling specifying 60 61 WMS 54 working with 59 projects 17 Query Builde adding fields 42 changing layer definitions generating sample list 42 getting all values 42 testing queries 42 query builder r 4 2 GRASS 43 OGR 43 PostGIS PostgreSQL raster layers context menu 45 43 43 44 QGIS 0 9 1 User and Installation Guide 175 Index rendering 15 data formats 44 definition 44 GDAL implementation 44 georeferenced 44 histogram 49 icolor map inversi
4. Start QGIS Make sure the GRASS plugin is loaded Load the alaska shp shapefile see Section 4 1 1 In the GRASS toolbar click on the New mapset tool to bring up the mapset wizard Each location is stored in a directory Select an existing data directory or create a new one for storing the location Click Next We can use this wizard to create a new mapset within an existing location or create a new location altogether Click Create new location radio button Enter a name for the location we ll use Alaska Click Next Define the projection by clicking on the Projection radio button to enable the projection list We are using Albers Equal Area Alaska meters projection Since we happen to know that its PostGIS SRID is 5000 we enter it in the search box If you want to repeat this process for another layer and haven t memorized the PostGIS SRID click on the projector icon in the lower right hand corner of the statusbar see Section 7 2 Click Find to select the projection Click Next QGIS 0 9 1 User and Installation Guide 65 8 4 Vector Data Model 14 To define the default region we have to enter the bounds in the north south east and west direction Here we simply click on the button Set current QGIS extent 15 Click Next 16 We need to define a mapset within our new location Name it whatever you like your username is a good choice 17 Check out
5. topology 66 vector data model 66 identify WMS 54 installation 7 layer visibility 12 layers initial visibility 16 layout toolbars 1 2 legend 12 license exception GPL 167 172 main window map overview 14 view 14 MapInfo MIF files 21 TAB files Index measure 16 measure areas 17 measure line length 17 menus 11 MIF files 21 OGC coordinate reference system 54 CRS 54 introduction 50 WMS client 50 OGR 21 query builder 43 supported formats 122 plugin Georeferencer 85 plugins 83 copyright 85 core 84 delimited text external 85 geoprocessing 85 gps 85 graticule 85 installing 83 manager 83 managing 83 north arrow 85 scalebar 85 SPIT 85 template 86 types 83 plugins settings 85 PostGIS 21 59 Exporting 26 layers 24 query builder 43 spatial index 27 GIST 27 SPIT 27
6. GPS device Garmin serial ly Port IdevitysO y Edit devices Feature type Waypoints j Output file Layer name in the device menus in the upload and download windows and can be any string The download command is the command that is used to download data from the device to a GPX file This will probably be a GPSBabel command but you can use any other command line program that can create a GPX file QGIS will replace the keywords type in and out when it runs the command type will be replaced by w if you are downloading waypoints r if you are downloading routes and t if you are downloading tracks These are command line options that tell GPSBabel which feature type to download in will be replaced by the port name that you choose in the download window and out will be replaced by the name you choose for the GPX file that the downloaded data should be stored in So if you create a device type with the download command gpsbabel type i garmin o gpx in out this is actually the download command for the predefined device type Garmin serial and then use it to download waypoints from port dev ttyS0 to the file output gpx QGIS will replace the keywords and run the command gpsbabel w i garmin o gpx dev ttySO output gpx The upload command is the command that is used to upload data to the device The same keywords are used
7. and copy sqlite3 dll from it to c msys local lib Then download this archive http www sqlite org sqlite source 3_3_17 zip and copy sqlite3 h to c msys local include QGIS 0 9 1 User and Installation Guide 147 F 2 Installing dependencies F 2 7 GSL Download sources ftp ftp gnu org gnu gsl gsl 1 9 tar gz Unpack to c msys local sre Run from MSYS console in the source directory configure make make install F 2 8 EXPAT Download sources http dfn dl sourceforge net sourceforge expat expat 2 0 0 tar gz Unpack to c msys local sre Run from MSYS console in the source directory configure make make install F 2 9 POSTGRES We re going to use precompiled binaries Use the link below for download http wwwmaster postgresql org download mirrors ftp file 2Fbinary 2Fv8 2 4 12Fwin32 2Fpostgresql1 8 2 4 1 binaries no installer zip copy contents of pgsql directory from the archive to c msys local QGIS 0 9 1 User and Installation Guide 148 F 3 Cleanup F 3 Cleanup We re done with preparation of MSYS environment Now you can delete all stuff in c msys local src it takes quite a lot of space and it s not necessary at all G Building with MS Visual Studio This section describes a process where you build all dependencies yourself See the section after this for a simpler procedure where we have all the dependencies y
8. H 9 Initial SVN Check out Open a cmd exe window and do QGIS 0 9 1 User and Installation Guide 164 H 10 Create Makefiles using cmakesetup exe cd cd dev cd cpp svn co https svn qgis org repos qgis trunk qgis At this point you will probably get a message like this C dev cpp gt svn co https svn qgis org repos qgis trunk qgis Error validating server certificate for https svn qgis org 443 The certificate is not issued by a trusted authority Use the fingerprint to validate the certificate manually Certificate information Hostname svn qgis org Valid from Sat 01 Apr 2006 03 30 47 GMT until Fri 21 Mar 2008 03 30 47 GMT Issuer Developer Team Quantum GIS Anchorage Alaska US Fingerprint 2f cd f1 5a c7 64 da 2b d1 34 a5 20 c6 15 67 28 33 ea 7a 9b R eject accept t emporarily or accept p ermanently Press p to accept and the svn checkout will commence H 10 Create Makefiles using cmakesetup exe wont be giving a detailed description of the build process because the process is explained in the first section where you manually build all dependencies of the windows build notes in this document Just skip past the parts where you need to build GDAL etc since this simplified install process does all the dependency provisioning for you cd qgis mkdir build cd build cmakesetup Cmakesetup should find all dependencies for you automatically it uses the LIB_DIR environment
9. qgis trac This list provides email notification related to project management including bug reports tasks and feature requests You can subscribe to this list at http lists qgis org cgi bin mailman listinfo qgis trac qgis doc This list deals with topics like documentation context help user guide and translation efforts If you like to work on the user guide as well this list is a good starting point to ask your questions You can subscribe to this list at http lists qgis org cgi bin mailman listinfo qgis doc qgis psc This list is used to discuss Steering Committee issues related to overall management and direction of Quantum GIS You can subscribe to this list at http mrcc com cgi bin mailman listinfo qgis psc QGIS 0 9 1 User and Installation Guide 119 13 2 IRC You are welcome to subscribe to any of the lists Please remember to contribute to the list by answer ing questions and sharing your experiences Note that the qgis commit and qgis trac are designed for notification only and not meant for user postings 13 2 IRC We also maintain a presence on IRC visit us by joining the qgis channel on irc freenode net Please wait around for a response to your question as many folks on the channel are doing other things and it may take a while for them to notice your question Commercial support for QGIS is also available Check the website http qgis org content view
10. D 3 1 Additional Dependencies GSL Retrieve the Gnu Scientific Library from curl 0 ftp ftp gnu org gnu gsl gsl 1 8 tar gz Then extract it and build it to a prefix of usr local tar xvfz gsl 1 8 tar gz cd gsl 1 8 configure prefix usr local make sudo make install cd D 3 2 Additional Dependencies Expat Get the expat sources http sourceforge net project showfiles php group_id 10127 tar xvfz expat 2 0 0 tar gz cd expat 2 0 0 configure prefix usr local make sudo make install cd D 3 3 Additional Dependencies SIP Retrieve the python bindings toolkit SIP from QGIS 0 9 1 User and Installation Guide 132 D 3 Install development frameworks for QGIS dependencies http www riverbankcomputing com Downloads sip4 Then extract and build it to a prefix of usr local tar xvfz sip lt version number gt tar gz cd sip lt version number gt python configure py make sudo make install cd D 3 4 Additional Dependencies PyQt Make sure you have the latest python fom http www python org download mac If you encounter problems compiling PyQt using the instructions below you can also try adding python from your frameworks dir explicitly to your path e g export PATH Library Frameworks Python framework Versions Current bin PATH Retrieve the python bindings toolkit for Qt from http www riverbankcomputing com Downloads PyQt4 GPL Then extract and build it
11. In this version of QGIS verticies can only be added to an existing line segment of a line feature If you want to extend a line beyond its end you will need to move the terminating vertex first then add a new vertex where the terminus used to be Moving Vertices of a Feature You can move verticies using the Move Vertex icon on the toolbar Deleting Vertices of a Feature You can delete verticies by using the Delete Vertex icon on the toolbar Note it doesn t make sense to delete the vertex of a Point feature Delete the whole feature instead Similarly a one vertex line or a two vertex polygon is also fairly useless and will lead to unpredictable results elsewhere in QGIS so don t do that QGIS 0 9 1 User and Installation Guide 38 4 4 Editing Warning A vertex is identified for deletion as soon as you click the mouse near an eligible feature To undo you will need to toggle Editing off and then discard your changes Of course this will mean that other unsaved changes will be lost too Add Ring New in v0 9 You can create ring polygons in QGIS This means inside an existing area it is possible to digitize further polygons that will occur as a whole so only the area in between the boundaries of the outer and inner polygons remain as a ring polygon Add Island New in v0 9 You can add island polygons to a selected multipolygon The new island polygone has to be digitized outside the selected multipolygon
12. Microsoft Windows Management Instrumentation No Microsoft DirectShow SDK No Microsoft Media Services SDK No Debuggin Tools for Windows Yes Note that you can always come back later to add extra bits if you like Note that installing the SDK requires validation with the Microsoft Genuine Advantage application Some people have a philosophical objection to installing this software on their computers If you are one of them you should probably consider using the MINGW build instructions described elsewhere in this document The SDK installs a directory called C 0ffice10 Which you can safely remove After the SDK is installed follow the remaining notes on the page link above to get your MSVC Express environment configured correctly For your convenience these are summarised again below and have added a couple more paths that discovered were needed 1 open Visual Studio Express IDE 2 Tools gt Options gt Projects and Solutions gt VC Directories 3 Add Executable files C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Bin Include files QGIS 0 9 1 User and Installation Guide 158 H 5 Edit your vsvars C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Include C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Include atl C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Include mfc Library files C Program Files Microsoft P
13. Quantum GIS User and Installation Guide Version 0 9 1 Ganymede Preamble This document is the original user and installation guide of the described software Quantum GIS The software and hardware descriptions named in this document are in most cases registered trademarks and are therefore subject to the legal requirements Quantum GIS is subject to the GNU General Public License Find more information on the Quantum GIS Homepage http www qgis org The details data results etc that are given in this document have been written and verified to the best of knowledge and responsibility of the editors Nevertheless mistakes concerning the content are possible Therefore all data are not liable to any duties or guarantees The editors and publishers do not take any responsibility or liability for failures and their consequences Your are always welcome for indicating possible mistakes This document has been set with IATEX It is available as IATEX source code and online as HTML and PDF document via http www qgis org Translated versions of this document can be downloaded via the documentation area of the QGIS project as well More information about this document and about translating it is available via http wiki qgis org qgiswiki DocumentationWritersCorner Editors User and Installation Guide Gary E Sherman Tim Sutton Radim Blazek Stephan Holl Otto Dassau Tyler Mitchell Brendan Morel
14. Setting Layer Add Option You can set an option to always load new layers without drawing them This means the layer will be added to the map but its visibility checkbox in the legend will be unchecked by default To set this option choose Options from the Settings menu and click on the Rendering tab Check the New layers added to the map are not displayed checkbox Any layer added to the map will be off invisible by default Updating the Map Display During Rendering You can set an option to update the map display as features are drawn By default QGIS does not display any features for a layer until the entire layer has been rendered To update the display as features are read from the datastore choose Options from the Settings menu and click on the Rendering tab Set the feature count to an appropriate value to update the display during rendering Setting a value of 0 disables update during drawing this is the default Setting a value too low will result in poor performance as the map canvas is continually updated during the reading of the features A suggested value to start with is 500 3 6 Measuring Measuring works within projected coordinate systems only e g UTM If the loaded map is defined with a geographic coordinate system latitude longitude the results from line or area measurements will be incorrect To fix this you need to set an appropriate map coordinate system QGIS 0 9 1 User and Installation Guide 16 3 7 P
15. Quantum GIS Anchorage Alaska US Fingerprint 2f cd f1 5a c7 64 da 2b d1 34 a5 20 c6 15 67 28 33 ea 7a 9b Reject accept t emporarily or accept p ermanently E 9 Starting the compile compile my development version of QGIS into my apps directory to avoid conflicts with Ubuntu packages that may be under usr This way for example you can use the binary packages of QGIS on your system along side with your development version suggest you do something similar mkdir p HOME apps Now we create a build directory and run ccmake QGIS 0 9 1 User and Installation Guide 140 E 10 Running QGIS cd qgis mkdir build cd build ccmake When you run ccmake note the is required a menu will appear where you can configure various aspects of the build If you do not have root access or do not want to overwrite existing QGIS installs by your packagemanager for example set the CMAKE_BUILD_PREFIX to somewhere you have write access to I usually use home timlinux apps Now press c to configure e to dismiss any error messages that may appear and g to generate the make files Note that sometimes c needs to be pressed several times before the g option becomes available After the g generation is complete press q to exit the ccmake interactive dialog Now on with the build make make install It may take a little while to build depending on your platform E 10 Running QG
16. Quantum GIS Map of Germany ENTES Width 172 Height Line width scale Legend Polgrerzer GB aros cs IS Ho ster J BADEN WURTTIUEERG BAYERN Font size scak E serv EA aos EDERSACHSEN GB pario ranura E preso M Frame GM FHRC ESWEHOLSTEN E uera Preview E essen l To exportthe composer canvas as an SVG Scalable Vector Graphic click on the Export as SVG button Note Currently the SVG output is very basic This is not a QGIS problem but a problem of the underlaying Qt library This will be sorted out in future versions QGIS 0 9 1 User and Installation Guide 82 11 Using Plugins 11 1 An Introduction to Using Plugins QGIS has been designed with a plugin architecture This allows new features functions to be added to the application Many of the features in QGIS are actually implemented as plugins There are two types of plugins in QGIS core and user contributed A core plugin is maintained by the QGIS development team and is part of every QGIS distribution A user contributed plugin is an exter nal plugin that is maintained by the individual author The QGIS SVN website http svn qgis org serves some user contributed plugins 11 1 1 Finding and Installing a Plugin When you install QGIS all of the core plugins are included see chapter 11 1 4 Typically user contributed plugins are distributed in source form and require compiling For instruc tions on building and installing a user contribut
17. We could then use the paste tool to put it back giving us a one level undo capability Cut copy and paste work on the currently selected features meaning we can operate on more than one at a time Tip 17 FEATURE DELETION SUPPORT When editing ESRI shapefiles the deletion of features only works if QGIS is linked to a GDAL version 1 3 2 or greater The OS X and Windows versions of QGIS available from the download site are built using GDAL 1 3 2 or higher Snap Mode QGIS allows digitized verticies to be snapped to other verticies of the same layer To set the snapping tolerance go to Settings gt Project Properties gt General gt Snapping Tolerance Note that the snapping tolerance is in map units QGIS 0 9 1 User and Installation Guide 40 4 4 Editing Saving Edited Layers When a layer is in editing mode any changes remain in the memory of QGIS Therefore they are not committed saved immediately to the data source or disk When you turn editing mode off or quit QGIS for that matter you are then asked if you want to save your changes or discard them If the changes cannot be saved e g disk full or the attributes have values that are out of range the QGIS in memory state is preserved This allows you to adjust your edits and try again 4 4 3 Creating a New Layer To create a new layer for editing choose New Vector Layer from the Layer menu The New Vector Layer dialog will be displayed as shown in Figure 8 C
18. 2 1 Creating a stored Connection el The first time you use a PostGIS data source you must create a connection to the PostgreSQL database that contains the data Begin by clicking on the Add a PostGIS Layer toolbar button The Add PostGIS Table s dialog will be displayed To access the connection manager click on the New button to display the Create a New PostGIS Connection dialog The parameters required for a connection are shown in Table 1 Once the parameters have been filled in you can test the connection by clicking on the Test Con nection button To save the password with the connection information check the Save Password option QGIS 0 9 1 User and Installation Guide 24 4 2 PostGIS Layers Table 1 PostGIS Connection Parameters Name A name for this connection Can be the same as Database Host Name of the database host This must be a resolvable host name the same as would be used to open a telnet connection or ping the host Database Name of the database Port Port number the PostgreSQL database server listens on The default port is 5432 Username User name used to login to the database Password password used with Username to connect to the database Tip 5 QGIS USER SETTINGS AND SECURITY Your customized settings for QGIS are stored based on the operating system On Linux Unix the settings are stored in your home directory in qt qgisrc On Windows the settings are stored in the
19. 9000000000 150 1200000000 Acacia mearnsii 35 2200000000 149 9300000000 Acacia mearnsii 32 2700000000 150 4100000000 As an exercise we create an action that does a Google search on the akes layer First we need to determine the URL needed to perform a search on a keyword This is easily done by just going to Google and doing a simple search then grabbing the URL from the address bar in your browser From this little effort we see that the format is http google com search q qgis where qgis is the search term Armed with this information we can proceed e Make sure the akes layer is loaded e Open the properties dialog by double clicking on the layer in the legend or right click and choose Properties from the popup menu e Click on the Actions tab e Enter a name for the action for example Google Search e For the action we need to provide the name of the external program to run In this case we can use Firefox If the program is not in your path you need to provide the full path e Following the name of the external application add the URL used for doing a Google search up to but not included the search term http google com search q e The text in the Action field should now look like this firefox http google com search q QGIS 0 9 1 User and Installation Guide 33 4 3 The Vector Properties Dialog e Click on the drop down box containing the field names for the akes layer
20. Add Scalebar button Use the Item tab to customize the segment size number of segments scalebar units size and font for the scalebar F You can add text labels to the composer by clicking on the Add New Label button Use the Item tab while the text is selected to customize the settings or change the default text Figure 22 shows the map composer after adding each type of map element 10 1 3 Other Features The map composer has navigation tools to zoom in and out To zoom in click the zoom in tool The map composer canvas will be scaled by a factor to 2 Use the scrollbars to adjust the view to the area of interest Zooming out works in a similar fashion If you find the view in an inconsistent state you can use the refresh button to redraw the map com poser canvas 10 1 4 Creating Output The map composer allows you to print the map to a printer export to a PNG or export to SVG Each of these functions is available from the composer toolbar a To save the composer canvas as a templates click on the Save Template As button Browse to the directory you like and save a template to use it again for another map canvas Bl Itis possible to export the result as an image by clicking on the Export as image button QGIS 0 9 1 User and Installation Guide 81 10 1 Using Map Composer Figure 22 Map Composer with map view legend scalebar and text added gt MainWindow lt galileo gt adas gt XAQOBO uu 2B DG
21. Guide 95 11 4 Using the Delimited Text Plugin In this case the delimiter is not correct for the file The file is actually tab delimited Note that the X and Y field drop down boxes do not contain valid field names Figure 32 Fields Parsed from Text File Greate a Layer from a Delimited Text File Delimited textile nan gnis_no_east_hemi_tabbed tet Delimited Text Layer Description Select the file containing delimited text with lat lon coordinates that you would like to use as a point layer and this plugin will do the job for you Use the layer name box to specify the legend name for E the new layer Use the delimeter box to specify what the delimeter is for your file e g space commar or tab Note this box accepts regex entries so use t for tab and la ina Layer name Delimiter ft X field name Y field name he Add Layer Close To properly parse the file change the delimiter to tab using t this is a regular expression for the tab character After changing the delimiter click Parse The drop down boxes now contain the fields properly parsed as shown in Figure 32 Figure 33 Selecting the X and Y Fields Greate a Layer from a Delimited Text File Delimited Text Layer Description Select the file containing delimited text with latlon coordinates that you would like to use as a point layer and t
22. It s located just to the right of the nsert Field button e From the drop down box select NAMES and click Insert Field e Your action text now looks like this firefox http google com search q NAMES This completes the action and it is ready to use The final text of the action should look like this firefox http google com search q NAMES We can now use the action Close the properties dialog and zoom in to an area of interest Make sure the lakes layer is active and identify a city In the result box you ll now see that our action is visible Figure 6 Select feature and choose action i MENG Results AKES ty Feature Value E AREA 297897440 E Derived Area 297 897 452 291 sq deg AREA 297897440 NAMES Tustumena Lake PERIMETER 110506 914 action Google Search When we click on the action it brings up Firefox and navigates to the URL http www google com search q Tustumena It is also possible to add further attribute fields to the action Therefore you can add a to the end of the action text select another field and click on Insert Field In this example there is just no other field available that would make sense to search for You can define multiple actions for a layer and each will show up in the Identify Results dialog You can also invoke actions from the attribute table by selecting a row and right clicking then choosing the action from the popup menu You can think of all kinds of
23. Overview of Projection Support QGIS has support for approximately 2 700 known projections Projections are stored in a Sqlite database that is installed with QGIS Normally you do not need to manipulate the database directly In fact doing so may cause projection support to fail Custom projections are stored in a user database See Section 7 3 for information on managing your custom projections The projections available in QGIS are based on those defined by EPSG and are largely abstracted from the spatial_references table in PostGIS version 1 x Note that the identifiers used in QGIS do not correspond to the EPSG or PostGIS spatial reference identifiers The EPSG and PostGIS identifiers are present in the database and can be used to specify a projection in QGIS In order to use OTF projection your data must contain information about its coordinate system For PostGIS layers QGIS uses the spatial reference identifier that was specified when the layer was created For data supported by OGR QGIS relies on the presence of a format specific means of specifying the coordinate system In the case of shapefiles this means a file containing the Well Known Text WKT specification of the the coordinate system The projection file has the same base name as the shapefile and a prj extension For example a shapefile named lakes shp would have a corresponding projection file named lakes prj 7 2 Getting Started At startup QGIS does not have
24. Qt also provide a dmg with these ftp ftp trolltech com qt source qt mac opensource 4 3 2 debug libs dmg l am going to proceed using only release libs at this stage as the download for the debug dmg is substantially bigger If you plan to do any debugging though you probably want to get the debug libs dmg Once downloaded open the dmg and run the installer Note you need admin access to install After installing you need to make two small changes First edit Library Frameworks QtCore framework Headers qconfig h and change Note this doesnt seem to be needed since version 4 2 3 QT_EDITION_UNKNOWN to QT_EDITION_OPENSOURCE Second change the default mkspec symlink so that it points to macx g cd usr local Qt4 3 mkspecs sudo rm default sudo ln sf macx g default D 3 Install development frameworks for QGIS dependencies Download William Kyngesburye s excellent all in one framework that includes proj gdal sqlite3 etc http www kyngchaos com files software unixport AllFrameworks dmg Once downloaded open and install the frameworks William provides an additional installer package for Postgresql PostGIS lts available here QGIS 0 9 1 User and Installation Guide 131 D 3 Install development frameworks for QGIS dependencies http www kyngchaos com software unixport postgres There are some additional dependencies that at the time of writing are not provided as frameworks so we will need to build these from source
25. Se he Be ee he A 12 3 4 3 Map Legend c22804 be te baw beds Re ER eee SAP CASS BOs 12 344 Map VIEW s sas oe iieis Ge oe Oh bee Hee A Ae Oe eee A 14 34 5 Map OVSIVISW 2s 46k oe eee A ke RE PR ee SAE Oe eG ee Re 14 346 Stat s B le a ee a ap Sta eh oh ne A Be ta e ee a aa eS 15 3 5 Rendering 60 ee a RA A ee 15 3 5 1 Scale Dependent Rendering LORA 15 3 5 2 Controlling Map Rendering ee a a A a EE NE RA E e 16 AE EM AAA 16 8 6 1 Measure length 243 6 6644 rr A A A 17 3 6 2 Measure areas lt sos min cao a ed a Ee dh a RS 17 A e O A Oo ne te ky ee SH eae Be ee ee 17 38 GULOPHONS a axes ee ee eke he oe ee OS ee so ee aS 18 3 9 Spatial Bookmarks e aoe ka eta a eo a A ee we ee ee 20 3 9 1 Creating a Bookmark 2 5 lt suis 426824 Gi6 wh eee be EE ES 20 3 9 2 Working with Bookmarks 024054 2 soe eee 2d do Gace eee ea ws 20 QGIS 0 9 1 User and Installation Guide iii Contents 3 9 3 Zooming to a Bookmark 444 lt 4 64 aa S4e ee eacee 4 O44 0 8S 20 3 9 4 Deleting a Bookmark 50 0 6 6 5 64 seb A Gok De ew A 20 4 Working with Vector Data 21 Al ESA MOOS c sr she rs is o Se hd sa
26. The cartographic parameters used with proj and described in the user manual are the same as those used by QGIS The Custom Projections dialog requires only two parameters to define a user projection 1 adescriptive name and 2 the cartographic parameters To create a new projection click the New button and enter a descriptive name and the projection parameters Figure 15 shows the dialog with an example projection The parameters shown were entered based on a knowledge of the projection and the information found in OF 90 284 You can test your projection parameters to see if they give sane results by clicking on the Test tab and pasting your projection parameters into the Parameters field Then enter known WGS 84 latitude and longitude values in North and East fields respectively Click on Calculate and compare the results with the known values in your projected coordinate system QGIS 0 9 1 User and Installation Guide 62 8 GRASS Integration The GRASS 3 plugin provides access to GRASS from within QGIS This includes the ability to view edit and create data as well as perform analysis using the GRASS geoprocessing modules In this chapter we ll introduce the plugin and some of the ways you can use it to work with GRASS data The following features are provided with the GRASS plugin o 3 Add GRASS vector layers o E Add GRASS raster layers e aR GRASS Toolbox o Bi Changing the GRASS region VY Ve
27. along with a description of their purpose and the toolbar icon Note the GRASS plugin is not included below because it installs its own toolbar see section 8 for a discussion of available features in the GRASS plugin QGIS 0 9 1 User and Installation Guide 84 11 1 An Introduction to Using Plugins Table 5 QGIS Core Plugins Icon Plugin Description d Copyright Label Display a copyright label on the map canvas Delimited Text Load a delimited text file containing x y coordinates as a point layer GPS Tools Load and display GPS data Graticule Creator Create a latitude longitude grid and save as a shapefile Scalebar Add a scalebar to the map canvas North Arrow Add a north arrow to the map canvas PostgreSQL Geoprocessing Buffer a PostGIS layer E 3 oemp y SPIT Shapefile to PostGIS Import Tool import shapefiles into Post greSQL Georeferencer Georeferencing rasterlayers WFS Load and display WFS layer The georeferencer plugin is only available if you have installed the gsl libraries and headers during compile time Please check the installation chapter for details Tip 35 PLUGINS SETTINGS SAVED TO PROJECT When you save a qgs project any changes you have made to NorthArrow ScaleBar and Copyright plugins will be saved in the project and restored next time you load the project 11 1 5 External Plugins QGIS also comes with some externally d
28. be modified by hitting the Change button 5 4 3 Metadata Tab The Metadata tab displays a wealth of information about the raster layer including statistics about each band in the current raster layer Statistics are gathered on a need to know basis so it may well be that a given layers statistics have not yet been collected Tip 20 GATHERING RASTER STATISTICS To gather statistics for a layer select pseudocolor rendering and click the Apply button Gathering statistics for a layer can be time consuming Please be patient while QGIS examines your data 5 4 4 Pyramids Tab Large resolution raster layers can slow navigation in QGIS By creating lower resolution copies of the data pyramids performance can be considerably improved as QGIS selects the most suitable resolution to use depending on the level of zoom You must have write access in the directory where the original data is stored to build pyramids Several resampling methods can be used to calculate the pyramides e Average e Nearest Neighbour e Average Magphase QGIS 0 9 1 User and Installation Guide 48 5 4 Raster Properties Dialog Please note that building pyramids may alter the original data file and once created they cannot be removed If you wish to preserve a non pyramided version of your raster make a backup copy prior to building pyramids 5 4 5 Histogram Tab The histogram tab allows you to view the distribution of the bands or color
29. before the official release of QGIS 0 9 Tip 37 DOCUMENTATION FOR PYQGIS Whether you are writing a plugin or a PyQGIS application you are going to need to refer to both the QGIS API documentation http qgis org and the PyQt Python Bindings Reference Guide http www riverbankcomputing com Docs PyQt4 pyqt4ref html These documents provide information about the classes and methods you ll use to bring your Python creation to life QGIS 0 9 1 User and Installation Guide 118 13 Help and Support 13 1 Mailinglists QGIS is still under active development and as such it won t always work like you expect it to The preferred way to get help is by joining the qgis users mailing list qgis users Your questions will reach a broader audience and answers will benefit others You can subscribe to the qgis users mailing list by visiting the following URL http lists qgis org cgi bin mailman listinfo qgis user qgis developer If you are a developer facing problems of a more technical nature you may want to join the qgis developer mailing list here http lists qgis org cgi bin mailman listinfo qgis developer qgis commit Each time a commit is made to the QGIS code repository an email is posted to this list If you want to be up to date with every change to the current code base you can subscribe to this list at http lists qgis org cgi bin mailman listinfo qgis commit
30. but inis now replaced by the name of the GPX file for the layer that is being uploaded and out is replaced by the port name You can learn more about GPSBabel and it s available command line options at http www gpsbabel org Once you have created a new device type it will appear in the device lists for the download and upload tools QGIS 0 9 1 User and Installation Guide 93 11 4 Using the Delimited Text Plugin 11 4 Using the Delimited Text Plugin The Delimited Text plugin allows you to load a delimited text file as a layer in QGIS 11 4 1 Requirements To view a delimited text file as layer the text file must contain 1 A delimited header row of field names This must be the first line in the text file 2 The header row must contain an X and Y field These fields can have any name 3 The x and y coordinates must be specified as a number The coordinate system is not important An example of a valid text file might look like this name latdec longdec cel1 196 mile creek 61 89806 150 0775 tyonek d 1 ne 197 1 2 mile creek 61 89472 150 09972 tyonek d 1 nel a b mountain 59 52889 135 28333 skagway c 1 sw apw dam number 2 60 53 145 75167 cordova c 5 swl apw reservoir 60 53167 145 75333 cordova c 5 swl apw reservoir 60 53 145 75167 cordova c 5 swl aaron creek 56 37861 131 96556 bradfield canal b 6 aaron island 58 43778 134 81944 juneau b 3 nel aats bay 55 905 134 24639 craig d 7 Some it
31. click on a layer in the legend or right click on the layer and select Properties from the popup menu 4 3 1 Symbology Tab QGIS supports a number of symbology renderers to control how vector features are displayed Cur rently the following renderers are available Single symbol a single style is applied to every object in the layer QGIS 0 9 1 User and Installation Guide 28 4 3 The Vector Properties Dialog Graduated symbol objects within the layer are displayed with different symbols classified by the values of a particular field Continuous colour objects within the layer are displayed with a spread of colours classified by the numerical values within a specified field Unique value objects are classified by the unique values within a specified field with each value having a different symbol To change the symbology for a layer simply double click on its legend entry and the vector layer properties dialog will be shown Figure 5 Vector Layer Properties Dialog Layer Properties Symbology General Metadata Labels Actions Legend type Single Symbol Outline Style e New in v0 9 is a function to use image files stored on your computer as fill pattern for vector layers QGIS 0 9 1 User and Installation Guide 29 4 3 The Vector Properties Dialog Vector transparency QGIS 0 9 1 allows to set a transparency for ever
32. click the Create button on the Spatial Index panel 4 1 3 Loading a MapInfo Layer To load a MapInfo layer click on the Add a vector layer toolbar bar button and change the file type filter to MapInfo mif tab MIF TAB and select the layer you want to load QGIS 0 9 1 User and Installation Guide 23 4 2 PostGIS Layers 4 1 4 Loading an ArcInfo Coverage Loading an an Arcinfo coverage is done using the same method as with a shapefiles and MapInfo layers Click on the Add a vector layer toolbar button to open the layer dialog and change the file type filter to All files Navigate to the coverage directory and select one of the following files if present in your coverage e lab to load a label layer polygon labels or standing points e cnt to load a polygon centroid layer e arc to load an arc line layer e pal to load a polygon layer 4 2 PostGIS Layers PostGIS layers are stored in a PostgreSQL database The advantage of PostGIS is the spatial index ing filtering and query capability Using PostGIS vector functions such as select and identify work more accurately than with OGR layers in QGIS To use PostGIS layers you must e Create a stored connection in QGIS to the PostgreSQL database if one is not already defined e Connect to the database e Select the layer to add to the map e Optionally provide a SQL where clause to define which features to load from the layer e Load the layer 4
33. ed AA we ee SH 21 4 1 1 Loading a Shapetile n ooa oaoa 21 41 2 Improving Performance s s ss 2 5 444 nb A A 22 4 1 3 Loading a Maplnfo Layen escurre a 23 4 1 4 Loading an Arclnfo Coverage gs rs ea Dw eS ey eee ee 24 4 2 PostGIS ee bodne A ia A ee ee ee 24 4 2 1 Creating a stored Connection e e 24 4 2 2 Loading a PostGIS Layen eke Bk LRP aa eS 25 4 2 3 Some details about PostgreSQL layers Bret ear ee a ates ein aa e 26 4 2 4 Importing Data into PostgreSQL 0 o 26 4 2 5 Improving Performance 222 246 4408 64 a 27 4 3 The Vector Properties Dialog O a Set ta es a Sh a us Oot et 28 43 l Symbol gy TaD oe dead i HG oe Rae Gs OB eR eles OG oY eee 28 4 3 2 General Tab dera a ee oe ok Ew E a eS we eat 30 4 3 3 Metadata T b 2 44 jen Gs Gale eek eed dot ow ae ee te ee 30 4 3 4 Labels Tab s ce 2 BAS Gem cep Bs Sn ode amp Sh Be BS hh amp age he Se Sy a 30 4 3 5 Actions TaD yoo so ke RA E eee Be eae Se eae oe 32 4 4 Editing ged 2 ch e a Ng Oe a Es a is Ged Hee ees ee 35 4 4 1 Setting the Snap Tolerance 2 2 2 ee ee 35 4 4 2 Editing an Existing Layen oscura 04 6 OS A ow Oe x 35 4 4 3 CreatingaNewLayen eee ee ee ee 41 4 5 Query PO sd pls es sto es oe BID pe ee Boe eS A VBE OE rea ec 42 4 5 1 Query PostGIS layers ee 43 4 5 2 Query OGR formats and GRASS files 43 5 Working with R
34. either the Program or any derivative work under copyright law that is to say a work containing the Program or a portion of it either verbatim or with modifications and or translated into another language Hereinafter translation is included without limitation in the term modification Each licensee is addressed as you Activities other than copying distribution and modification are not covered by this License they are outside its scope The act of running the Program is not restricted and the output from the Program is covered only if its contents constitute a work based on the Program independent of having been made by running the Program Whether that is true depends on what the Program does 1 You may copy and distribute verbatim copies of the Program s source code as you receive it in any medium provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty keep intact all the notices that refer to this License and to the absence of any warranty and give any other recipients of the Program a copy of this License along with the Program You may charge a fee for the physical act of transferring a copy and you may at your option offer warranty protection in exchange for a fee 2 You may modify your copy or copies of the Program or any portion of it thus forming a work based on the Program and copy and distribute such modifications or work under the terms of Se
35. environment variables and create or augment the following System variables if they dont already exist Variable Name Value EDITOR vim INCLUDE C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Include LIB C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Lib LIB_DIR C dev cpp qgislibs release PATH C Program Files CMake 2 4 bin 3ystemRoot 1system32 SystemRootf SystemRoot ASystem32Wbem C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Bin C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Bin WinNT C Program Files svn bin C Program Files Microsoft Visual Studio 8 VC bin C Program Files Microsoft Visual Studio 8 Common7 IDE c Program Files Microsoft Visual Studio 8 Common7 Tools c Qt 4 3 2 bin C Program FilesXPuTTY QTDIR c Qt 4 3 2 SVN_SSH C Program Files PuTTY plink exe Building Qt4 3 2 You need a minimum of Qt 4 3 2 here since this is the first version to officially support building the open source version of Qt for windows under MSVC Download Qt 4 x x source for windows from QGIS 0 9 1 User and Installation Guide 161 H 6 Environment Variables http www trolltech com Unpack the source to c Qt 4 x x Compile Qt Open the Visual Studio C command line and cd to c Qt 4 x x where you extracted the source and enter configure platform win32 msvc2005
36. happens if the source and target layers have different schemas field names and types are not the same QGIS populates what matches and ignores the rest If you don t care about the attributes being copied to the target layer it doesn t matter how you design the fields and data types If you want to make sure everything feature and its attributes gets copied make sure the schemas match Tip 16 CONGRUENCY OF PASTED FEATURES If your source and destination layers use the same projection then the pasted features will have geometry identical to the source layer However if the destination layer is a different projection then QGIS cannot guarantee the geometry is identical This is simply because there are small rounding off errors involved when converting between projections Deleting Selected Features If we want to delete an entire polygon we can do that by first selecting the polygon using the regular Select Features tool You can select multiple features for deletion Once you have the selection set use the Delete Selected tool to delete the features There is no undo function but remember your layer isn t really changed until you stop editing and choose to save your changes So if you make a mistake you can always cancel the save The Cut Features tool on the digitizing toolbar can also be used to delete features This effectively deletes the feature but also places it on a spatial clipboard So we cut the feature to delete
37. has been created it will be preserved across future QGIS sessions QGIS 0 9 1 User and Installation Guide 51 6 2 WMS Client Tip 21 ON WMS SERVER URLS Be sure when entering in the WMS server URL that you have the base URL For example you shouldn t have fragments such as request GetCapabilities Or version 1 0 0 in your URL Table 3 shows some example WMS URLs to get you started These links were last checked in December 2006 but could change at any time Table 3 Example Public WMS URLs Name URL Atlas of Canada http atlas gc ca cgi bin atlaswms_en DEMIS http www2 demis nl wms wms asp wms WorldMap amp Geoscience Australia http www ga gov au bin getmap pl dataset national NASA JPL OnEarth http wms jpl nasa gov wms cgi QGIS Users http qgis org cgi bin mapserv map var www maps main map amp An exhaustive list of WMS servers can be found at http wms sites com 6 2 3 Loading WMS Layers Once you have successfully filled in your parameters you can select the Connect button to retrieve the capabilities of the selected server This includes the Image encoding Layers Layer Styles and Projections Since this is a network operation the speed of the response depends on the quality of your network connection to the WMS server While downloading data from the WMS server the download progress is visualized in the left bottom of the WMS Plugin dialog Yo
38. headers so made the following edits In file Library Frameworks GEOS framework Headers io h comment out line 61 In file Library Frameworks GEOS framework Headers geom h comment out line 145 QGIS 0 9 1 User and Installation Guide 136 D 9 Building D 9 Building Now we can start the build process make If all built without errors you can then install it make install E Building on GNU Linux E 1 Building QGIS with Qt4 x Requires Ubuntu Edgy Debian derived distro These notes are for if you want to build QGIS from source One of the major aims here is to show how this can be done using binary packages for all dependencies building only the core QGIS stuff from source prefer this approach because it means we can leave the business of managing system packages to apt and only concern ourselves with coding QGIS This document assumes you have made a fresh install and have a clean system These instructions should work fine if this is a system that has already been in use for a while you may need to just skip those steps which are irrelevant to you E 2 Prepare apt The packages qgis depends on to build are available in the universe component of Ubuntu This is not activated by default so you need to activate it 1 Edit your etc apt sources list file 2 Uncomment the all the lines starting with deb Also you will need to be running K Ubuntu edgy or higher in order for all dependencies to b
39. iface The mandatory things a plugin must return are a name description and version all of which are im plemented in our script above Each method simply returns a string with the appropriate information The other requirement is the classFactory method that must return a reference to the plugin itself line 10 after receiving the iface object as an argument With this simple code QGIS will recognize our script as a plugin 11 7 3 Resources In order to have a nice icon for our plugin we need a resources file which we ll name resources qrc This is just a simple XML file that defines the icon resource lt RCC gt lt qresource prefix plugins newlayer gt lt file gt icon png lt file gt lt qresource gt lt RCC gt The resource file uses a prefix to prevent naming clashes with other plugins using the name of the plugin is usually sufficient The icon png file is is just a PNG image that will be used in the toolbar when the plugin is activated You can use any image as long as it s 22x22 pixels so it fits on the toolbar To turn the resource file into something the plugin can use it must be compiled using the PyQt resource compiler QGIS 0 9 1 User and Installation Guide 103 11 7 Using the Python Plugin pyrcc4 o resources py resources qrc The o switch is used to specify the output file Now that we have resources we need a way to collect the information needed for creating a new layer 11 7 4 Cre
40. just needed QString and took the first hit in google I could find Install Python Download http python org ftp python 2 5 1 python 2 5 1 msi and install it Install SIP Download http www riverbankcomputing com Downloads sip4 sip 4 7 1 zip and extract it into your c dev cpp directory From a Visual C command line cd to the directory where you extract SIP and run c python25 python configure py p win32 msvc2005 nmake nmake install QGIS 0 9 1 User and Installation Guide 163 H 7 Install CMake Install PyQt4 Download http www riverbankcomputing com Downloads PyQt4 GPL PyQt win gpl 4 3 1 zip and extract it into your c dev cpp directory From a Visual C command line cd to the directory where you extracted PyQt4 and run 1177 c python25 python configure py p win32 msvc2005 nmake nmake install H 7 Install CMake Download and install cmake 2 4 7 or better making sure to enable the option Update path for all users H 8 Install Subversion You must install the command line version if you want the CMake svn scripts to work Its a bit tricky to find the correct version on the subversion download site as they have som misleadingly named similar downloads Easiest is to just get this file http subversion tigris org downloads 1 4 5 win32 apache 2 2 svn win32 1 4 5 zip Extract the zip file to C Program Files svn And then add C Program Files svn bin To your path
41. lakes layers into QGIS 2 Change the colors and symbolize the data as you like 3 Save the project using Save Project from the File menu 4 Open the exporter by clicking on Export to MapServer Map in the File menu 5 Enter a name for your new map file 6 Browse and find the project file you just saved 7 Enter a name for the map QGIS 0 9 1 User and Installation Guide 76 9 2 Creating the Map File 8 Enter 600 for the width and 400 for the height 9 Our layers are in decimal degrees so we don t need to change the units 10 Choose png for the image type 11 Click OK to generate the map file Figure 20 Export to MapServer map module in QGIS ESAO ESENE Map file home gsherman mapserver_text map QGIS project file nome gsherman mapserver_test qgs fhome gsherman mapserver_test qgs _ Export LAYER information only Map Name My Test Map Web Interface Definition You ll notice there is no feedback on the success of your efforts This is an enhancement scheduled for the next version You can view the map file in an editor or using less If you take a look you ll notice that the export tool adds the metadata needed to enable our map file for WMS QGIS 0 9 1 User and Installation Guide 77 9 3 Testing the Map File 9 3 Testing the Map File Let s test our work by using the sho2img command to create an image from the map file The shp2img utility is part of MapServer but is also distributed wi
42. msys 126 CAMISA sob Ge a a ey ee ee EM Aas Bae oo oe ee 126 C2 Oa o OS GR Bae Re eee eG Ge Yate ee oS ee A eR a 126 C 3 Flex and Bison 3 og we e axa ha gee ates Se eel de Poe eek Sees ate oe See eed 127 C 4 Python stuff optional 0 eee ee 127 C 4 1 Download and install Python use Windows installer 127 C 4 2 Download SIP and PyQt4 sources 0000000 124 C43 Compile SIP adv ese e a a e ORG 128 C44 Gompile PYGl s s esi 948 64242 Bee RRR Eee A 128 C45 Final python Notes 3 boss dar EEN ERA RE 128 C5 SUBVErSION Js eee g e A E ATA RAR AR A we RR e ER 128 C6 CMake por io A a A A tase a 128 IGSS rre o e E A o e a e a a a E 128 BOO 129 C9 C nfig ratioN uses dr e A A A e A 129 C10 Complatiorrand installation lt 3 lt s sis coy renea ee A A e EE 130 C 11 Run qgis exe from the directory where it s installed CMAKE_INSTALL PREFIX 130 C 12 Create the installation package optional Sg Bek Wet Os Be BR nw bok ae de BRE G 130 D Building on Mac OSX using frameworks and cmake QGIS gt 0 8 130 BL Insta XCODE 244 84 ces aoe ee ide Be REE Aw Re be tA eee 131 D 2 Install Qt4 from dmg Soe oe ce sa ay Gs Ge ee Gus es Ge Sage Sree we ae eres te ewe ee 131 QGIS 0 9 1 User and Installation Guide vii Contents
43. preferred size and may have to be altered by QGIS depending on the level of zoom The size is measured according to the map units specified in the project properties Placement Scale bar style Colour of bar Size of bar Enable scale bar Top Left Paja Tick Down 30 degrees 3 Automatically snap to round number on resize ok Cancel lt gt QGIS 0 9 1 User and Installation Guide 89 11 3 Using the GPS Plugin 11 3 Using the GPS Plugin 11 3 1 What is GPS GPS the Global Positioning System is a satellite based system that allows anyone with a GPS receiver to find their exact position anywhere in the world It is used as an aid in navigation for example in airplanes in boats and by hikers The GPS receiver uses the signals from the satellites to calculate its latitude longitude and sometimes elevation Most receivers also have the capability to store locations known as waypoints sequences of locations that make up a planned route and a tracklog or track of the receivers movement over time Waypoints routes and tracks are the three basic feature types in GPS data QGIS displays waypoints in point layers while routes and tracks are displayed in linestring layers 11 3 2 Loading GPS data from a file There are dozens of different file formats for storing GPS data The format that QGIS uses is called GPX GPS eXchange format which is a stand
44. raster layer at varying transparency levels Use the transparency slider to indicate to what extent the underlying layers if any should be visible though the current raster layer QGIS can restrict the data displayed to only show cells whose values are within a given number of standard deviations of the mean for the layer This is useful when you have one or two cells with abnormally high values in a raster grid that are having a negative impact on the rendering of the raster This option is only available for pseudocolor images QGIS 0 9 1 User and Installation Guide 47 5 4 Raster Properties Dialog Tip 19 VIEWING A SINGLE BAND OF A MULTIBAND RASTER If you want to view a single band for example Red of a multiband image you might think you would set the Green and Blue bands to Not Set But this is not the correct way To display the Red band set the image type to grayscale then select Red as the band to use for Gray 5 4 2 General Tab The General tab displays basic information about the selected raster including the layer source and display name in the legend which can be modified This tab also shows a thumbnail of the layer its legend symbol and the palette Additionally scale dependent visability can be set in this tab You need to check the checkbox and set an appropriate scale where your data will be displayed in the map canvas Also the spatal reference system is printed here as a PROJ 4 string This can
45. reference to the QGIS interface 14 self iface iface QGIS 0 9 1 User and Installation Guide 104 11 7 Using the Python Plugin 15 16 def initGui self 17 Create action that will start plugin configuration 18 self action QAction QIcon plugins newlayer icon png 19 New PosGIS Layer self iface getMainWindow 20 QObject connect self action SIGNAL activated self run 21 22 Add toolbar button and menu item 23 self iface addToolBarIcon self action 24 self iface addPluginMenu amp New PostGIS Layer self action 25 26 def unload self 27 Remove the plugin menu item and icon 28 self iface removePluginMenu amp New PostGIS Layer self action 29 self iface removeToolBarIcon self action In lines 2 through 7 we import the libraries needed for the plugin This includes the PyQt libraries the QGIS core library and the Python PostgreSQL library psycopg Every Python script that uses the QGIS libraries and PyQt needs to import the QtCore and QtGui libraries as well as the QGIS core library This gives us access to the PyQt wrappers for our Qt objects like our input dialog and the QGIS core libraries We also need to import the resources py file we created with the icon definition In line 10 we declare the class NewLayer In the __init__ method lines 12 through 14 our class is initialized and passed the iface object from QGIS via the classFactory method in line 10 of __init__ py We stor
46. registry Depending on your computing environment storing passwords in your QGIS settings may be a security risk 4 2 2 Loading a PostGIS Layer 4 Once you have one or more connections defined you can load layers from the PostgreSQL database Of course this requires having data in PostgreSQL See Section 4 2 4 for a discussion on importing data into the database To load a layer from PostGIS perform the following steps e If the PostGIS layer dialog is not already open click on the Add a PostGIS Layer toolbar button e Choose the connection from the drop down list and click Connect e Find the layer you wish to add in the list of available layers e Select it by clicking on it You can select multiple layers by holding down the shift key while clicking See Section 4 5 for information on using the PostgreSQL Query Builder to further define the layer e Click on the Add button to add the layer to the map Tip 6 POSTGIS LAYERS Normally a PostGIS layer is defined by an entry in the geometry_columns table From version 0 8 1 on QGIS can load layers that do not have an entry in the geometry_columns table This includes both tables and views Defining a spatial view provides a powerful means to visualize your data Refer to your PostgreSQL manual for information on creating views QGIS 0 9 1 User and Installation Guide 25 4 2 PostGIS Layers 4 2 3 Some details about PostgreSQL layers This secti
47. that one element can represent y more features see above 0 Exit close digitizing session rebuilds topology afterwards 8 5 2 Category Tab This tab allows you to set the way in which the category will be assigned to each new feature and or assign a category to a feature e Mode what category should be attached to geometry Next not used next category not yet used in vector file Manual entry define the category in the Category entry field No category digitize geometry without entering any category QGIS 0 9 1 User and Installation Guide 68 8 6 Region Tool e Category a number ID attached to digitized feature e Field layer feature attribute table identification Tip 30 CREATING ADDITIONAL LAYERS WITH QGIS If you would like to add more layers to your dataset just add a new number in the Field layer entry box and press return In the Table tab you can create your new table connected to your new layer 8 5 3 Settings Tab This tab allows you to set the snapping in screen pixels This is the threshold in pixels in which new points or line ends are snapped to existing nodes This helps prevent gaps or dangles between boundaries The default is set to 10 pixels 8 5 4 Symbology Tab This tab allows you to view and set symbology and color settings for various geometry types and their topological status e g closed opened boundary 8 5 5 Table Tab This tab provi
48. the distribution of the whole must be on the terms of this License whose permissions for other licensees extend to the entire whole and thus to each and every part regardless of who wrote it Thus it is not the intent of this section to claim rights or contest your rights to work written entirely by you rather the intent is to exercise the right to control the distribution of derivative or collective works based on the Program In addition mere aggregation of another work not based on the Program with the Program or with a work based on the Program on a volume of a storage or distribution medium does not bring the other work under QGIS 0 9 1 User and Installation Guide 168 the scope of this License 3 You may copy and distribute the Program or a work based on it under Section 2 in object code or executable form under the terms of Sections 1 and 2 above provided that you also do one of the following a Accompany it with the complete corresponding machine readable source code which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange or b Accompany it with a written offer valid for at least three years to give any third party for a charge no more than your cost of physically performing source distribution a complete machine readable copy of the corre sponding source code to be distributed under the terms of Sections 1 and 2 above on a medium customarily us
49. the summary to make sure it s correct 18 Click Finish 19 The mapset and location are created and opened as the current working set 20 Notice that some of the tools in the GRASS toolbar that were disabled are now enabled for us to use If that seemed like a lot of steps it s really not all that bad and a very quick way to create a location Our location is now ready for use To view the default region zoom out Clicking the Display Current Grass Region tool toggles the display region on and off 8 4 Vector Data Model It is important to understand the GRASS vector data model prior to digitizing In general GRASS uses a topological vector model This means that areas are not represented as closed polygons but by one or more boundaries A boundary between two adjacent areas is digitized only once and it is shared by both areas Boundaries must be connected without gaps An area is identified labeled by the centroid of the area Besides boundaries and centroids a vector map can also contain points and lines All these geometry elements can be mixed in one vector and will be represented in different so called layers inside QGIS It is possible to store more layers in one vector dataset For example fields forests and lakes can be stored in one vector Adjacent forest and lake can share the same boundary but they have separate attribute tables It is also possible to attach attributes to boundaries For example the bounda
50. to the map overview even if the layers in the map overview have been set up for labeling You can add a single layer to the overview by right clicking on QGIS 0 9 1 User and Installation Guide 14 3 5 Rendering itin the legend and choosing Aad to overview You can also add or remove all layers to the overview using the Overview tools on the toolbar You can also grab the red rectangle showing your current extent and pan around the map view will update accordingly 3 4 6 Status Bar The status bar shows you your current position in map coordinates e g meters or decimal degrees as the mouse pointer is moved across the map view The status bar also shows the view extents of the map view as you pan and zoom in and out A progress bar in the status bar shows progress of rendering as each layer is drawn to the map view In some cases such as the gathering of statistics in raster layers the progress bar will be used to show the status of lengthy operations On the right side of the status bar is a small checkbox which can be used to temporarily prevent layers being rendered to the map view see Section 3 5 below At the far right of the status bar is a projector icon Clicking on this opens the projection properties for the current project 3 5 Rendering By default QGIS renders all visible layers whenever the map canvas must be refreshed The events that trigger a refresh of the map canvas include e Adding a layer e
51. trust me on this one and then set the canvas to visible by calling the show method Next we set the layer to use a vertical box layout within the frame and add the map canvas to it in line 43 QGIS 0 9 1 User and Installation Guide 113 12 2 Creating the MainWindow Lines 48 to 63 set up the actions and connections for the tools in our toolbar For each tool we create a QAction using the icon we defined in our resources file Then we connect up the activated signal from the tool to the method in our class that will handle the action This is similar to how we set things up in the plugin example Once we have the actions and connections we need to add them to the toolbar In lines 66 through 72 we create the toolbar and add each tool to it Lastly we create the three map tools for the application lines 75 through 77 We ll use the map tools in a moment when we define the methods to make our application functional Let s look at the methods for the map tools 78 Set the map tool to zoom in 79 def zoomIn self 80 self canvas setMapTool self toolZoomIn 81 82 Set the map tool to zoom out 83 def zoom0ut self 84 self canvas setMapTool self toolZoomOut 85 86 Set the map tool to 87 def pan self 88 self canvas setMapTool self toolPan 89 90 Zoom to full extent of layer 91 def zoomFull self 92 self canvas zoomFullExtent For each map tool we need a method that corresponds to the connection we
52. vsinstalldir gt VC include G 2 Download Install Dependencies This section describes the downloading and installation of the various QGIS dependencies G 2 1 Flex and Bison Flex and Bison are tools for generation of parsers they re needed for GRASS and also QGIS compi lation Download the following packages and run the installers http gnuwin32 sourceforge net downlinks flex php http gnuwin32 sourceforge net downlinks bison php G 2 2 To include PostgreSQL support in Qt If you want to build Qt with PostgreSQL support you need to download PostgreSQL install it and create a library you can later link with Qt Download from binary v8 2 5 win32 postgresql 8 2 5 1 zip from an PostgreSQL org Mirror and in stall PostgreSQL is currently build with MinGW and comes with headers and libraries for MinGW The headers can be used with Visual C out of the box but the library is only shipped in DLL and archive a form and therefore cannot be used with Visual C directly To create a library copy following sed script to the file mkdef sed in PostgreSQL lib directory Dump of file QGIS 0 9 1 User and Installation Guide 150 G 2 Download Install Dependencies s Dump of file LIBRARY 1 p al EXPORTS J ordinal hint Summary PT J o 9 4 s J 0 9 4 IM O0 9A Fa fIX 0 9A Fa f W JANCE J 6 M p and process execute in the Visual St
53. with the PostgreSQL installer Simply run the installers QGIS 0 9 1 User and Installation Guide 153 G 3 Building QGIS with CMAKE G 2 9 Expat Get expat from here http sourceforge net project showfiles php group_id 10127 You ll need expat win32bin 2 0 1 exe Simply run the executable to install expat G 2 10 CMake Get CMake from here http www cmake org HTML Download html You ll need cmake lt version gt win32 x86 exe Simply run this to install CMake G 3 Building QGIS with CMAKE Get QGIS source from svn svn co https svn qgis org repos qgis trunk qgis agis Create a Build directory in the top level QGIS directory This will be where all the build output will be generated Run Start gt All Programs gt CMake gt CMake In the Where is the source code box browse to the top level QGIS directory In the Where to build the binaries box browse to the Build directory you created in the top level QGIS directory Fill in the various _INCLUDE_DIR and _LIBRARY entries in the Cache Values list Click the Configure button You will be prompted for the type of makefile that will be generated Select Visual Studio 8 2005 and click OK All being well configuration should complete without errors If there are errors it is usually due to an incorrect path to a header or library directory Failed items will be shown in red in the list Once co
54. written to a valid mapset Therefore you need to start QGIS from within a GRASS session Then your current mapset will be opened for writing Another option for opening a mapset for writing is provided through the GRASS plugin entry Use Plugins gt GRASS gt Open mapset If you have a greyed out GRASS toolbox button make sure you open a valid mapset for writing since the GRASS plugin needs a mapset to store its results The toolbox also provides a very useful data browser for browsing through your current location and the mapsets it contains 8 7 1 Modules inside the toolbox The GRASS toolbox provide a collection of GRASS modules which can be used from within QGIS They are grouped in thematic blocks which can be defined by the user see Section 8 7 3 When clicking on a module a new tab will be added to your toolbox which provides three new sub tabs 1 Options 2 Output 3 Manual Options This tab provides you with a very simplified entry field where you need to select the needed maps and enter parameters to run the selected module Note that these options are kept as simple as possible in order to keep the structure clear If you need more of the module s options feel free to use the GRASS shell to run the module QGIS 0 9 1 User and Installation Guide 70 8 7 GRASS Toolbox Output This tab provides you with the output generated from the running module After you hit the run button the module s
55. 07e 06 We used 5 coordinate points to georeference the raster image To get correct results it is important to disperse the points regulary in the image Finally we check the result and load the new georeferenced map spearfish_topo24 tif and overlay it with the map roads of the spearfish60 location Figure 38 Georeferenced map with overlayed roads from spearfish60 location Quant Gis a 0rGanyimnede Ganymede Jada POMBO PORNO vioaga gt 9 gt Legend Spearfish topo2y 7 st Seale 1 20606 590921 4928262 EJ Render QGIS 0 9 1 User and Installation Guide 101 11 7 Using the Python Plugin 11 7 Using the Python Plugin Writing plugins in Python is much simpler than using C To create a PyQGIS plugin you need QGIS 0 9 Python PyQt and the Qt developer tools bh When QGIS starts up it scans certain directories looking for both C and Python plugins For a file shared library DLL or python script to be recognized as a plugin it has to have a specific signature For Python scripts it s pretty simple QGIS looks in the following locations under the installation directory e Linux and other Unix share qgis python plugins e Mac OS X Contents MacOS share qgis python plugins e Windows share QGI S python plugins Each Python plugin is contained in its own directory When QGIS starts up it will scan each subdirec tory in share ggis python plugins and initialize any p
56. 1 concentrates on stabilization and feature enhancement e 66 bugfixes and feature improvements e New window arrangement feature for the Georeferencer e New locale tab in the options dialog e Download progress information for WMS and WFS data e More GRASS modules added to the GRASS toolbox QGIS 0 9 1 User and Installation Guide 3 2 Introduction To GIS A Geographical Information System GIS 1 is a collection of software that allows you to create visualise query and analyse geospatial data Geospatial data refers to information about the geo graphic location of an entity This often involves the use of a geographic coordinate like a latitude or longitude value Spatial data is another commonly used term as are geographic data GIS data map data location data coordinate data and spatial geometry data Applications using geospatial data perform a variety of functions Map production is the most easily understood function of geospatial applications Mapping programs take geospatial data and render itin a form that is viewable usually on a computer screen or printed page Applications can present static maps a simple image or dynamic maps that are customised by the person viewing the map through a desktop program or a web page Many people mistakenly assume that geospatial applications just produce maps but geospatial data analysis is another primary function of geospatial applications Some typical types of analysis incl
57. 2 Dialog for adding a WMS server showing its available layers 53 13 Adding a WES layen x s se p A E 57 14 Projection Dialog GNU Linux 60 15 Custom Projection Dialog OS X 0 0 61 16 Creating a GRASS location in QGIS 0 00000 65 17 GRASS Edit Dialog ooo aa 67 18 GRASS TODO caos e a A OS e eS ED A RE RE 72 19 Module generated through parsing the XML file lt 73 20 Export to MapServer map module in QGIS aooaa 0000505 77 21 Map COMPOSE ts ec ee eee eae ee oe es a E E ad a A 80 22 Map Composer with map view legend scalebar and text added 82 29 Plugin Ma agens d es ct Peale ds a Bae ese a AE e Sy RN 84 24 Copyright Plugin bec enced a a 87 25 North Arrow Plugin lt 4 408 a a a wh we ie K aa ae e E do ee bw 88 26 Scale Bar An EA E REE 89 27 The GPS Tools dialog window 590 ac dl a BES ee ee ee 90 28 File selection dialog forthe import tool lt lt 92 29 Ihe download 100 e ciar a A a a ORES 93 30 Delimited Text Dialog 0 95 391 FG SOCIO ciren eaa earr RR oe OE e RA AAA RA AA 95 32 Fields Parsed from Text File gos metsis aeee E EA E G a ce 96 33 Selecting the X and Y Fields 0 0c 2 96 34 Create a graticule layer aooaa SRS EA SER OAS EE EHS 97 35 Select an image to georeference ee 98 36 Arrange plugin window with the qgis map canvas s soos
58. 5 Longitude 60 Graticle size units in degrees Latitude Interval pe J Longitude Interval 5 57 Output shape file omeldassaulgraticule_europe shp ok Cancel Here is an example how to create a graticule 1 Make sure the plugin is loaded 2 Click on the Graticule Creator tool on the plugins toolbar 3 Choose the type of graticule you which to create point line or polygon 4 Enter the latitude and longitude for the lower left and upper right corners of the graticule 5 Enter the interval to be used in constructing the grid You can enter different values for the X and Y directions longitude latitude 6 Choose the name and location of the shapefile to be created 7 Click OK to create the graticule and add it to the map canvas QGIS 0 9 1 User and Installation Guide 97 11 6 Using the Georeferencer Plugin 11 6 Using the Georeferencer Plugin The georeferencer plugin allows to generate world files for rasters Therefore you select points on the raster add their coordinates and the plugin will compute the world file parameters The more coordinates you provide the better the result will be As an example we will generate a world file for a topo sheet of South Dakota from SDGS It can later be visualized together with in the data of the GRASS spearfish60 location You can download the topo sheet here http grass itc it sampledata spearf
59. 5 6 yu GS Be HS 2 oe Bs Ge ee we aE 140 E 9 Starting the compile 6462 ces iris REDE RE EES SAREE ESE He Eee 140 E10 RUNNING QGIS 5 x44 48 4 4 boy 29 6 EB AE A Oe EHS 141 F Creation of MSYS environment for compilation of Quantum GIS 141 El IMMA SOUp 2 5 0090 ere Be ee Be ee ee a AAA GH Ee eK 141 Ella MSYSle ss 64 64 249 644448062 RES Sees SER ERS SS DS 141 2 MnGW e e e Se Go e E ee OS A Oe OP Oe Ow a S 142 ELSA Flexand Bison s hes et eey a a ep oe ea eS SR oe ee 142 E2 Installing dependencies e i saos ois how ewe la a ee OS eee ee a 142 F 2 1 Getting ready Lk SGD Pe ee oS oh we BS AAA Bee ee et 142 EX GDAL level ONE s esci AA AAA AAA 143 E23 GRASS a eaa ai bebe ee Sas eed e a Soames A 145 E24 GOAL level TWO aos e dr A ai A Ame Eee WP DAD io sigs E E aA a ae tie Ai ow ese A 146 E25 GEOS ke Stk eee Se A eG ee ES 147 E26 SS QUEDE 5 6 2 6 ea Poe ee E iea OES sao E 147 EXE a ge red A A de Oe a A Be ee ee 148 PAS ERA as dae ete ag tes AG ee Brae Ge e ate A Ge eee 148 EX POSTORES so rusas sate is a e we ets 148 A AA A OS 149 QGIS 0 9 1 User and Installation Guide viii Contents G Building with MS Visual Studio 149 Gal Setup
60. 90 91 for more information If you missed a discussion on IRC not a problem We log all discussion so you can easily catch up Just go to http logs qgis org and read the IRC logs 13 3 BugTracker While the qgis users mailing list is useful for general how do do xyz in QGIS type questions you may wish to notify us about bugs in QGIS You can submit bug reports using the QGIS bug tracker at http svn qgis org trac When creating a new ticket for a bug please provide an email address where we can request additional information Please bear in mind that your bug may not always enjoy the priority you might hope for depending on its severity Some bugs may require significant developer effort to remedy and the manpower is not always available for this Feature requests can be submitted as well using the same ticket system as for bugs Please make sure to select the type enhancement If you have found a bug and fixed it yourself you can submit this patch also Again the lovely trac ticketsystem at http svn qgis org trac has this type as well Select patch from the type menu Someone of the developers will review it and apply it to QGIS Please dont be alarmed if your patch is not applied straight away developers may be tied up with other committments 13 4 Blog The QGIS community also runs a weblog BLOG at http blog qgis org which has some in teresting articles
61. Cutting Copying and Pasting Features Selected features can be cut copied and pasted between layers in the same QGIS project as long as destination layers are set to Allow editing beforehand Features can also be pasted to external applications as text That is the features are represented in CSV format with the geometry data appearing in the OGC Well Known Text WKT format However in this version of QGIS text features from outside QGIS cannot be pasted to a layer within QGIS When would the copy and paste function come in handy Well it turns out that you can edit more than one layer at a time and copy paste features between layers Why would we want to do this Say we need to do some work on a new layer but only need one or two lakes not the 5 000 on our big_lakes layer We can create a new layer and use copy paste to plop the needed lakes into it As an example we are copying some lakes to a new layer 1 Load the layer you want to copy from source layer 2 Load or create the layer you want to copy to target layer 3 Start editing for both layers 4 Make the source layer active by clicking on it in the legend 5 Use the select tool to select the feature s on the source layer QGIS 0 9 1 User and Installation Guide 39 4 4 Editing 6 Click on the Copy Features tool 7 Make the destination layer active by clicking on it in the legend 8 Click on the Paste Features tool 9 Stop editing and save the changes What
62. DSN will look something like this dbname gis_data user gsherman To get the DSN we prompt the user with a QInputDialog in line 47 If the user enters a DSN then we can proceed with the connection to the database in line 50 We get a cursor from the connection in line 51 and then execute the SQL statement to create the table and commit the change in lines 52 through 53 This creates the table but for it to be a valid layer and ready for us to use it needs a couple more things QGIS 0 9 1 User and Installation Guide 107 11 7 Using the Python Plugin Figure 41 Enter DSN for connection to PostGIS database L atesase Dsl Enter the DSN for connecting to the database dbname db user user dbname gis_data user gsherman First it needs a geometry column We purposely didn t include one when we created the table so we could use the AddGeometryColumn function to create it This function adds a geometry column to the table and then puts an entry in the geometry_columns table for us In line 55 we specify the table name the name we want for the geometry column the SRID feature type and the dimension of the feature The last thing to do is create a spatial index on the table so we get optimum performance when doing spatial searches and displaying the data in QGIS In line 59 we have cobbled together the SQL to create the index The actual statement looks like this create index sidx_park_land on park_land USING GI
63. ES Client si ee ua oh Vee OA BEES ERE EEN Ae eS 56 6 3 1 Loading a WES Layer ocio aw Deed oa we Dee WE Se EGE WH 56 7 Working with Projections 59 7 1 Overview of Projection Support 2 2 2 0 e 59 Z2 Getting Started bros Ries oo td a a Re A e A 59 7 2 1 Specifying a Projection 20 54 os 4a ee a RE Se eG EHS 61 Z3 CUSIOMPIOECIONS za 6 222 4b aint a eee et ge ee 61 8 GRASS Integration 63 81 Slaning CIS Wil GRASS 2 4 055 6 baw Oy SER oe Oe ea ee Ae A 63 8 2 Loading GRASS Dat 4 agrade be pe Seed SEEDERS Se be aA 64 8 3 Crealo a Location 6 60 ias e a ee a a OS he Be le ee ee 64 8 4 Vector Dala Model 3 coe nek e ok om eae ke e ae ee ee ee A 66 8 5 Digitizing and Editing Tools 2440 4 24 Ack 6 amp ESE RRO REEDS RAE RS 67 Sl TODA eene s seh od OOD 6 ARE EEA AA OS oe ee 68 6 5 2 Category Tab yesica eae oe a BR eG ee ee ee we Sp 68 853 Settings TOD 2 ey tasa d gees ht Bh HS a oH A ew BE 69 8 54 Symboldoy Tab 2c b 5 4 Gb 6 Ge G4 we REGAL ERS OA REE ERG Se Eee 69 85 5 Table Tabs pt he bea Gob ook eed bm tie Soe ae Bee ee wR p mh oe Ss 69 8 6 Region TOO 27 bee Khe RS SRS AA Ew og AA AA 69 8 Z GRASS TODIDON vs x a2 su ea trie hse be ee e RR ee WR he ee Be 70 8 7 1 Modules inside the toolbox 2 0 0 ee ee 70 8 7 2 GRASS Browsen lt ss ERA OR AIDA AS 71 8 7 3 Customizing the modules section e 72 8 8 Creating a new GRASS YO ae E ii E ae A eS 73 9 Making M
64. Forge in June of the same year We ve worked hard to make GIS software which is traditionaly expensive commerical software a viable prospect for anyone with basic access to a Personal Computer QGIS currently runs on most Unix platforms Windows and OS X QGIS is developed using the Qt toolkit http www trolltech com and C This means that QGIS feels snappy to use and has a pleasing easy to use graphical user interface QGIS aims to be an easy to use GIS providing common functions and features The initial goal was to provide a GIS data viewer QGIS has reached that point in its evolution and is being used by many for their daily GIS data viewing needs QGIS supports a number of raster and vector data formats with new support easily added using the plugin architecture see Appendix A for a full list of currenly supported data formats QGIS is released under the GNU General Public License GPL Developing QGIS under this license means that you can inspect and modify the source code and guarantees that you our happy user will always have access to a GIS program that is free of cost and can be freely modified You should have received a full copy of the license with your copy of QGIS and you also find it as Appendix ll Note The latest version of this document can always be found at http qgis org docs userguide pdf 1 1 Features QGIS has many common GIS features and functions The major features are listed below d
65. IBUTE VALUE TYPES In the current version of QGIS the attributes dialog box does not check that the data entered matches the type expected e g numeric vs text Make sure of this before pressing Ok otherwise you may find the error will be caught later when you try to save your changes Editing Vertices of a Feature For both PostgreSQL PostGIS and shapefile based layers the verticies of features can be edited Verticies can be directly edited that is you don t have to choose which feature to edit before you can change its geometry In some cases several features may share the same vertex and so the following rules apply when the mouse is pressed down near map features e Lines The nearest line to the mouse position is used as the target feature Then for moving and deleting a vertex the nearest vertex on that line is the editing target e Polygons If the mouse is inside a polygon then it is the target feature otherwise the nearest polygon is used Then for moving and deleting a vertex the nearest vertex on that polygon is the editing target You will need to set the property Settings gt Project Properties gt General gt Snapping Tolerance to a number greater than zero Otherwise QGIS will not be able to tell which feature is being edited Adding Vertices of a Feature You can add new verticies to a feature by using the Add Vertex icon on the toolbar Note it doesn t make sense to add more verticies to a Point feature
66. IS Now you can try to run QGIS HOME apps bin qgis If all has worked properly the QGIS application should start up and appear on your screen F Creation of MSYS environment for compilation of Quantum GIS F 1 Initial setup F 1 1 MSYS This is the environment that supplies many utilities from UNIX world in Windows and is needed by many dependencies to be able to compile Download from here QGIS 0 9 1 User and Installation Guide 141 F 2 Installing dependencies http puzzle dl sourceforge net sourceforge mingw MSYS 1 0 11 2004 04 30 1 exe Install to c msys All stuff we re going to compile is going to get to this directory resp its subdirs F 1 2 MinGW Download from here http puzzle dl sourceforge net sourceforge mingw MinGW 5 1 3 exe Install to c Imsys mingw It suffices to download and install only g and mingw make components F 1 3 Flex and Bison Flex and Bison are tools for generation of parsers they re needed for GRASS and also QGIS compi lation Download the following packages http gnuwin32 sourceforge net downlinks flex bin zip php http gnuwin32 sourceforge net downlinks bison bin zip php http gnuwin32 sourceforge net downlinks bison dep zip php Unpack them all to c msys local F 2 Installing dependencies F 2 1 Getting ready Paul Kelly did a great job and prepared a package of precompiled libraries for GRASS T
67. IS into c Program Files qgis 0 8 1 or whatever the current version is The name should strictly match the version no After making this copy you can uninstall the release version of QGIS from your c Program Files directory using the provided uninstaller Double check that the Quantum GIS dir is completely gone under program files afterwards Another possibility is to run qgis exe when your path contains c msys local bin and c msys local lib directories so the DLLs will be used from that place C 12 Create the installation package optional Downlad and install NSIS from http nsis sourceforge net Main_Page Now using windows explorer enter the win_build directory in your QGIS source tree Read the READMEfile there and follow the instructions Next right click on qgis nsi and choose the option Compile NSIS Script D Building on Mac OSX using frameworks and cmake QGIS gt 0 8 In this approach will try to avoid as much as possible building dependencies from source and rather use frameworks wherever possible QGIS 0 9 1 User and Installation Guide 130 D 1 Install XCODE D 1 Install XCODE recommend to get the latest xcode dmg from the Apple XDC Web site Install XCODE after the 941mb download is complete D 2 Install Qt4 from dmg You need a minimum of Qt4 2 suggest getting the latest at time of writing ftp ftp trolltech com qt source qt mac opensource 4 3 2 dmg If you want debug libs
68. OTF projection enabled To use OTF projection you must open the Project Properties dialog select a projection for the map and enable projections There are two ways to open the Project Properties dialog 1 Select Project Properties from the Settings menu 2 Click on the projector icon in the lower right hand corner of the statusbar Tip 27 PROJECT PROPERTIES DIALOG If you open the Project Properties dialog from the Settings menu you must click on the Projection tab to view the projection settings Opening the dialog from the projector icon will automatically bring the Projection tab to the front QGIS 0 9 1 User and Installation Guide 59 7 2 Getting Started The Projection dialog contains four important components as numbered in Figure 14 and described below Figure 14 Projection Dialog GNU Linux Project Properties lt galileo gt _ Enabk on the fly projection ay Propcton a Spatial Reference System as Geographic Coordinate Systems a E Projected Coordinate Systems Abers Equal Area NAD 27 Alaska Albers meters NAD27 Alaska Albers NADB3 BC Albers Cassini Krovak Oblique Conic Conformal QGIS SASID 209 ay PostGIS SRID 5000 proj aea ft_1 55 at_2 65 Hat_0 50 Jon_0 154 x_0 0 y_0 0 ellps cIrk66 datum NAD27 8 Postgs SRID O EPSG ID O OGISSASID C Name O TI 1 Enable projections this checkbox is used to enable or disable OTF projection W
69. PIUQIO s saas We oy a e eSB a ar E eee e ey eee 87 11 2 2 North Arrow Plugin sui a ir A e we eed 88 11 2 3 Scale Bar Plu id be Beier Se ee e dd fee Bed SS me torte BM ee ee 88 11 3 Using the GPS TE BE se eG eee carters Ga ee er gee ec ce a obs Ge rs Gn ea ars 90 BA Whats GPSA 4 5 c cma AR NE GCS Se Re WY oe OR 90 113 2 Loading GPS Gata WOM a file 005 0 ub KS we Boe e BOE A 90 11 3 33GPSBa0Gl 6 e ce eb a SREB SRE SO SEE EHS Sw ORS 91 11 34 Importing GPS Catal s lt e se nagoa ga tide pee eee eRe hw Ooh A 91 11 3 5 Downloading GPS data from a device o oo 5s 91 11 3 6 Uploading GPS data to a device os 0 00055 000 ee Ge be ee a 92 11 3 7 Defining new device types ooo ee 92 11 4 Using the Delimited Text Plugins 26 02 oe oe See de oR HS REE OE HOR EH 94 11 4 1 Requirements 24 4 265 0 2636 ees SE RRR EMR EREE SD Wo RR 94 112 AGING Me PMG IN ear aas ds A ey BH OS el eH EOE 95 11 5 Using the Graticule Creator Plugin 2 2 0 0000 cee eee eee 97 11 6 Using the Georeferencer a A A 98 11 2 Using the Python PIO i ui aos a aa a Be SE SEES e a Be 102 11 7 1 Setting up the Structure 4 2 bee Ss BES de a E e de e ee 102 11 7 2 Making the Plugin Recognizable 103 lA RES QUICES 22080 24 hay oe be e os et rs di a 103 11 7 4 Creating the GUI ooo rra be eee a e a 104 11 7 5 Creating the PIU amp 2 2 6 e er e a ria E ee a ee ee 104 11 7 6 Issues and Prob
70. Panning or zooming e Resizing the QGIS window e Changing the visibility of a layer or layers QGIS allows you to control the rendering process in a number of ways 3 5 1 Scale Dependent Rendering Scale dependent rendering allows you to specify the minimum and maximum scales at which a layer will be visible To set scale dependency rendering open the properties dialog by double clicking on the layer in the legend On the General tab set the minimum and maximum scale values and then click on the Use scale dependent rendering checkbox You can determine the scale values by first Zooming to the level you want to use and noting the scale value in the QGIS status bar QGIS 0 9 1 User and Installation Guide 15 3 6 Measuring 3 5 2 Controlling Map Rendering Map rendering can be controlled in the following ways Suspending Rendering To suspend rendering click the Render checkbox in the lower right corner of the statusbar When the Render box is not checked QGIS does not redraw the canvas in response to any of the events described in Section 3 5 Examples of when you might want to suspend rendering include e Add many layers and symbolize them prior to drawing e Add one or more large layers and set scale dependency before drawing e Add one or more large layers and zoom to a specific view before drawing e Any combination of the above Checking the Render box enables rendering and causes and immediate refresh of the map canvas
71. Plugin These decorate the map by adding cartographic elements 11 2 1 Copyright Label Plugin Figure 24 Copyright Plugin Description Enter your copyright label below This plugin supports basic html markup tags for formatting the label For example lt B gt Bold text lt B gt lt l gt Italics lt i gt note amp copy gives a copyright symbol amp copy QGIS 2007 Placeme nt Bottom Right gt R Enable Copyright Label The title of this plugin is a bit misleading you can add any random text to the map 1 Make sure the plugin is loaded 2 Click on the Copyright Label tool on the Plugins toolbar 3 Enter the text you want to place on the map You can use HTML as shown in the example 4 Choose the placement of the label from the drop down box QGIS 0 9 1 User and Installation Guide 87 11 2 Using the Decorations Plugins 5 Make sure the Enable Copyright Label checkbox is checked 6 Click OK In the example above the first line is in bold the second created using lt br gt contains a copyright symbol followed by our company name in italics 11 2 2 North Arrow Plugin The North Arrow plugin places a simple north arrow on the map canvas At present there is only one style available You can adjust the angle of the arrow or let QGIS set the direction automatically If you choose to let QGIS determine the direction it makes its best guess as to how the arrow sh
72. S layer 34 if table_name 0 length gt 0 35 Get the field names and types 36 fields QInputDialog getText None Field Names 37 Fields separate with a comma 38 parts fields 0 split 39 Create the SQL statement 40 sql create table table_name 0 id int4 primary key 41 for fld in parts 42 sql fld varchar 10 43 sql sql 0 2 44 sql 45 Connect to the database 46 First get the DSN 47 dsn QInputDialog getText None Database DSN 48 Enter the DSN for connecting to the database dbname db user user 49 if dsn 0 length Q gt 0 50 con psycopg connect str dsn 0 51 curs con cursor 52 curs execute str sql 53 con commit 54 add the geometry column 55 curs execute select AddGeometryColumn str table_name 0 56 gt the_geom 4326 POLYGON 2 57 con commit 58 create the GIST index 59 curs execute create index sidx_ str table_name 0 on 60 str table_name 0 USING GIST the_geom GIST_GEOMETRY_OPS 61 con commit The first thing we need to do is use the QInputDialog to get the name of the table to create This is done in line 32 where we prompt for it In line 34 we check to see if the user actually entered anything before proceeding Next we need to get the field names For this example we are keeping it very simple Every field will be a varchar 10 meaning we can store up to 10 c
73. SDTS DEM CATD DDF e SAR CEOS e USGS ASCII DEM dem e X11 Pixmap xpm QGIS 0 9 1 User and Installation Guide 124 B Installation Guide The following chapters provide build and installation information for QGIS Version 0 9 1 This docu ment corresponds almost to a IATEX conversion of the INSTALL t2t file coming with the QGIS sources from November 29th 2007 A current version is also available at the wiki see http wiki qgis org qgiswiki BuildingFromSource B 1 General Build Notes At version 0 8 1 QGIS no longer uses the autotools for building QGIS like a number of major projects eg KDE 4 0 now uses cmake for building from source The configure script in this directory simply checks for the existence of cmake and provides some clues to build QGIS For complete information see the wiki at http wiki qgis org qgiswiki Building_with_CMake B 2 An overview of the dependencies required for building Required build deps e CMake gt 2 4 3 e Flex Bison Required runtime deps e Qt gt 4 2 0 e Proj gt Known to work with 4 4 x e GEOS gt 2 2 3 0 is supported maybe 2 1 x works too e Sqlite3 gt probably 3 0 0 e GDAL OGR gt 1 2 x should work Optional dependencies e for GRASS plugin GRASS gt 6 0 0 e for georeferencer GSL gt works with 1 8 QGIS 0 9 1 User and Installation Guide 125 e for postgis support and SPIT plugin Po
74. SHOME HOME qgis_09 For Windows set PATH C qgis PATH set PYTHONPATH C qgis python set QGISHOME C qgis In the case of Linux or OS X we assume that QGIS is installed in your home directory in qgis_09 For Windows QGIS is installed in C lgg s When the application starts up it looks like this Figure 43 Starting the new demo application Database Ws Enter the DSN for connecting to the database dbname db user user dbname gis_data user gsherman To add the world_borders layer click on the Add Layer tool and navigate to the data directory Select the shapefile and click Open to add it to the map Our custom fill color is applied and the result is Figure 44 Adding a layer the demo application Database Ws Enter the DSN for connecting to the database dbname db user user dbname gis_data user gsherman Creating a PyQGIS application is really pretty simple In less than 150 lines of code we have an application that can load a shapefile and navigate the map If you play around with the map you ll notice that some of the built in features of the canvas also work including mouse wheel scrolling and panning by holding down the Space bar and moving the mouse QGIS 0 9 1 User and Installation Guide 117 12 4 Running the Application Some sophisticated applications have been created with PyQGIS and more are in the works This is pretty impressive considering that this development has taken place even
75. ST the_geom GIST_GEOMETRY_OPS 11 7 6 Issues and Problems Our plugin is now complete Now lets look at some of the things that are wrong with it or where we could improve it e We could use an improved GUI one that lets the user enter all the needed information on one dialog e The user can t specify field types e There is limited error checking in the dialog If you don t enter any fields the plugin fails There is no error checking on any of the database operations e There is no feedback from the plugin once it completes With all the issues it still serves as a primordial plugin that illustrates the process and helps get you started with your own plugin development QGIS 0 9 1 User and Installation Guide 108 11 7 Using the Python Plugin 11 7 7 Adding Feedback Let s fix one of the small problems by adding some feedback at the end of the process We ll just add a message box to tell the user that everything is done and to check the database to make sure the table was created To do this we just add the following code after line 61 show the user what happened QMessageBox information None Results Table str table_name 0 has been created Check your database to confirm When the table is created the user sees this Figure 42 Message Box with Plugin results E Table park_land has been created Check your database to confirm 11 7 8 Summary Writing a QGIS plugin in Py
76. TY OF SUCH DAMAGES QGIS 0 9 1 User and Installation Guide 171 1 1 Quantum GIS Qt exception for GPL 1 1 Quantum GIS Qt exception for GPL In addition as a special exception the QGIS Development Team gives permission to link the code of this program with the Qt library including but not limited to the following versions both free and commercial Qt Non commerical Windows Qt Windows Qt X11 Qt Mac and Qt Embedded or with modified versions of Qt that use the same license as Qt and distribute linked combinations including the two You must obey the GNU General Public License in all respects for all of the code used other than Qt If you modify this file you may extend this exception to your version of the file but you are not obligated to do so If you do not wish to do so delete this exception statement from your version QGIS 0 9 1 User and Installation Guide 172 Literature 1 T Mitchell Web mapping illustrated published by o reilly 2005 2 G Sherman Shuffing quantum gis into the open source gis stack free and open source software for geospatial foss4g conference victoria bc 2007 Web References 3 GRASS GIS http grass itc it 2006 4 PostGIS http postgis refractions net 2006 5 Web Map Service 1 1 1 Implementation Specification http portal opengeospatial org 2002 6 Web Map Service 1 3 0 Implementation Specification http portal op
77. VISUAL SUI s s 0 eG ES SRS O OHS EA Ow HE 149 1 1 Express Edition lt ori a G2 RR ome te a eR Ea he E 149 Sl All Editions e e i she ae Bo hs ee p nico Es ew ee E 150 G 2 Download Install Dependencies 0 00 ee 150 G21 Plex ana BSO cerrar ar a OH EE ke OO He ORS eS 150 G 2 2 To include PostgreSQL support in Qt ee eee A ee 150 G23 Oh ss tae E ee es OBE ee eS ee TE eee 151 RAP ose eg tk a Bee es Oe SS a S oe E ae Be ee G 151 o 2 65 64 44 te bee bn Aa ee EES SEA SESE ESS I 152 EPA AAA SA Se ane Se oe ae ee Sd OE de oe ee E S 152 Oe DAD apostado ec ey eee OG ne ee ee 153 Giza PostGIS gt so ek aid hae a oe Se ee ne oe ok eS a a ee ei 153 a29 EN oe ee eee ee ee eee ee ee ee oy Oe ee Se 154 G 2 10 CMake ue Sn Bh ee cy es EA hey in Sh er 154 63 Building QGIS with GMAKE 4 2 0 0 aed ce ooo ew be hele eh we es 154 H Building under Windows using MSVC Express 155 H 1 Syst m preparat0 e be ed ee a a ae BSR eee oe ee Sew 2 155 H 2 Install the libraries archive Sa ew Be Soa REESE SER OE HE 155 H 3 Install Visual Studio Express 2005 2000000000000 156 H 4 Install Microsoft Platform SOKA sis sd oroe A A GG ee we aH a 156 H 5 Edit yo r USVATS cs 68 eee PRE etad AA A Bes 159 he Environment Variables 2 eis s pop os AA Ae we OP ee bw Boe E 161 A Z Install CMake scms soe a r D oE oe RR e A RR RR A A 164 H 8 Install Subversi Misses s s i a rs ade God a Bw e Gee re E hw eee R 164 H 9 In
78. WMS server you can view its properties by right clicking on it in the legend and selecting Properties Metadata Tab The Metadata tab displays a wealth of information about the WMS server generally collected from the Capabilities statement returned from that server Many definitions can be gleaned by reading the WMS standards 5 6 but here are a few handy definitions QGIS 0 9 1 User and Installation Guide 54 6 2 WMS Client e Server Properties WMS Version The WMS version supported by the server Image Formats The list of MIME types the server can respond with when drawing the map QGIS supports whatever formats the underlying Qt libraries were built with which is typically at least image png and image jpeg Identity Formats The list of MIME types the server can respond with when you use the Identify tool Currently QGIS supports the text plain type e Layer Properties Selected Whether or not this layer was selected when its server was added to this project Visible Whether or not this layer is selected as visible in the legend Not yet used in this version of QGIS Can Identify Whether or not this layer will return any results when the Identify tool is used on it Can be Transparent Whether or not this layer can be rendered with transparency This version of QGIS will always use transparency if this is Yes and the image encoding sup ports transparenc
79. abeling 7 Choose the field to label with We ll use NAMES 8 Enter a default for lakes that have no name The default label will be used each time QGIS encounters a lake with no value in the NAMES field QGIS 0 9 1 User and Installation Guide 30 4 3 The Vector Properties Dialog 9 Click Apply Now we have labels How do they look They are probably too big and poorly placed in relation to the marker symbol for the lakes Click on the Font Style tab and use the Font and Colour buttons to set the font and color To change the position of the font relative to the feature 1 Click on the Font Alignment tab 2 Change the placement by selecting one of the radio buttons in the Placement group To fix our labels choose the Right radio button 3 Click Apply to see your changes without closing the dialog Things are looking better but the label is still too close to the marker To fix this we can use the options on the Position tab Here we can add offsets for the X and Y directions Adding an X offset of 5 will move our labels off the marker and make them more readable Of course if your marker symbol or font is larger more of an offset will be required The last adjustment we ll make is to buffer the labels This just means putting a backdrop around them to make them stand out better To buffer the lakes labels 1 Click the Buffer tab 2 Click the Buffer Labels checkbox to e
80. and PostGIS layers For example if you have a towns layer with a population field you could select only larger towns by entering population gt 100000 in the SQL box of the query builder Figure 9 shows an example of the query builder populated with data from a PostGIS layer with attributes stored in PostgreSQL Figure 9 Query Builder Search query Pader PERIMETER DESCRIPTIO 584632 688 22075 na Sample LIKE NOTIN Lact cs SQL where clause AREA lt 7196233 5 The query builder lists the layer s database fields in the list box on the left You can get a sample of the data contained in the highlighted field by clicking on the Sample button This retrieves the first 25 distinct values for the field from the database To get a list of all possible values for a field click on the All button To add a selected field or value to the query double click on it You can use the various buttons to construct the query or you can just type it into the SQL box To test a query click on the Test button This will return a count of the number of records that will be included in the layer When satisfied with the query click Ok The SQL for the where clause will be QGIS 0 9 1 User and Installation Guide 42 4 5 Query Builder shown in the SQL column of the layer list Tip 18 CHANGING THE LAYER DEFINITION You can chan
81. anslate o o gdal_translate exe L usr local lib lpng lz lgdal gt s gdaladdo o o gdaladdo exe L usr local lib lpng lz lgdal gt s gdalwarp o o gdalwarp exe L usr local lib lpng lz lgdal g s gdal_contour o o gdal_contour exe L usr local lib lpng lz lgdal gt s gdaltindex o o gdaltindex exe L usr local lib lpng lz lgdal gt s gdal_rasterize o o gdal_rasterize exe L usr local lib lpng lz lgdal install gdalinfo exe gdal_translate exe gdaladdo exe gdalwarp exe QGIS 0 9 1 User and Installation Guide 144 F 2 Installing dependencies gdal_contour exe gdaltindex exe gdal_rasterize exe usr local bin Finally manually edit gdal config in c msys local bin to replace the static library reference with lgdal CONFIG_LIBS L usr local lib lpng lz lgdal GDAL build procedure can be greatly simplified to use libtool with a libtool line patch con figure gdal as below configure with ngpython with xerces local with jasper local with grass local grass 6 3 cvs with pg local pgsql bin pg_config exe Then fix libtool with mv libtool libtool orig cat libtool orig sed s max_cmd_len 8192 max_cmd_ len 32768 g gt libtool Libtool on windows assumes a line length limit of 8192 for some reason and tries to page the linking and fails miserably This is a work around Make and make install should be hassle free after this F 2 3 GRASS Grab sources from CVS or use a weekly snaps
82. ap tolerance choose Project Properties from the Settings menu and click on the Gen eral tab Remember the tolerance is in map units For our little digitizing project the units are in decimal degrees Your results may vary but something on the order of 0 05 to 0 1 should be fine 4 4 2 Editing an Existing Layer By default QGIS loads layers read only This is a safeguard to avoid accidentally editing a layer if there is a slip of the mouse However you can choose to edit any layer as long as the data provider supports it and the underlying data source is writable i e its files are not read only Layer editing is most versatile when used on PostgreSQL PostGIS data sources Tip 9 DATA INTEGRITY Please consider backing up your data source before you start editing and also at regular intervals during editing QGIS is still at a pre version 1 0 stage and so may not be able to protect your data in all situations All editing sessions start by choosing the Allow editing option This can be found in the context menu after right clicking on the legend entry for that layer Alternately you can use the E Toggle editing button from the toolbar to start of stop the editing mode Tip 10 EDITING A MAP IS DIFFERENT TO EDITING AN ATTRIBUTE TABLE In this version of QGIS the Start editing Stop editing couplet on the map view acts separately to the Start Editing Stop Editing couplet on the attribute table QGIS 0 9 1 User and Ins
83. apCanvasLayer layer 118 layers cl 119 self canvas setLayerSet layers In the addLayer method we use a QFileDialog to get the name of the shapefile to load This is done in line 96 Notice that we specify a filter so the dialog will only show files of type shp Next in line 97 we create a QFilelnfo object from the shapefile path Now the layer is ready to be created in line 100 Using the QFilelnfo object to get the file name from the path we specify it for the name of the layer when it is created To make sure that the layer is valid and won t cause any problems when loading we check it in line 102 If it s bad we bail out and don t add it to the map canvas Normally layers are added with a random color Here we want to tweak the colors for the layer to make a more pleasing display Plus we know we are going to add the world_borders layer to the map and this will make it look nice on our blue background To change the color we need to get the symbol used for rendering and use it to set a new fill color This is done in lines 106 through 108 All that s left is to actually add the layer to the registry and a few other housekeeping items lines 111 through 119 This stuff is standard for adding a layer and the end result is the world borders on a light blue background The only thing you may not want to do is set the extent to the layer if you are going to be adding more than one layer in your application QGIS 0 9 1 U
84. apServer Map Files 75 9 1 Creating the Project File 2 cisco e de E e e 75 9 2 Creating the Map File 2 63 24 ds pi da oes ri as da 75 9 3 Testing Me Map Filej si s sire up aa ad ne ae RR e E ace ne da 78 QGIS 0 9 1 User and Installation Guide V Contents 10 Map Composer 79 16 7 Using Map COMPOSS ss s s se cs gpp he eR AAA 79 10 1 1 Adding a Map to the Composer 2 0000 eee ee ee 79 10 1 2 Adding other Elements to the COMpOSeM o o 81 10 1 3 Other Features sc E A A A ARR ERS 81 IC AZ Creating UIE sos s soenoe ae E AA 81 11 Using Plugins 83 1121 An Introduction to Using Plugins lt seas a i Boe a ee 83 11 1 1 Finding and Installing a Plugi 23i 22 2se c28be8 eee eee bee ee 83 11 1 2 M naging Pl giS e tok Se ae SG eh SAMS wae BE ak eB e 83 11 1 3 Data I A E A 84 11 1 4 Core Plugins 0 teen eee 84 taa BMWS als ws Soe See I ee nad 85 11 16 Pl gin templates isi iere toni i Sb SESS CEES OHS ee A A 86 11 2 Using ihe Decorations Plugins 6 2 45055 0806 54 ee bee PE ee ERG 87 11 2 1 Copyright Label
85. ard interchange format that can contain any number of waypoints routes and tracks in the same file B To load a GPX file you need to use the GPS Tools plugin When this plugin is loaded a button with a small handheld GPS device will show up in the toolbar the device looks a bit like a mobile phone Clicking on this button will open the GPS Tools dialog see figure 27 Figure 27 The GPS Tools dialog window GPST cols Load GPX file Import other file Download from GPS Upload to GPS GPX is the GPS eXchange file format which is used to store information about waypoints routes and tracks Select a GPX fide and than select the feature types that you want to load QGIS 0 9 1 User and Installation Guide 90 11 3 Using the GPS Plugin Use the browse button to select the GPX file then use the checkboxes to select the feature types you want to load from that GPX file Each feature type will be loaded in a separate layer when you click OK 11 3 3 GPSBabel Since QGIS uses GPX files you need a way to convert other GPS file formats to GPX This can be done for many formats using the free program GPSBabel which is available at http www gpsbabel org This program can also transfer GPS data between your computer and a GPS device QGIS uses GPSBabel to do these things so it is recommended that you install it How ever if you just want to load GPS data from GPX
86. aster Data 44 51 Whatisrasterdata cs acera ta aa a ias R 44 5 2 Raster formats supported in QGIS a o e a da E A ee ee ee ee 44 5 3 Loading raster data In OGIS a6 04 645 64 oe pat KERERE pE Oe ES 45 5 4 Raster Properties Dialog rte aye a OY rig a geese yer dh Gl ds Got ne aes Ghats oe 45 541 Symbol gy TAO sis e amp 5 428 a A Bae ee Seo Re A EA e i 47 5 4 2 General Tab sos ce Sees ak oS Me She we ok Ai WR AR Ee 48 5 4 3 Metadata Tab ee 48 5 44 Pyramids TADO ld a Bre o de e e a E a A ee i 48 5 45 Histogram Tab 3 30 9 Gasket A o Phe ae ee ea 49 QGIS 0 9 1 User and Installation Guide iv Contents 6 Working with OGC Data 50 6 1 Whatis OGC Dalal cor bs a se ee EEE AAA 50 AA pi oe encase ened apace ot EOE 50 6 2 1 Overview of WMS S ppori is s se s oe e a a ak 50 6 2 2 Selecting WMS Servers ee ee 51 6 2 3 Loading WMS Layers 4 osere ta os EA AAA 52 6 2 4 Using the Identify TOO gt gt o eres re nrp ee eG oe Se Sew oe EES 54 6 2 0 VIEWING Properties os ne aa ra A ee aa we eo 54 6 2 6 WMS Client Limitations 2 0000000000007 56 63 W
87. at when you open the cmd console Create build directory and set it as current directory cd c dev cpp qgis md build cd build C 9 Configuration cmakesetup NOTE You must include the above Click Configure button When asked you should choose MinGW Makefiles as generator There s a problem with MinGW Makefiles on Win2K If you re compiling on this platform use MSYS Makefiles generator instead All dependencies should be picked up automatically if you have set up the Paths correctly The only thing you need to change is the installation destination CMAKE_INSTALL_PREFIX and or set Debug QGIS 0 9 1 User and Installation Guide 129 C 10 Compilation and installation For compatibility with NSIS packaging cripts recommend to leave the install prefix to its default c program files When configuration is done click OK to exit the setup utility C 10 Compilation and installation make make install C 11 Run qgis exe from the directory where it s installed CMAKE_INSTALL_PREFIX Make sure to copy all dll s needed to the same directory as the qgis exe binary is installed to if not already done so otherwise QGIS will complain about missing libraries when started The best way to do this is to download both the QGIS current release installer package from http qgis org uploadfiles testbuilds and install it Now copy the installation dir from C Program Files Quantum G
88. ata Pyramids and Histogram Figure 11 Raster Layers Properties Dialog Symbology Display Color Image O Grayscale Image Paletted Image Notes _ Invert Color Map This image uses a fixed color palette You can remap these colors in different combinations e g Transparency e Red blue in image e Green blue in image e Blue green in image Grayscale Image Gray Std Deviations Color Map QGIS 0 9 1 User and Installation Guide 46 5 4 Raster Properties Dialog 5 4 1 Symbology Tab QGIS supports three forms of raster layers e Single Band Grayscale Rasters e Palette Based RGB Rasters e Multiband RGB Rasters From these three basic layer types eight forms of symbolised raster display can be used e Single Band Grayscale e Single Band Pseudocolor e Paletted Grayscale where only the red green or blue component of the image is displayed e Paletted Pseudocolor where only the red green or blue component of the image is displayed but using a pseudocolor algorithm e Paletted RGB e Multiband Grayscale using only one of the bands to display the image e Multiband Pseudocolor using only one of the bands shown in pseudocolor e Multiband RGB using any combination of three bands QGIS can invert the colors in a given layer so that light colors become dark and dark colors become light Use the Invert Color Map checkbox to enable disable this behavior QGIS has the ability to display each
89. atial data between different GIS imple mentations and data stores QGIS can now deal with three of the above specifications being SFS though support of the PostgreSQL PostGIS data provider see Section 4 2 WFS and WMS as a client 6 2 WMS Client 6 2 1 Overview of WMS Support 6 QGIS currently can act as a WMS client that understands WMS 1 1 1 1 1 and 1 3 servers It has particularly been tested against publicly accessible servers such as DEMIS and JPL OnEarth QGIS 0 9 1 User and Installation Guide 50 6 2 WMS Client WMS servers act upon requests by the client e g QGIS for a raster map with a given extent set of layers symbolisation style and transparency The WMS server then consults its local data sources rasterizes the map and sends it back to the client in a raster format For QGIS this would typically be JPEG or PNG WMS is generically a REST Representational State Transfer service rather than a fully blown Web Service As such you can actually take the URLs generated by QGIS and use them in a web browser to retrieve the same images that QGIS uses internally This can be useful when troubleshooting problems as there are several brands of WMS servers in the market and they all have their own interpretation of the WMS standard WMS layers can be added quite simply as long as you know the URL to access the WMS server you have a serviceable connection to that server and the server understands HTTP as the
90. ating the GUI Normally we would use the same tool that C developers use to create a GUI Qt Designer This is a visual design tool that allows you to create dialog and main windows by dragging and dropping widgets and defining their properties To design our NewLayer plugin we could get quite fancy and include widgets for field types and other options However since our time is limited we ll use another means to collect the information we need to create the table This will illustrate the concepts and then you can venture further using the tutorials on the QGIS blog To collect the user input we ll use the Q nputDialog class from the Qt library This prompts the user for a single line of input While it will make our plugin a little crude it serves to illustrate the concepts All we need to write now is the Python code to collect the input and create the table 11 7 5 Creating the Plugin Now that we have the preliminaries out of the way we can get down to writing the code that does the actual work Let s start by looking at the things we need to import and the initialization of the plugin in newlayer py Import the PyQt and QGIS libraries from PyQt4 QtCore import from PyQt4 QtGui import from qgis core import 1 2 3 4 5 import psycopg 6 Initialize Qt resources from file resources py 7 import resources 8 9 Our main class for the plugin 10 class NewLayer 11 12 def __init__ self iface 13 Save
91. ble If you have done this change back to Next not used and start digitizing the centroids which hold the attribute information of a polygon QGIS 0 9 1 User and Installation Guide 74 9 Making MapServer Map Files QGIS can be used to create map files for MapServer You use QGIS to compose your map by adding and arranging layers symbolizing them and customizing the colors In order to use the MapServer exporter you must have Python on your system and QGIS must have been compiled with support for it 9 1 Creating the Project File To create a MapServer map file 1 Add your layers to QGIS 2 Symbolize your layers setting the renderer and colors 3 Arrange the layers in the order you want them to appear in MapServer 4 Save your work to a QGIS project file This gets us to the point where we are ready to create the map file Tip 33 MAPSERVER EXPORT REQUIRES A QGIS PROJECT FILE This has been a source of confusion for a number of people The MapServer export tool operates on a saved QGIS project file not the current contents of the map canvas and legend When using the tool you need to specify a QGIS project file as input 9 2 Creating the Map File The exporter tool msexport is installed in your QGIS binary directory and can be used independently of QGIS From QGIS you can start the exporter by choosing Export to MapServer Map from the File menu Here is a summary of the input fields Map file Ente
92. blue type data type kveb 32 output bluemarble_ng options rast rast3d vect oldvect asciivect icon Labs region region3d group 3dview mapset mapset to list default current search path Where type is one of rast raster fies rast3d raster3D files vect binary vector files a GRASS browser inside the toolbox b GRASS shell inside the toolbox 8 7 3 Customizing the modules section Nearly all GRASS modules can be adopted to the GRASS toolbox A XML interface is provided to parse the very simple XML files which configure the modules inside the toolbox A brief description of adding new modules changing the modules group etc can be found on the QGIS wiki at http wiki qgis org qgiswiki Adding_New_Tools_to_the_GRASS_Toolbox A sample XML file for generating the module v buffer v buffer qgm looks like this lt xml version 1 0 encoding UTF 8 gt QGIS 0 9 1 User and Installation Guide 72 8 8 Creating anew GRASS layer lt DOCTYPE qgisgrassmodule SYSTEM http mrcc com qgisgrassmodule dtd gt lt qgisgrassmodule label Vector buffer module v buffer gt lt option key input typeoption type layeroption layer gt lt option key buffer gt lt option key output gt lt qgisgrassmodule gt Figure 19 Module generated through parsing the XML file GRASS Tools spearfish60 holl AE Modules Browser O
93. cations are also available but the existence of geospatially fo cused hardware and software is nothing new Global positioning system GPS receivers are be coming commonplace but have been used in various industries for more than a decade Likewise desktop mapping and analysis tools have also been a major commercial market primarily focused on industries such as natural resource management What is new is how the latest hardware and software is being applied and who is applying it Tra ditional users of mapping and analysis tools were highly trained GIS Analysts or digital mapping technicians trained to use CAD like tools Now the processing capabilities of home PC s and open source software packages have enabled an army of hobbyists professionals web developers etc to interact with geospatial data The learning curve has come down The costs have come down The amount of geospatial technology saturation has increased How is geospatial data stored In a nutshell there are two types of geospatial data in widespread use today This is in additional to traditional tabular data that is also widely used by geospatial applications 2 1 1 Raster Data One type of geospatial data is called raster data or simply a raster The most easily recognised form of raster data is digital satellite imagery or air photos Elevation shading or digital elevation models are also typically represented as raster data Any type of map feature can be represe
94. ction 1 above provided that you also meet all of these conditions a You must cause the modified files to carry prominent notices stating that you changed the files and the date of any change b You must cause any work that you distribute or publish that in whole or in part contains or is derived from the Program or any part thereof to be licensed as a whole at no charge to all third parties under the terms of this License c If the modified program normally reads commands interactively when run you must cause it when started running for such interactive use in the most ordinary way to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty or else saying that you provide a warranty and that users may redistribute the program under these conditions and telling the user how to view a copy of this License Exception if the Program itself is interactive but does not normally print such an announcement your work based on the Program is not required to print an announcement These requirements apply to the modified work as a whole If identifiable sections of that work are not derived from the Program and can be reasonably considered independent and separate works in themselves then this License and its terms do not apply to those sections when you distribute them as separate works But when you distribute the same sections as part of a whole which is a work based on the Program
95. ctor layers digitizing e Na Open existing mapset e Na Create new GRASS mapset T Create new GRASS vector layer e Q Close GRASS mapset 8 1 Starting QGIS with GRASS To use GRASS features from within QGIS you must load the GRASS plugin with the plugin manager see Section 11 1 2 just like all QGIS plugins After you load it a new toolbar will appear on the user interface After loading the plugin you can immediately load an existing GRASS dataset using the appropriate toolbar buttons for vector and raster data see Section 8 2 or you can create a new GRASS location with QGIS see Section 8 3 The GRASS plugin is unique in that it creates its own toolbar QGIS 0 9 1 User and Installation Guide 63 8 2 Loading GRASS Data 8 2 Loading GRASS Data With the GRASS plugin you can load vector or raster layer using the appropriate button on the toolbar As an example we use the spearfish sample location in UTM projection see Section 3 2 1 Download the spearfish_grass60data 0 3 zip file 2 Create a new folder grassdata and unzip the spearfish_grass60data 0 3 zip into it 3 Start QGIS 4 In the GRASS toolbar click on the Open mapset icon to bring up the Select GRASS mapset wizard 5 For Gisdbase browse and enter the path to the newly created folder grassdata 6 You should now be able to select the location spearfish60 and the mapset PERMANENT or usert 7 Click OK Notice that some of the
96. d into PostgreSQL using a number of methods PostGIS includes a utility called shp2pgsq that can be used to import shapefiles into a PostGIS enabled database For example to import a shapefile named lakes into a PostgreSQL database named gis_data use the following command shp2pgsql s 2964 lakes shp lakes_new psql gis_data This creates a new layer named lakes_new in the the gis_data database The new layer will have a spatial reference identifier SRID of 2964 See Section 7 for more information on spatial reference systems and projections Tip 7 EXPORTING DATASETS FROM POSTGIS Like the import tool shp2pgsq there is also a tool to export PostGIS datasets into shapefiles pgsql2shp This is shipped within your PostGIS distribution QGIS 0 9 1 User and Installation Guide 26 4 2 PostGIS Layers SPIT Plugin re QGIS comes with a plugin named SPIT Shapefile to PostGIS Import Tool SPIT can be used to load multiple shapefiles at one time and includes support for schemas To use SPIT open the Plugin Manager from the Tools menu and load the plugin by checking the box next to the SPIT plugin and click Ok The SPIT icon will be added to the plugin toolbar To import a shapefile click on the SPIT tool in the toolbar to open the dialog You can add one or more files to the queue by clicking on the Add button To process the files click on the Import button The progress of the import as well as any errors warnings w
97. d several times compared to earlier QGIS versions Project files from older QGIS versions may not work properly anymore 3 8 GUI Options lt Q Some basic options for QGIS can be selected using the Options dialog Select the Settings entry from the menu and choose Options Alt O The tabs where you can optmize your options are General Tab e ask to save project changes when required Appearance Tab e Hide or show splash screen at startup e Change the icon theme e Change Selection and backgroud Color e Make layer names appear with Capitals Rendering Tab e Update features during drawing or not until all features have been read e Set new layer visible or unvisible when loaded e Make lines appear less jagged at the expense of some drawing performance e Fix problems with incorrectly filled polygons e Continously redraw when dragging the legend map divider QGIS 0 9 1 User and Installation Guide 18 3 8 GUI Options Map tools Tab e Define Search Radius as a percentage of the map width e Define Ellipsoid for distance calculations e Set Rubberband Color for Measure Tool e Define Mouse wheel action Zoom Zoom and recenter Nothing e Set Zoom factor for wheel mouse Projection Tab e Define what to do when a layer is loaded without projection information Prompt for projection Project wide default projection will be used Global default projection displayed below will be used Locale Tab e Overwrite system loca
98. data transport mechanism 6 2 2 Selecting WMS Servers The first time you use the WMS feature there are no servers defined You can begin by clicking the Add WMS layer button inside the toolbar or through the Layer menu The dialog for adding layers from the WMS server pops up Fortunately you can add some servers to play with by clicking the Add default servers button This will add at least three WMS servers for you to use including the NASA JPL WMS server To define a new WMS server in the Server Connections section select New Then enter in the parameters to connect to your desired WMS server as listed in table 2 Table 2 WMS Connection Parameters Name A name for this connection This name will be used in the Server Connec tions drop down box so that you can distinguish it from other WMS Servers URL URL of the server providing the data This must be a resolvable host name the same format as you would use to open a telnet connection or ping a host Proxy Host Network address or host name of the proxy server you would use to access this WMS server or leave blank if no proxy is needed Proxy Port Port number of the proxy server Proxy User User name used to login to the proxy server Proxy Password Password used to login to the proxy server At least Name and URL are required entries the proxy entries can be left blank if you have a clear path to your WMS server Once the new WMS Server
99. de 44 5 3 Loading raster data in QGIS 5 3 Loading raster data in QGIS E Ey Raster layers are loaded either by clicking on the Load Raster icon or by selecting the View gt Add Raster Layer menu option More than one layer can be loaded at the same time by holding down the Control key and clicking on multiple items in the file dialog Please refer to section 5 4 Raster Properties Dialog 8 2 if you intend to load GRASS rasterdata To view and set the properties for a raster layer right click on the layer name This displays the raster layer context menu that includes a number of items that allow you to Figure 10 Raster context menu Zoom to layer extent Zoom to best scale 100 Show in overview x Remove Properties Rename Add group a Expand all a Collapse all Show file groups e Zoom to the full extent of the raster e Zoom to the best scale of the raster e Show the raster in the map overview window e Remove the layer from the map e Open the raster layers properties e Rename the layer e Add a layer group e Expand legend tree view QGIS 0 9 1 User and Installation Guide 45 5 4 Raster Properties Dialog e Collapse legend tree view e Show file groups Choose Properties from the context menu to open the raster properties dialog for the layer Figure 111 shows the properties dialog There are five tabs on the dialog Symbology General Metad
100. des information about the database table for a given layer Here you can add modify or create new database tables for the current layer Tip 31 GRASS EDIT PERMISSIONS You must be the owner of the GRASS mapset you want to edit It is impossible to edit vectors in mapsets which are not yours even if you have write permissions 8 6 Region Tool Bi The current region window in GRASS is very important for all raster modules All newly created rasters have the extension and resolution of the current region regardless of their original region The region is stored in LOCATION MAPSET WIND file and it defines north south east west number of columns number of rows horizontal and vertical spatial resolution Itis possible to switch on off the GRASS region in the QGIS canvas using the Display Current GRASS Region button QGIS 0 9 1 User and Installation Guide 69 8 7 GRASS Toolbox With the Edit Current GRASS Region you can open a tool in which you can change the current region and symbology of the GRASS region rectangle on the QGIS canvas When the tool is running it is also possible to select a new region interactively with your mouse on the QGIS canvas 8 7 GRASS Toolbox aR The GRASS toolbox provides analytic functions from GRASS within QGIS To use the GRASS toolbox you need to have opened a mapset where you have write permission This is needed be cause QGIS will most probably create new datasets which need to be
101. dinates 3 9 3 Zooming to a Bookmark From the Bookmarks dialog select the desired bookmark by clicking on it then click the Zoom To button You can also zoom to a bookmark by double clicking on it 3 9 4 Deleting a Bookmark To delete a bookmark from the Bookmarks dialog click on it then click the Delete button Confirm your choice by clicking Yes or cancel the delete by clicking No QGIS 0 9 1 User and Installation Guide 20 4 Working with Vector Data QGIS supports vector data in a number of formats including those supported by the OGR library data provider plugin such as ESRI shapefiles MapInfo MIF interchange format and MapInfo TAB native format QGIS also supports PostGIS layers in a PostgreSQL database using the PostgreSQL data provider plugin Support for additional data types eg delimited text is provided by additional data provider plugins This section describes how to work with two common formats ESRI shapefiles and PostGIS layers Many of the features available in QGIS work the same regardless of the vector data source This is by design and includes the identify select labeling and attributes functions Working with GRASS vector data is described in Section 8 4 1 ESRI Shapefiles ESRI Shapefile support is provided by a library of functions known as the OGR Simple Feature Library http www gdal org ogr See Appendix A 1 for a list of all supported formats in OGR A shap
102. e are creating a minimalistic application we ll take the same approach with the GUI Using Qt Designer we create a simple MainWindow with no menu or toolbars This gives us a blank slate to work with To create the MainWindow 1 Create a directory for developing the application and change to it 2 Run Qt Designer 3 The New Form dialog should appear If it doesn t choose New Form from the File menu 4 Choose Main Window from the templates forms list 5 Click Create 6 Resize the new window to something manageable An application created using Python and the QGIS bindings QGIS 0 9 1 User and Installation Guide 110 12 2 Creating the MainWindow 7 Find the Frame widget in the list under Containers and drag it to the main window you just created 8 Click outside the frame to select the main window area 9 Click on the Lay Out in a Grid tool When you do the frame will expand to fill your entire main window 10 Save the form as mainwindow ui 11 Exit Qt Designer Now compile the form using the PyQt interface compiler pyuic4 o mainwindow_ui py mainwindow ui This creates the Python source for the main window GUI Next we need to create the application code to fill the blank slate with some tools we can use 12 2 Creating the MainWindow Now we are ready to write the MainWindow class that will do the real work Since it takes up quite a few lines we ll look at it in chunks starting with the import
103. e iface as a member variable so we can use it later In lines 16 through 24 we initialize the GUI elements for the plugin In Qt a QAction is used to create a user interface action that can be used to create both a menu and toolbar item In our plugin we use it for both In line 18 we create the action using our icon resource note the prefix we specified in resources qrc We also provide some text that will appear when it is used in a menu or during a mouseover and lastly we need to specify the parent In a plugin the parent is the main window of QGIS The iface object that we stored during initialization allows us to get the reference to the main window in line 19 Once the action is created we can add it to both the toolbar and the Plugins menu lines 23 and 24 That takes care of initializing the GUI for the plugin The other thing we need to do is clean up after ourself when the plugin is unloaded The unload method takes care of this by removing the menu item and the tool from the toolbar lines 28 and 29 This takes care of the initialization stuff and getting our plugin to load and unload nicely Now let s look at the code that does the actual work It s all contained in the run method 30 def run self QGIS 0 9 1 User and Installation Guide 105 11 7 Using the Python Plugin 31 Get the user input starting with the table name 32 table_name QInputDialog getText None Table Name 33 Name for new PostGI
104. e met Now update your local sources database sudo apt get update QGIS 0 9 1 User and Installation Guide 137 E 3 Install Qt4 E 3 Install Qt4 sudo apt get install libqt4 core libqt4 debug A libqt4 dev libqt4 gui libqt4 qt3support libqt4 sql 1sb qt4 qt4 designer qt4 dev tools qt4 doc qt4 qtconfig uim qt gcc libapt pkg perl resolvconf A Special Note If you are following this set of instructions on a system where you already have Qt3 development tools installed there will be a conflict between Qt3 tools and Qt4 tools For example qmake will point to the Qt3 version not the Qt4 Ubuntu Qt4 and Qt3 packages are designed to live alongside each other This means that for example if you have them both installed you will have three qmake exe s usr bin qmake gt etc alternatives qmake usr bin qmake qt3 usr bin qmake qt4 The same applies to all other Qt binaries You will notice above that the canonical qmake is managed by apt alternatives so before we start to build QGIS we need to make Qt4 the default To return Qt3 to default later you can use this same process You can use apt alternatives to correct this so that the Qt4 version of applications is used in all cases sudo update alternatives config qmake sudo update alternatives config uic sudo update alternatives config designer sudo update alternatives config assistant sudo update alternatives config qtconfig sudo update alternatives confi
105. e replaced by the value of the selected field in the identify results or attribute table Using Actions Actions can be invoked from either the dentify Results dialog or the Attribute table dialog To invoke an action right click on the record and choose the action from the popup menu Actions are listed in the popup menu by the name you assigned when defining the actions Click on the action you wish to invoke QGIS 0 9 1 User and Installation Guide 32 4 3 The Vector Properties Dialog If you are invoking an action that uses the notation right click on the field value in the dentify Results dialog or the Attribute table that you wish to pass to the application or script Here is another example that pulls data out of a vector layer and inserts it into a file using bash and the echo command so it will only work on GNU Linux and perhaps Mac OS X The layer in question has fields for a species name taxon_name latitude lat and longitude long would like to be able to make a spatial selection of a localities and export these field values to a text file for the selected record shown in yellow in the QGIS map area Here is the action to achieve this bash c echo taxon_name flat Z long gt gt tmp species_localities txt After selecting a few localities and running the action on each one opening the output file will show something like this Acacia mearnsii 34 0800000000 150 0800000000 Acacia mearnsii 34
106. e view on the map canvas by zooming or panning you can update the map composer view by selecting the map in composer and clicking on the Set Extent button You can also change the composer view by specifying a map scale To set the view to a specific scale QGIS 0 9 1 User and Installation Guide 79 10 1 Using Map Composer Figure 21 Map Composer MainWindow lt galileo gt ad us o RNRALNOBO Resolution dpi 1 Choose Scale calculate extent from the Set drop down box 2 Enter the scale denominator in the scale box 3 Press Enter QGIS 0 9 1 User and Installation Guide 80 10 1 Using Map Composer 10 1 2 Adding other Elements to the Composer E Already existing QGIS templates can be used to easily load and adapt map layouts To open an existing template click on the Open Template button Choose a template and customize its appearance To adda logo north arrow or any kind of image to the composer click on the Add Image button The image will be placed on the composer canvas and you can move it where you like e A legend can be added to the composer canvas and customized to show only the desired layers To add a legend click on the Add Vector Legend button The legend will be placed on the composer canvas and you can move it where you like Click on the Items tab to customize the appearance of the legena including which layers are shown E To add a scalebar to the composer click on the
107. ed for software interchange or c Accompany it with the information you received as to the offer to distribute corresponding source code This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form with such an offer in accord with Subsection b above The source code for a work means the preferred form of the work for making modifications to it For an exe cutable work complete source code means all the source code for all modules it contains plus any associated interface definition files plus the scripts used to control compilation and installation of the executable However as a special exception the source code distributed need not include anything that is normally distributed in either source or binary form with the major components compiler kernel and so on of the operating system on which the executable runs unless that component itself accompanies the executable If distribution of executable or object code is made by offering access to copy from a designated place then offering equivalent access to copy the source code from the same place counts as distribution of the source code even though third parties are not compelled to copy the source along with the object code 4 You may not copy modify sublicense or distribute the Program except as expressly provided under this License Any attempt otherwise to copy modify sublicense or distribute the Pro
108. ed plugin see the documentation included with the plugin 11 1 2 Managing Plugins Managing plugins consists of loading or unloading them from QGIS Loaded plugins are remem bered when you exit the application and restored the next time you run QGIS To manage plugins open the Plugin Manager from the Tools menu The Plugin Manager displays all the available plugins and their status loaded or unloaded Figure 23 shows the Plugin Manager dialog Typically all QGIS plugins are installed in the same location This location is shown in the Plugin Directory text field You can tell QGIS to load plugins from another location by specifying a different directory Tip 34 CRASHING PLUGINS If you find that QGIS crashes on startup a plugin may be at fault You can stop all plugins from loading by editing your stored settings file see 3 8 for location Locate the plugins settings and change all the plugin values to false to prevent them from loading For example to prevent the Delimited text plugin from loading the entry in HOME config QuantumGIS qgis conf on Linux should look like this Add Delimited Text Layer false Do this for each plugin in the Plugins section You can then start QGIS and add the plugins one at a time from the Plugin Manger to determine which is causing the problem QGIS 0 9 1 User and Installation Guide 83 11 1 An Introduction to Using Plugins Figure 23 Plugin Manager GS Pidg
109. ee Section Open Project see Section 3 3 Open Recent Projects see Section 3 7 Save Project see Section 3 7 Save Project As see Section Save as Image Print see Section 10 Exit e View Zoom Full Zoom To Selection Zoom To Layer Zoom Last Refresh Show Bookmarks New Bookmark Show most toolbars Hide most toolbars Toolbar Visibility e Layer Add a Vector Layer see Section 4 Add a Raster Layer see Section 5 Add a PostGIS Layer see Section 4 2 Add a WMS Layer see Section 6 2 Remove Layer Export to MapServer Map see Section New Vector Layer see Section 3 4 4 3 QGIS 0 9 1 User and Installation Guide 11 3 4 QGIS GUI In Overview Add All To Overview Remove All From Overview Hide All Layers Show All Layers e Settings Project Properties see Section 3 7 Custom Projection see Section 7 3 Options see Section 3 8 e Plugins Futher menu items are added by plugins as they are loaded Plugin Manager see Section 11 1 2 e Help Help Contents QGIS Homepage Check QGIS Version About 3 4 2 Toolbars The toolbars provide access to most of the sa
110. efile actually consists of a minimum of three files e shp file containing the feature geometries e dbf file containing the attributes in dBase format e shx index file Ideally it comes with another file with a prj suffix This describes the projection information for the shapefile There can be more files belonging to a shapefile dataset To have a closer look at this we recommend the technical specification for the shapefile format This can be found at http www esri com library whitepapers pdfs shapefile pdf 4 1 1 Loading a Shapefile 3 To load a shapefile start QGIS and click on the Add a vector layer toolbar button This same tool can be used to load any of the formats supported by the OGR library Clicking on the tool brings up a standard open file dialog see Figure 3 which allows you to navigate the file system and load a shapefile or other supported data source The selection box File of type allows you to preselect some OGR supported file formats QGIS 0 9 1 User and Installation Guide 21 4 1 ESRI Shapefiles You can also select the Encoding type for the shapefile if desired Figure 3 Open OGR Data Source Dialog at ca408 qgis_data alaska shp canada shp lakes shp majrivers shp russia shp File name alaska shp Files of type OGR ESRI Shapefiles shp SHP ra Cancel Encoding 1S0 8859 15 gt Selecting a shapefile from the list and clicking OK l
111. ems of note about the text file are 1 The example text file uses as delimiter Any character can be used to delimit the fields 2 The first row is the header row It contains the fields name latdec longdec and cell 3 No quotes are used to delimit text fields 4 The x coordinates are contained in the longdec field al The y coordinates are contained in the latdec field QGIS 0 9 1 User and Installation Guide 94 11 4 Using the Delimited Text Plugin 11 4 2 Using the Plugin To use the plugin you must have QGIS running and use the Plugin Manager to load the plugin Start QGIS then Open the Plugin Manager by choosing the Tools Plugin Manager menu The Plugin Manager displays a list of available plugins Plugins that are already loaded have a check mark to the left of their name Click on the checkbox to the left of the Add Delimited Text Layer plugin and click Ok to load it as described in Section 11 1 2 A new toolbar icon is now present ay Click on the icon to open the Delimited Text dialog as shown in Figure 30 Figure 30 Delimited Text Dialog Greate a Layer from a Delimited Text File Delimited Text Layer Description Select the file containing delimited text with latlon coordinates that you would like to use as a pointlayer a a a and this plugin will do the job for you a ae S Use the layer name box to specify the legend name for the new layer Use the deli
112. engeospatial org 2004 Index 32 actions 32 defining 32 examples 32 using 32 Allow Editing 35 bookmarks 20 command line options 8 coordinate reference system crashes 83 CRS 54 data sample 7 data providers 84 delimited text 21 editing 35 an existing copying features 39 layer 35 creating a new layer 41 cutting features 39 icons 35 pasting features 39 saving changes 41 snap 40 EPSG 59 ESRI shapefiles GDAL supported GRASS 63 attribute linkage 67 attribute storage 66 category settings 68 formats 123 digitizing 66 digitizing tools 67 68 E 174 display results 71 edit permissions 69 loading data 64 query builder 43 region 69 display 69 editing 70 snapping tolerance 69 starting QGIS 63 symbology settings 69 table editing 69 toolbox 70 Browser 71 customize 72 modules 70
113. eos Edit geos source makefile vc as follows Uncomment lines 333 and 334 to allow the copying of version h vc to version h Uncomment lines 338 and 339 Rename geos_c h vc to geos_c h in on lines 338 and 339 to allow the copying of geos_c h in to geos_c h Using the Visual Studio command prompt ensures the environment is setup properly run the fol lowing in the top level directory nmake f makefile vc QGIS 0 9 1 User and Installation Guide 152 G 2 Download Install Dependencies Run the following in top level directory setting GEOS_DIR as appropriate set GEOS_DIR c lib geos mkdir GEOS_DIR Xinclude mkdir GEOS_DIR Al1ib mkdir GEOS_DIR Abin xcopy S Y source headers h GEOS_DIR Xinclude copy Y capi h GEOS_DIR Xinclude copy Y source lib GEOS_DIR Alib copy Y source dll GEOS_DIR bin This can also be added to a batch file G 2 7 GDAL Get gdal from svn svn checkout https svn osgeo org gdal branches 1 4 gdal gdal Edit nmake opt to suit it s pretty well commented Using the Visual Studio command prompt ensures the environment is setup properly run the fol lowing in the top level directory nmake f makefile vc and nmake f makefile vc devinstall G 2 8 PostGIS Get PostGIS and the Windows version of PostgreSQL from here http postgis refractions net download Note the warning about not installing the version of PostGIS that comes
114. er with the vector editing capabilities of QGIS You can load a map create some waypoints and routes and then upload them and use them in your GPS device 11 3 7 Defining new device types There are lots of different types of GPS devices The QGIS developers can t test all of them so if you have one that does not work with any of the device types listed in the download and upload tools you can define your own device type for it You do this by using the GPS device editor which you start by clicking the Edit devices button in the download or the upload window To define a new device you simply click the New device button enter a name a download command and an upload command for your device and click the Update device button The name will be listed QGIS 0 9 1 User and Installation Guide 92 11 3 Using the GPS Plugin Figure 29 The download tool GPST cols Load GPX file Import other file Download from GPS Upload to GPS This tool will help you download data from a GPS device Choose your GPS device the port t is connected to the feature type you want to download a name for your new layer and the GPX file where you want to store the data If your device isn t listed or if you want to change some settings you can also edit the devices This toal uses the program GPSBabel http gosbabel sf net to transfer the data If you don t have GPSBabel installed where QGIS can find it this tool will not work
115. es make exceptions for this Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally NO WARRANTY 11 BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE THERE IS NO WARRANTY FOR THE PROGRAM TO THE EXTENT PERMITTED BY APPLICABLE LAW EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND OR OTHER PARTIES PROVIDE THE PROGRAM AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESSED OR IMPLIED INCLUDING BUT NOT LIM ITED TO THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PUR POSE THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU SHOULD THE PROGRAM PROVE DEFECTIVE YOU ASSUME THE COST OF ALL NECESSARY SERVIC ING REPAIR OR CORRECTION 12 INNO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER OR ANY OTHER PARTY WHO MAY MODIFY AND OR REDISTRIBUTE THE PRO QGIS 0 9 1 User and Installation Guide 170 GRAM AS PERMITTED ABOVE BE LIABLE TO YOU FOR DAMAGES INCLUDING ANY GENERAL SPE CIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED IN ACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILI
116. eveloped plugins They are not shipped with the default distribution However they can be compiled and used within QGIS Currently the external plugins are only available directly from SVN To check out all available external plugins do the following svn co https svn qgis org repos qgis trunk external_plugins external_qgis_plugins This will create a folder external_qgis_plugins in your current folder Each subdirectory has its own compile and install instructions Read them carefully in order to build the plugin QGIS 0 9 1 User and Installation Guide 85 11 1 An Introduction to Using Plugins 11 1 6 Plugin templates If you like to develop your own QGIS plugin the main sources include a nice script which guides you through the process of creating your own template directory structure within the QGIS source tree The script lives in QGIS src plugins plugin_builder pl The only thing to do is coding your functions into the plugin and of course contribute your plugin the the QGIS development team Beside that the QGIS wiki http wiki qgis org and the QGIS blog http blog qgis org provide useful articles about writing your own plugin as well Check the websites for details QGIS 0 9 1 User and Installation Guide 86 11 2 Using the Decorations Plugins 11 2 Using the Decorations Plugins The Decoration plugins include the following e Copyright Label Plugin e North Arrow Plugin e Scale Bar
117. evided into Core Features and Plugins Core Features e Raster and vector support by the OGR library e Support for spatially enabled PostgreSQL tables using PostGIS e GRASS integration including view edit and analysis e Digitizing GRASS and OGR Shapefile e Map Composer OGC support QGIS 0 9 1 User and Installation Guide 1 1 1 Features Overview panel Spatial bookmarks Identify Select features Edit View Search attributes Feature labeling On the fly projection Save and restore projects Export to Mapserver map file Change vector and raster symbology Extensible plugin architecture Plugins Add WFS Layer Add Delimited Text Layer Decorations Copyright Label North Arrow and Scale bar Georeferencer GPS Tools GRASS Graticule Creator PostgreSQL Geoprocessing functions SPIT Shapefile to PostgreSQL PostGIS Import Tool Python Console openModeller QGIS 0 9 1 User and Installation Guide 1 2 Whats New in 0 9 1 2 Whats New in 0 9 Version 0 9 0 brought some very interesting new features to you e Python language bindings to write plugins in Python and to create GIS enabled applications in Python that use the QGIS libraries e Removed automake build system QGIS now needs CMake for compilation e Many new GRASS modules added to the GRASS toolbox e Map Composer updates e Fix for 2 5D shapefiles e Improvements to the Georeferencer e Localization support extended to 26 languages QGIS 0 9
118. extent xmin ymin xmax ymax set initial map extent help this text FILES Files specified on the command line can include rasters QGIS 0 9 1 User and Installation Guide 8 3 4 QGIS GUI vectors and QGIS project files qgs 1 Rasters Supported formats include GeoTiff DEM and others supported by GDAL 2 Vectors Supported formats include ESRI Shapefiles and others supported by OGR and PostgreSQL layers using the PostGIS extension Tip 1 EXAMPLE USING COMMAND LINE ARGUMENTS You can start QGIS by specifying one or more data files on the command line For example assuming you are in your data directory you could start QGIS with two shapefiles and a raster file set to load on startup using the following command qgis ak_shade tif alaska shp majrivers shp Command line option snapshot This option allows you to create a snapshot in PNG format from the current view This comes in handy when you have a lot of projects and want to generate snapshots from your data Currently it generates a PNG file with 800x600 pixels A filename can be added after snapshot Command line option lang Based on your locale QGIS selects the correct localization If you like to change your language you can provide another language with this option Command line option project Starting QGIS with an existing project file is also possible Just add the command line option project followed by your project name and QGIS will open w
119. f the rest of this License 8 If the distribution and or use of the Program is restricted in certain countries either by patents or by copy righted interfaces the original copyright holder who places the Program under this License may add an explicit geographical distribution limitation excluding those countries so that distribution is permitted only in or among countries not thus excluded In such case this License incorporates the limitation as if written in the body of this License 9 The Free Software Foundation may publish revised and or new versions of the General Public License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns Each version is given a distinguishing version number If the Program specifies a version number of this License which applies to it and any later version you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation If the Program does not specify a version number of this License you may choose any version ever published by the Free Software Foundation 10 If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different write to the author to ask for permission For software which is copyrighted by the Free Software Foundation write to the Free Software Foundation we sometim
120. files you will not need it Version 1 2 3 of GPSBabel is known to work with QGIS but you should be able to use later versions without any problems 11 3 4 Importing GPS data To import GPS data from a file that is not a GPX file you use the tool mport other file in the GPS Tools dialog Here you select the file that you want to import which feature type you want to import from it where you want to store the converted GPX file and what the name of the new layer should be When you select the file to import you must also select the format of that file by using the menu in the file selection dialog see figure 28 All formats do not support all three feature types so for many formats you will only be able to choose between one or two types 11 3 5 Downloading GPS data from a device QGIS can use GPSBabel to download data from a GPS device directly into vector layers For this you use the tool Download from GPS see Figure 29 where you select your type of GPS device the port that it is connected to the feature type that you want to download the GPX file where the data should be stored and the name of the new layer The device type you select in the GPS device menu determines how GPSBabel tries to communicate with the device If none of the device types works with your GPS device you can create a new type see section 11 3 7 The port is a file name or some other name that your operating system uses as a reference to the ph
121. for users and developers as well You are invited to contribute to the blog after registering yourself QGIS 0 9 1 User and Installation Guide 120 13 5 Wiki 13 5 Wiki Lastly we maintain a WIKI web site at http wiki qgis org where you can find a variety of useful information relating to QGIS development release plans links to download sites message translation hints and so on Check it out there are some goodies inside QGIS 0 9 1 User and Installation Guide 121 A Supported Data Formats A 1 Supported OGR Formats At the date of this document the following formats are supported by the OGR library Formats known to work in QGIS are indicated in bold e Arc Info Binary Coverage e Comma Separated Value csv e DODS OPeNDAP e ESRI Shapefile e FMEObjects Gateway e GML e IHO S 57 ENC e Mapinfo File e Microstation DGN e OGDI Vectors e ODBC e Oracle Spatial e PostgreSQL e SDTS e SQLite e UK NTF e U S Census TIGER Line e VRT Virtual Datasource 7QGIS implements its own PostgreSQL functions OGR should be built without PostgreSQL support QGIS 0 9 1 User and Installation Guide 122 A 2 GDAL Raster Formats A 2 GDAL Raster Formats At the date of this document the following formats are supported by the GDAL library Note that not all of these format may work in QGIS for various reasons For example some require external commercial librarie
122. fore we begin Install XP I used a Parallels virtual machine Install the premade libraries archive have made for you Install Visual Studio Express 2005 sp1 Install the Microsoft Platform SDK Install command line subversion client Install library dependencies bundle Install Qt 4 3 2 Check out QGIS sources Compile QGIS Create setup exe installer for QGIS H 2 Install the libraries archive Half of the point of this section of the MSVC setup procedure is to make things as simple as possible for you To that end have prepared an archive that includes all dependencies needed to build QGIS except Qt which we will build further down Fetch the archive from http qgis org uploadfiles msvc qgis_msvc_deps_except_qt4 zip QGIS 0 9 1 User and Installation Guide 155 H 3 Install Visual Studio Express 2005 Create the following directory structure c dev cpp And then extract the libraries archive into a subdirectory of the above directory so that you end up with c dev cpp qgislibs release Note that you are not obliged to use this directory layout but you should adjust any instructions that follow if you plan to do things differently H 3 Install Visual Studio Express 2005 First thing we need to get is MSVC Express from here http msdn2 microsoft com en us express aa975050 aspx The page is really confusing so dont feel bad if you cant actually find the download at first There are si
123. g Map Composer To use the map composer first add the layers you want to print to QGIS The layers should be rendered and symbolized to your liking prior to composing the map Opening the map composer provides you with a blank canvas to which you can add the current map view legend scalebar and text Figure 21 shows the initial view of the map composer before any elements are added The map composer has two tabs General and Item The General tab allows you to set the paper size orientation and resolution for the map The tem tab displays the properties for the currently selected map element By selecting an element on the map eg legend scalebar text etc and clicking on the tem tab you can customize the settings You can add multiple elements to the composer This allows you to have more than one map view and legend in the composer Each element has its own properties and in the case of the map its own extent 10 1 1 Adding a Map to the Composer z To add the QGIS map canvas to the map composer click on the Add a new map button in toolbar Drag a rectangle on the composer canvas to add the map You can resize the map later by clicking on the Select move item button clicking on the map and dragging one of the handles in the corner of the map With the map selected you can also resize the map by specifying the width and height on the Item properties tab The map is linked to the QGIS map canvas If you change th
124. g moc sudo update alternatives config lupdate sudo update alternatives config lrelease sudo update alternatives config linguist Use the simple command line dialog that appears after running each of the above commands to select the Qt4 version of the relevant applications E 4 Install additional software dependencies required by QGIS sudo apt get install gdal bin libgdali dev libgeos dev proj libgdal doc libhdf4g dev libhdf4g run python dev libgs10 dev g libjasper 1 701 dev libtiff4 dev subversion QGIS 0 9 1 User and Installation Guide 138 E 5 GRASS Specific Steps libsqlite3 dev sqlite3 ccache make libpq dev flex bison cmake txt2tags python qt4 python qt4 dev python sip4 sip4 python sip4 dev Debian users should use libgdal dev above rather Note For python language bindings SIP gt 4 5 and PyQt4 gt 4 1 is required Some stable GNU Linux distributions e g Debian or SuSE only provide SIP lt 4 5 and PyQt4 lt 4 1 To include support for python language bindings you may need to build and install those packages from source E 5 GRASS Specific Steps Note If you don t need to build with GRASS support you can skip this section Now you can install grass from dapper sudo apt get install grass libgrass dev libgdali grass N You may need to explicitly state your grass version e g libgdal1 1 3 2 grass E 6 Setup ccache Optional You should also setup ccache to speed up compile ti
125. g with Raster Data QGIS supports a number of raster data formats This section describes how to work with raster data in QGIS 5 1 What is raster data Raster data in GIS are matrices of discrete cells that represent features on above or below the earth s surface Each cell in the raster grid is the same size and cells are usually rectangular in QGIS they will always be rectangular Typical raster datasets include remote sensing data such as aerial photography or satellite imagery and modelled data such as an elevation matrix Unlike vector data raster data typically do not have an associated database record for each cell In GIS a raster layer would have georeferencing data associated with it which will allow it to be positioned correctly in the map display to allow other vector and raster data to be overlaid with it QGIS makes use of georeferenced rasters to properly display the data 5 2 Raster formats supported in QGIS QGIS supports a number of different raster formats Currently tested formats include e Arc Info Binary Grid e Arc Info ASCII Grid e GRASS Raster e GeoTIFF e Spatial Data Transfer Standard Grids with some limitations e USGS ASCII DEM e Erdas Imagine Because the raster implementation in QGIS is based on the GDAL library other raster formats im plemented in GDAL are also likely to work but have not yet been tested See Appendix A 2 for more details QGIS 0 9 1 User and Installation Gui
126. ge the layer definition after it is loaded by altering the SQL query used to define the layer To do this open the vector layer properties dialog by double clicking on the layer in the legend and click on the Query Builder button on the General tab See Section 4 3 for more information 4 5 1 Query PostGIS layers To query a loaded PostGIS layer there are two options The first is to click on the button Open Table to open the attribute table of the PostGIS layer Then choose the Advanced button at the bottom This starts the Query Builder that allows to define a subset of a table and display it as described in Section 4 5 The second option to load a PostGIS layer is to open the Layer Properties dialog by double clicking on the PostGIS layer name in the legend or by right clicking and choosing Properties from the popup menu In the tab General click the Query Builder button at the bottom 4 5 2 Query OGR formats and GRASS files To query a loaded GRASS file or OGR supported format you currently need to click on the button Open Table to open the corresponding attribute table and choose the Advanced button This starts the Query Builder and allows to define a subset of a table and display it as described in Section 4 5 The second option to start the Query Builder as decribed in Section 4 5 1 is currently not supported for OGR and GRASS layers QGIS 0 9 1 User and Installation Guide 43 5 Workin
127. gram is void and will automat ically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 5 You are not required to accept this License since you have not signed it However nothing else grants you permission to modify or distribute the Program or its derivative works These actions are prohibited by law if you do not accept this License Therefore by modifying or distributing the Program or any work based on the Program you indicate your acceptance of this License to do so and all its terms and conditions for copying distributing or modifying the Program or works based on it 6 Each time you redistribute the Program or any work based on the Program the recipient automatically receives a license from the original licensor to copy distribute or modify the Program subject to these terms and conditions You may not impose any further restrictions on the recipients exercise of the rights granted herein You are not responsible for enforcing compliance by third parties to this License 7 If as a consequence of a court judgment or allegation of patent infringement or for any other reason not limited to patent issues conditions are imposed on you whether by court order agreement or otherwise that contradict the conditions of this License they do not excuse you from the conditi
128. haracters in it If we really want to make this plugin useful we would need to provide a way for the user to specify the type In line 36 we prompt the user to enter a comma delimited list of field names We then split this list into its components for use in constructing the SQL statement line 38 QGIS 0 9 1 User and Installation Guide 106 11 7 Using the Python Plugin Figure 39 Enter new PostGIS table name Table beige Name for new PostGIS layer park_land D lee Figure 40 Enter field names for new PostGIS table miali KELIS Fields separate with a comma name unit lt Line 40 contains the first part of the SQL statement Note we are creating the table with an integer id field that will be the primary key We then iterate through the field list appending the appropriate code to the SQL statement line 41 Once we have all the fields added to the SQL statement we chop off the trailing characters we don t want line 43 and then add the closing parenthesis to complete the statement line 44 Now we are ready to connect to the database and create the table To access the database we are using psycopg http www initd org In order to connect we need to specify the data source name DSN with the name of the database the user and a password if necessary If we are running both QGIS and PostgreSQL on the same machine we usually don t need to specify a password In this case the
129. he Canadian Land layer 11 Click Add to add the layer to the map 12 Wait patiently for the features to appear Figure 13 Adding a WFS layer le Ganymede i sisi xi Fle View Layer Settings Plugins Help Jagdas MARRAAQO PRENE AA V OLZPertHA2AQERR Pas EHHHUAAASHEUE Pat PPIM gt Legend 0 1e 06 f degrees man dey Hota inia oltielin poi SOISIGETEG sta NG EE Server Connections DM Solutions Y park drain_fn drainage You ll notice the download progress is visualized in the left bottom of the QGIS main window Once the layer is loaded you can identify and select a province or two and view the attribute table QGIS 2007 QGIS 0 9 1 User and Installation Guide 57 6 3 WES Client Remember this plugin is still experimental You might also experience random behavior and crashes You can look forward to improvements in a future version of the plugin Tip 26 FINDING WMS AND WFS SERVERS You can find additional WMS and WFS servers by using Google or your favorite search engine There are a number of lists some of them maintained and some not that list public servers you can use QGIS 0 9 1 User and Installation Guide 58 7 Working with Projections QGIS supports on the fly OTF projection of vector layers This feature allows you to display layers with different coordinate systems and have them overlay properly 7 1
130. he package currently includes QGIS 0 9 1 User and Installation Guide 142 F 2 Installing dependencies zlib 1 2 3 libpng 1 2 16 noconfig xdr 4 0 mingw2 freetype 2 3 4 fftw 2 1 5 PDCurses 3 1 proj 4 5 0 gdal 1 4 1 It s available for download here http www stjohnspoint co uk grass wingrass extralibs tar gz Moreover he also left the notes how to compile it for those interested http www stjohnspoint co uk grass README extralibs Unpack the whole package to c msys local F 2 2 GDAL level one Since Quantum GIS needs GDAL with GRASS support we need to compile GDAL from source Paul Kelly s package doesn t include GRASS support in GDAL The idea is following 1 2 3 compile GDAL without GRASS compile GRASS compile GDAL with GRASS So start with downloading GDAL sources http download osgeo org gdal gdal141 zip QGIS 0 9 1 User and Installation Guide 143 F 2 Installing dependencies Unpack it to some directory preferably c msys local src Start MSYS console go to gdal 1 4 1 directory and run the commands below You can put them all to a script e g build gdal sh and run them at once The recipe is taken from Paul Kelly s instructions basically they just make sure that the library will be created as DLL and the utility programs will be dynamically linked to it CFLAGS 02 s CXXFLAGS 02 s LDFLAGS s configure without libt
131. hen off no projection takes place and each layer is drawn using the coordinates as read from the data source When on the coordinates in each layer are projected to the coordinate system of the map canvas 2 Projections this is a list of all projection supported by QGIS including Geographic Projected and Custom coordinate systems To use a coordinate system select it from the list by expand ing the appropriate node and selecting the projection The active projection is pre selected QGIS 0 9 1 User and Installation Guide 60 7 3 Custom Projections 3 Proj4 text this is the projection string used by the Proj4 projection engine This text is read only and provided for informational purposes 4 Search if you know the PostGIS EPSG QGIS SRSID identifier or the name for a projection you can use the search feature to find it Enter the identifier and click on Find 7 2 1 Specifying a Projection QGIS automatically sets the map projection to the coordinate system of the first layer loaded One way to specify the map projection is to first load a layer with the projection you want for the entire map Then open the Project Properties dialog and click on the Enable on the fly projection checkbox You can now close the Project Properties dialog and add additional layers to the map If you have already added layers and want to enable OTF projection open the Project Properties dia log and find the projection or geographic coord
132. his plugin will do the job for you Use the layer name box to specify the legend name for the new layer Use the delimeter box to specify what the delimeter is for your file e g space commar or tab ral Note this box accepts regex entries so use tfortab and lv enan Mershancina a E Delimited text file han gnis Layer name Geographic Names Delimiter e X field llongdec v Yfield latdec y Help Parse Add Layer Close Choose the X and Y fields from the drop down boxes and enter a Layer name as shown in Figure 83 To add the layer to the map click Add Layer The delimited text file now behaves as any other map layer in QGIS QGIS 0 9 1 User and Installation Guide 96 11 5 Using the Graticule Creator Plugin 11 5 Using the Graticule Creator Plugin The graticule creator allows to create a grid of points line or polygons to cover our area of interest All units must be entered in decimal degrees The output is a shapefile which can be projected on the fly to match your other data Figure 34 Create a graticule layer Graticule Builder This plugin will help you to build a graticule shapefile that you can use as an overlay within your qgis map viewer Please enter all units in decimal degrees Type Point Line Polygon Origin lower left Latitude 0 Longitude 0 End point upper right Latitude 1
133. hoose the type of layer point line or polygon Figure 8 Creating a New Vector Dialog Type Point Line O Polygon File Format ESRI Shapefile Attributes Add Remove Name Type 1D Integer name String Note that QGIS does not yet support creation of 2 5D features i e features with X Y Z coordinates or measure features At this time only shapefiles can be created In a future version of QGIS creation of any OGR or PostgreSQL layer type will be supported Creation of GRASS layers is supported within the GRASS plugin Please refer to section 8 8 for more information on creating GRASS vector layers To complete the creation of the new layer add the desired attributes by clicking on the Add button and specifying a name and type for the attribute Only real integer and string attributes are supported Once you are happy with the attributes click Ok and provide a name for the shapefile QGIS will automatically add a shp extension to the name you specify Once the layer has been created it will be added to the map and you can edit it in the same way as described in Section 4 4 2 above QGIS 0 9 1 User and Installation Guide 41 4 5 Query Builder 4 5 Query Builder The Query Builder allows you to define a subset of a table and display it as a layer in QGIS It can be used for all OGR supported formats GRASS files
134. hot see http grass itc it devel cvs php In MSYS console go to the directory where you ve unpacked or checked out sources e g c msys local src grass 6 3 cvs Run these commands export PATH usr local bin usr local lib PATH configure prefix usr local bindir usr local with includes usr local include with libs usr local lib with cxx without jpeg without tiff without postgres with opengl windows with fftw with freetype with freetype includes usr local include freetype2 without x without tcltk enable x11 no enable shared yes with proj share usr local share proj make make install QGIS 0 9 1 User and Installation Guide 145 F 2 Installing dependencies It should get installed to c msys local grass 6 3 cvs By the way these pages might be useful http grass gdf hannover de wiki WinGRASS_Current_Status http geni ath cx grass html F 2 4 GDAL level two At this stage we ll use GDAL sources we ve used before only the compilation will be a bit different But first in order to be able to compile GDAL sources with current GRASS CVS you need to patch them here s what you need to change http trac osgeo org gdal attachment ticket 1587 plugin_patch_grass63 diff you can patch it by hand or use patch exe in c msys bin Now in MSYS console go to the GDAL sources directory and run the same commands as in level one only with
135. iST index is GIST index information is taken from the PostGIS documentation available at http postgis refractions net QGIS 0 9 1 User and Installation Guide 27 4 3 The Vector Properties Dialog CREATE INDEX indexname ON tablename USING GIST geometryfield GIST_GEOMETRY_OPS Note that for large tables creating the index can take a long time Once the index is created you should perform a VACUUM ANALYZE See the PostGIS documentation 4 for more information The following is an example of creating a GiST index gsherman madison current psql gis_data Welcome to psql 8 0 0 the PostgreSQL interactive terminal Type copyright for distribution terms h for help with SQL commands for help with psql commands g or terminate with semicolon to execute query q to quit gis_data CREATE INDEX sidx_alaska_lakes ON alaska_lakes gis_data USING GIST the_geom GIST_GEOMETRY_OPS CREATE INDEX gis_data VACUUM ANALYZE alaska_lakes VACUUM gis_data q gsherman madison current 4 3 The Vector Properties Dialog The vector properties dialog provides information about a layer symbology settings and labeling options If your vector layer has been loaded from a PostgreSQL PostGIS datastore you can also alter the underlying SQL for the layer either by hand editing the SQL on the General tab or by invoking the query builder dialog on the General tab To access the properties dialog double
136. ids waiting while all the vertex markers are rendered across the entire layer Tip 14 VERTEX MARKERS This version of QGIS does not allow you to change the vertex markers used For lines and polygons keep on left clicking for each additional point you wish to capture When you have finished adding points right click anywhere on the map area to confirm you have finished entering the geometry of that feature The attribute window will appear allowing you to enter the information for the new feature Figure 7 shows setting attributes for a fictitious new river in Alaska Figure 7 Vector Digitizing Attributes Capture Dialog a e s Lo 1S x Y F Senin S15 9 9 0 Pr2 viewed Sanyinsds Ar24 12111 File View Layer Settings Plugins Help Jada So R2RReaoo MPREGBAAY BLO tsH AGO 949000900088 Ramee Ree Pat AAA wey oO Legend 200000 degrees g 0 36 p test 2 E Files O a al aa AREA 71968 530 277486057573 225 277486057573 225 554972043179 919 554072043179 919 832459028786 612 832458028796 612 1109944014393 306 4109944014393 306 1387430000000 001 E Fies e WI assa vg Attribute Value p 1D 1 2 Name river gt A ih oK Cancel oe OQGIS 2007 Scate r ssoeszoz3esz 10725 1377505 E Render E QGIS 0 9 1 User and Installation Guide 37 4 4 Editing Tip 15 ATTR
137. ile group into another one If this is done the symbologies are grouped Note that QGIS only permits the drag if the two layers are able to share symbology same vector type and same attributes 3 4 4 Map View This is the business end of QGIS maps are displayed in this area The map displayed in this window will depend on the vector and raster layers you have chosen to load see sections that follow for more information on how to load layers The map view can be panned shifting the focus of the map display to another region and zoomed in and out Various other operations can be performed on the map as described in the toolbar description above The map view and the legend are tightly bound to each other the maps in view reflect changes you make in the legend area Tip 3 ZOOMING THE MAP WITH THE MOUSE WHEEL You can use the mouse wheel to zoom in and out on the map Place the mouse cursor inside the map area and roll it forward away from you to zoom in and backwards towards you to zoom out The mouse cursor is the center where the zoom occurs You can customize the behavior of the mouse wheel zoom using the Map tools tab under the Settings Options menu 3 4 5 Map Overview The map overview area provides a full extent view of layers added to it Within the view is a rectangle showing the current map extent This allows you to quickly determine which area of the map you are currently viewing Note that labels are not rendered
138. ill be displayed as each shapefile is processed Tip 8 IMPORTING SHAPEFILES CONTAINING POSTGRESQL RESERVED WORDS If a shapefile is added to the queue containing fields that are reserved words in the PostgreSQL database a dialog will popup showing the status of each field You can edit the field names prior to import and change any that are reserved words or change any other field names as desired Attempting to import a shapefile with reserved words as field names will likely fail ogr2ogr Beside shp2pgsql and SPIT there is another tool for feeding geodata in PostGIS ogr2ogr This is part of your GDAL installation To import a shapefile into PostGIS do the following ogr2ogr f PostgreSQL PG dbname postgis host myhost de user postgres password topsecret alaska shp This will import the shapefile alaska shp into the PostGIS database postgis using the user postgres with the password topsecret on host myhost de Note that OGR must be built against PostgreSQL to support PostGIS You can see this by typing ogrinfo formats grep i post 4 2 5 Improving Performance Retrieving features from a PostgreSQL database can be time consuming especially over a network You can improve the drawing performance of PostgreSQL layers by ensuring that a spatial index exists on each layer in the database PostGIS supports creation of a GIST Generalized Search Tree index to speed up spatial searches of the data The syntax for creating a G
139. in Manger Plugin Directory usr lib qgis ommuna To load a plugin click the checkbox next to the plugin and click Ok M Add Delimited Text Layer gt 5 Loads and displays delimited text files containing x y coordinates Y CopyrightLabel L Draws copynght information Georeferencer i K Adding projection info to rasters M GPS Tools i Tools for loading and importing GPS data GRASS ion 0 1 GRASS layer Graticule Creator ion 0 Builds a graticule NorthArrow Displays a north arrow overlayed onto the map PostgresSQL Geoprocessing Version 0 1 Geoprocessing functions for working with PostgreSQU PostGIS layers pagec ScaleBar Version 0 1 Draws a scale bar SPIT Version 0 1 Shapefle to PostgreSQU PostGIS Import Tool WFS plugin Version 0 0001 Adds WFS layers to the QGIS canvas 11 1 3 Data Providers Data Providers are special plugins that provides access to a data store By default QGIS supports PostGIS layers and disk based data stores supported by the GDAL OGR library Appendix A 1 A Data Provider plugin extends the ability of QGIS to use other data sources Data Provider plugins are registered automatically by QGIS at startup They are not managed by the Plugin Manager but are used behind the scenes when a corresponding data type is added as a layer in QGIS 11 1 4 Core Plugins QGIS currently contains 9 core plugins that can be loaded using the Plugin Manager Table 5 lists each of the core plugins
140. inate system you want to use in the list of projections Alternatively you can use the search feature as described in the previous section 7 3 Custom Projections If QGIS doesn t have the projection you need you can define a custom projection To define a projection select Custom Projections from the Settings menu Custom projections are stored in your QGIS user database In addition to your projections this database contains your spatial bookmarks and other custom data Figure 15 Custom Projection Dialog OS X e090 4 Custom Projection Definition Define Test Custom Projection Definition 1 You can define your own custom projection here The definition must conform to the proj4 format for specifying a Spatial Reference System Name albers test Parameters proj aea lat_1 55 lat_2 65 lat_0 50 lon_0 154 x_0 0 y_0 0 ellps cirk66 datum NAD27 lofl gt gt New Save Delete Close At version 0 9 1 of QGIS defining a custom projection requires a good understanding of the Proj 4 projection library To begin refer to Cartographic Projection Procedures for the UNIX Environment QGIS 0 9 1 User and Installation Guide 61 7 3 Custom Projections A User s Manual by Gerald I Evenden U S Geological Survey Open File Report 90 284 1990 available at ftp ftp remotesensing org proj 0F90 284 pdf This manual describes the use of the proj and related command line utilities
141. ish_toposheet tar gz As a first step we download the file and untar it wget http grass itc it sampledata spearfish_toposheet tar gz tar xvzf spearfish_toposheet tar gz cd spearfish_toposheet The next step is to start QGIS load the georeferencer plugin and select the file spearfish_topo24 tif Figure 35 Select an image to georeference f Georeterencer Raster file earfish_topo24 tif Arrange plugin windows Description Close Now click on the button Arrange plugin window to open the image in the georeferencer and to arrange it with the reference map in the qgis map canvas on your dekstop With the button Add Point you can start to add points on the raster image and enter their coordinates and the plugin will compute the world file parameters see figure 37 The more coordinates you provide the better the result will be For the procedure you have two option 1 You click on a point in the raster map and enter the X and Y coordinates manually QGIS 0 9 1 User and Installation Guide 98 11 6 Using the Georeferencer Plugin Figure 36 Arrange plugin window with the qgis map canvas File View Layer Settings Plugins Help ca AA jade S ue BEREOAOEEe Pan se PRAERONNMEVO EZPILEAOE gt 9 Description Close Legend E ASH ul ess qui OJOS Transform type Linear x Modified raster l Wo
142. isphere QGIS 0 9 1 User and Installation Guide 7 3 3 Starting QGIS GEOGCS clark66 DATUM North_American_Datum_1927 SPHEROID clark66 6378206 4 294 9786982 PRIMEM Greenwich 0 UNIT degree 0 0174532925199433 PROJECTION Transverse_Mercator PARAMETER latitude_of_origin 0O PARAMETER central_meridian 105 PARAMETER scale_factor 0 9996 PARAMETER false_easting 500000 PARAMETER false_northing 0 UNIT meter 1 These data sets will be used as a basis for many of the examples and screenshots in this document 3 3 Starting QGIS Assuming that QGIS is installed in the PATH you can start QGIS by typing qgis at a command prompt or by double clicking on the QGIS application link or shortcut on the desktop Under MS Windows start QGIS using the Start menu shortcut and under Mac OS X double click the icon in your Applications folder 3 3 1 Command Line Options QGIS supports a number of options when started from the command line To get a list of the options enter qgis help on the command line The usage statement for QGIS is qgis help Quantum GIS 0 9 0 Ganymede Quantum GIS QGIS is a viewer for spatial data sets including raster and vector data Usage qgis options FILES options snapshot filename emit snapshot of loaded datasets to given file lang language use language for interface text project projectfile load the given QGIS project
143. ith all layers loaded described in the given file Command line option extent To start with a specific map extent use this option You need to add the bounding box of your extent in the following order separated by a comma extent xmin ymin xmax ymax 3 4 QGIS GUI When QGIS starts you are presented with the GUI as shown below the numbers 1 through 6 in blue ovals refer to the six major areas of the interface as discussed below QGIS 0 9 1 User and Installation Guide 9 3 4 QGIS GUI Figure 1 Main window with alaska sample data GNU Linux with KDE He View Layer Settings Plugins Help Jeaea eas HAARR P REEMAA Zalagao BSPSZVRRABUBB V BReiEwVitweHhO BERBEUEEBBHE Yr aD E Files 96 7 takes E sel alaska tee w E 38 E ak_shade E Fies el ak_shade ti Note Your window decorations title bar etc may appear different depending on your operating system and window manager The QGIS GUI is divided into six areas 1 Menu Bar 4 Map View 2 Tool Bar 5 Map Overview 3 Map Legend 6 Status Bar These six components of the QGIS interface are described in more detail in the following sections QGIS 0 9 1 User and Installation Guide 10 3 4 QGIS GUI 3 4 1 Menu Bar The menu bar provides access to various QGIS features using a standard hierarchical menu The top level menus and a summary of some of the functions provided are e File New Project s
144. itial SVN Check out pe ee Ge hk eee He RL ERE EE REESE Ee HS 164 H 10 Create Makefiles using cmakesetup exe ee ee 165 H 11 Running and packaging oR BP ke Som Fon ae a oh Ge ek A ot E 166 l GNU General Public License 167 1 1 Quantum GIS Qt exception for GPL a Sis ah Skah Be GBD OR a Gp Ah ee Be Gh A 172 Cited literature 173 Index 174 QGIS 0 9 1 User and Installation Guide List of Figures List of Figures 1 Main window with alaska sample data GNU Linux with KDE a Se Oger as Shares 10 2 __Weasuire tools IN action 2235 4 86 o aS eee RES Se A eae eee 17 3 Open OGR Data Source Dialog Se Ge ES Ot se eee E eae we tee 22 4 _QGIS with Shapefile of Alaska loaded o o 23 5 Vector Layer Properties Dialog ecg cede Oat A es Gat a dg oT Ma ot ap ae oe oa 29 6 Selectfeature and choose action 2 2 2 2 o e e 34 7 Vector Digitizing Attributes Capture Dialog 2 2 ooo 37 8 Creating a New Vector Dialog ee ee eee ee ee ee ee 41 9 EA AAA 42 10 Raster context Menu 2 20 000 ee 45 11 Raster Layers Properties Dialog a ce Bee ee a ee ee eke eo 46 1
145. itialize the UI 27 self setupUi self 28 29 Set the title for the app 30 self setWindowTitle FOSS4G2007 Demo App 31 32 Create the map canvas 33 self canvas QgsMapCanvas 34 Set the background color to light blue something 35 self canvas setCanvasColor QColor 200 200 255 36 self canvas enableAntiAliasing True 37 self canvas useQImageToRender False 38 self canvas show 39 40 Lay our widgets out in the main window using a 41 vertical box layout 42 self layout QVBoxLayout self frame 43 self layout addWidget self canvas 44 45 Create the actions for our tools and connect each to the appropriate 46 method 47 self actionAddLayer QAction QIcon foss4g2007 mActionAddLayer png 48 49 Add Layer self frame QGIS 0 9 1 User and Installation Guide 112 12 2 Creating the MainWindow 50 self connect self actionAddLayer SIGNAL activated self addLayer 51 self actionZoomIn QAction QIcon foss4g2007 mActionZoomIn png 52 Zoom In self frame 53 self connect self actionZoomIn SIGNAL activated self zoomIn 54 self actionZoom0ut QAction QIcon foss4g2007 mActionZoomOut png 55 Zoom Out self frame 56 self connect self actionZoom0ut SIGNAL activated self zoom0ut 57 self actionPan QAction QIcon foss4g2007 mActionPan png 58 Pan self frame 59 self connect self actionPan SIGNAL activated self pan 60 self actio
146. ive or can get the source code And you must show them these terms so they know their rights We protect your rights with two steps 1 copyright the software and 2 offer you this license which gives you legal permission to copy distribute and or modify the software Also for each author s protection and ours we want to make certain that everyone understands that there is no warranty for this free software If the software is modified by someone else and passed on we want its recipients to know that what they have is not the original so that any problems introduced by others will not reflect on the original authors reputations Finally any free program is threatened constantly by software patents We wish to avoid the danger that redistributors of a free program will individually obtain patent licenses in effect making the program proprietary To prevent this we have made it clear that any patent must be licensed for everyone s free use or not licensed at all The precise terms and conditions for copying distribution and modification follow TERMS AND CONDITIONS FOR COPYING DISTRIBUTION AND MODIFICATION QGIS 0 9 1 User and Installation Guide 167 0 This License applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License The Program below refers to any such program or work and a work based on the Program means
147. latform SDK for Windows Server 2003 R2 Lib 4 Close MSVC Express IDE 5 Open the following file with notepad C Program Files Microsoft Visual Studio 8 VC VCProjectDefaults corewin_express vsprops and change the property AdditionalDependencies kernel32 1ib To read AdditionalDependencies kernel32 1ib user32 1ib gdi32 1ib winspool 1lib comdlg32 1lib advapi32 1lib shel132 1ib ole32 1ib oleaut32 1ib uuid lib The notes go on to show how to build a mswin32 application which you can try if you like I m not going to recover that here H 5 Edit your vsvars Backup your vsvars32 bat file in C Program Files Microsoft Visual Studio 8 Common7 Tools and replace it with this one SET VSINSTALLDIR C Program Files Microsoft Visual Studio 8 SET VCINSTALLDIR C Program Files Microsoft Visual Studio 8 VC SET FrameworkDir C WINDOWS Microsoft NET Framework SET FrameworkVersion v2 0 50727 SET FrameworkSDKDir C Program Files Microsoft Visual Studio 8 SDK v2 0 if VSINSTALLDIR goto error_no_VSINSTALLDIR if VCINSTALLDIR goto error_no_VCINSTALLDIR QGIS 0 9 1 User and Installation Guide 159 H 5 Edit your vsvars echo Setting environment for using Microsoft Visual Studio 2005 x86 tools rem rem Root of Visual Studio IDE installed files rem set DevEnvDir C Program Files Microsoft Visual Studio 8 Common7 IDE set PATH C Program Files Microsoft Visual Studio 8 Common7 IDE C Progra
148. lbar entry Plugins gt GRASS gt Create new GRASS vector layer Figure 17 shows the GRASS Edit dialog that is displayed when you click on the edit tool Figure 17 GRASS Edit Dialog BR OA diy aw N Y Category Settings Symbology Table Mode Next not used Left New point The tools and settings are discussed in the following sections QGIS 0 9 1 User and Installation Guide 67 8 5 Digitizing and Editing Tools 8 5 1 Toolbar Table 4 lists the digitizing tools provided by the GRASS plugin These correspond to the tool buttons in the toolbar s across the top of the dialog Table 4 GRASS Digitizing Tools New Centroid Icon Tool Purpose t New Point digitize new point N New Line digitize new line finish by selecting new tool Q New Boundary digitize new boundary finish by selecting new tool digitize new centroid label existing area Move vertex select one vertex of existing line or boundary and identify new position Add vertex add a new vertex to existing line Delete vertex delete one vertex from existing line confirm selected vertex by another click ile za ASS Move line select existing line and click on new position Split line split an existing line to 2 parts Delete line delete existing line confirm selected line by another click Edit attributes edit attributes of existing element note
149. le and use defined locale instead e Information about active system locale Help Browser Tab e Define Browser to display help documents You can modify the options according to your needs Some of the changes may require a restart of QGIS before they will be effective On GNU Linux everything is saved in HOME config QuantumGIS qgis conf This is a normal text file consisting of blocks where QGIS saves its current display options PostGIS and WMS connections and other settings On Windows settings are stored in the registry under HKEY_CURRENT_USER Software QuantumGIS qgis QGIS 0 9 1 User and Installation Guide 19 3 9 Spatial Bookmarks On OS X you can find your settings in HOME Library Preferences org qgis qgis plist 3 9 Spatial Bookmarks Spatial Bookmarks allow you to bookmark a geographic location and return to it later 3 9 1 Creating a Bookmark To create a bookmark 1 Zoom or pan to the area of interest 2 Select the menu option View gt New Bookmark or type Ctrl B 3 Enter a descriptive name for the bookmark up to 255 characters 4 Click OK to add the bookmark or Cancel to exit without adding the bookmark Note that you can have multiple bookmarks with the same name 3 9 2 Working with Bookmarks To use or manage bookmarks select the menu option View gt Show Bookmarks The bookmarks dia log allows you to zoom to or delete a bookmark You can not edit the bookmark name or coor
150. lems 4 06 oc E ES ee ee eee eS ee 108 11 7 7 Adding Feedback 42000 4 tba S25 GED EHR EEK CGS eRe FE 109 11 7 8 Summaty 2 a 109 QGIS 0 9 1 User and Installation Guide vi Contents 12 Creating Applications 110 121 DESIMING MES CU y 20200 OA e A 110 12 2 Creating the MainWindow 2 4 2 lt e 42ee0h ee see ee Eee ee Se see 111 123 Eimishing ar aa rs A e E A a e 116 12 4 Running the Application ccscrrurs ero o a E IA 116 13 Help and Support 119 18 1 MAIINQUSIS co ko we a Ae ERA IA HR dee Ae See KR A 119 132 MG ape seca cog decane a om Se Gey AN 120 13 3 BugTracker lt sr soed ee ee 120 12486 to ee eS o ed yh ee oe eke wee oh ee eee e 120 ASS Sais ep cee sees a Prater ae hoe As War ista ae eee lo ad Stig 121 A Supported Data Formats 122 A 1 Supported OGR Formats o o 2 eee eee 122 A 2 GDAL R st r Eormats lt bes 28h oe 23555882 Gt oe eo e eK 123 B Installation Guide 125 B 1 General Build Notes ra os oe ee OS ee ee e wee 125 B 2 An overview of the dependencies required for building SS wi eae ds Geet chen Gee ree 125 C Building under windows using
151. lugins it finds Once that s done the plugin will show up in the plugin manager Let s create a plugin to fill a gap in the QGIS interface This plugin will allow us to create a new PostGIS layer for us to digitize It will be a simple plugin and pretty rough but it illustrates how to get started writing your own PyQGIS plugins 11 7 1 Setting up the Structure The first thing we need to do is set up the structure for our plugin In this example we ll be developing our plugin on Linux but the method is the same just adapt some of the file system commands as appropriate for your platform QGIS is installed in a directory named qgis_09 in our home directory Let s create the directory for the plugin mkdir qgis_09 share qgis python plugins new_layer To get started we need to create the following files in the new_layer directory we ll need some additional files in a bit __init__ py resources py resources qrc newlayer py QGIS 0 9 1 User and Installation Guide 102 11 7 Using the Python Plugin 11 7 2 Making the Plugin Recognizable Initializing the plugin is done in the __init__ py script For our NewLayer plugin the script contains 1 load NewLayer class from file newlayer py 2 from newlayer import NewLayer 3 def name 4 return New PostGIS layer 5 def description 6 return Creates a new empty Postgis layer 7 def version 8 return Version 0 1 9 def classFactory iface 10 return NewLayer
152. m Files Microsoft Visual Studio 8 VC BIN C Program Files Microsoft Visual Studio 8 Common7 Tools C Program Files Microsoft Visual Studio 8 SDK v2 0 bin C WINDOWS Microsoft NET Framework v2 0 50727 C Program Files Microsoft Visual Studio 8 VC VCPackages PATH A rem added by Tim set PATH C Program Files Microsoft Platform SDK for Windows Server 2003 R2Bin PATH set INCLUDE C Program Files Microsoft Visual Studio 8 VC INCLUDE ZINCLUDE rem added by Tim set INCLUDE C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Include INCLUDES set INCLUDE C Program Files Microsoft Platform SDK for Windows Server 2003 R2 Include mfc Y INCLUDES set INCLUDE INCLUDE C dev cpp qgislibs release include postgresql set LIB C Program Files Microsoft Visual Studio 8 VC LIB C Program Files Microsoft Visual Studio 8 SDK v2 0 lib ZLIBZ rem added by Tim set LIB C Program Files Microsoft Platform SDK for Windows Server 2003 R2ALib 4LIB set LIB LIB C dev cpp qgislibs release lib set LIBPATH C WINDOWS Microsoft NET Framework v2 0 50727 goto end error_no_VSINSTALLDIR echo ERROR VSINSTALLDIR variable is not set goto end error_no_VCINSTALLDIR echo ERROR VCINSTALLDIR variable is not set goto end QGIS 0 9 1 User and Installation Guide 160 H 6 Environment Variables end H 6 Environment Variables Right click on My computer then select the Advanced tab Click
153. made for each action In lines 79 through 88 we set up a method for each of the three tools that interact with the map When a tool is activated by clicking on it in the toolbar the corresponding method is called that tells the map canvas it is the active tool The active tool governs what happens when the mouse is clicked on the canvas The zoom to full extent tool isn t a map tool it does its job without requiring a click on the map When it is activated we call the ZoomFullExtent method of the map canvas line 92 This completes the implementation of all our tools except one the add layer tool Let s look at it next 93 Add an OGR layer to the map 94 def addLayer self 95 file QFileDialog getOpenFileName self Open Shapefile Shapefiles 96 shp QGIS 0 9 1 User and Installation Guide 114 12 2 Creating the MainWindow 97 fileInfo QFileInfo file 98 99 Add the layer 100 layer QgsVectorLayer file fileInfo fileName ogr 101 102 if not layer isValid 103 return 104 105 Change the color of the layer to gray 106 symbols layer renderer symbols 107 symbol symbols 0 108 symbol setFillColor QColor fromRgb 192 192 192 109 110 Add layer to the registry 111 QgsMapLayerRegistry instance addMapLayer layer 112 113 Set extent to the extent of our layer 114 self canvas setExtent layer extent 115 116 Set up the map canvas layer set 117 cl QgsM
154. me functions as the menus plus additional tools for interacting with the map Each toolbar item has popup help available Hold your mouse over the item and a short description of the tool s purpose will be displayed Every menubar can be moved around according to your needs Additionally every menubar can be switched off using your right mouse button context menu holding the mouse over the toolbars Tip 2 REAPPEARING TOOLBARS If you have accidentally hidden all your toolbars you can get them back by choosing Show most toolbars from the View Toolbars menu 3 4 3 Map Legend The map legend area is used to set the visibility and z ordering of layers Z ordering means that layers listed nearer the top of the legend are drawn over layers listed lower down in the legend The checkbox in each legend entry can be used to show or hide the layer QGIS 0 9 1 User and Installation Guide 12 3 4 QGIS GUI Layers can be grouped in the legend window by adding a layer group and dragging layers into the group To do so go with the mouse to the legend window right click choose Add group A new folder appears Now drag the layers to the folder symbol It is then possible to toggle the visibility of all the layers in the group with one click To bring layers out of a group go with the mouse to the layer symbol right click choose Make to toplevel item To give the folder a new name choose Rename in the right click menu of the g
155. mes cd usr local bin sudo 1n s usr bin ccache gcc sudo 1n s usr bin ccache g E 7 Prepare your development environment As a convention do all my development work in HOME dev lt language gt so in this case we will create a work environment for C development work like this mkdir p HOME dev cpp cd HOME dev cpp This directory path will be assumed for all instructions that follow QGIS 0 9 1 User and Installation Guide 139 E 8 Check out the QGIS Source Code E 8 Check out the QGIS Source Code There are two ways the source can be checked out Use the anonymous method if you do not have edit privaleges for the QGIS source repository or use the developer checkout if you have permissions to commit source code changes 1 Anonymous Checkout cd HOME dev cpp svn co https svn qgis org repos qgis trunk qgis qgis 2 Developer Checkout cd HOME dev cpp svn co username lt yourusername gt https svn qgis org repos qgis trunk qgis qgis The first time you check out the source you will be prompted to accept the qgis org certificate Press p to accept it permanently Error validating server certificate for https svn qgis org 443 The certificate is not issued by a trusted authority Use the fingerprint to validate the certificate manually Certificate information Hostname svn qgis org Valid from Apr 1 00 30 47 2006 GMT until Mar 21 00 30 47 2008 GMT Issuer Developer Team
156. meter box to specify what the delimeter is for your file e g space commar or tab Note this box accepts regex entries so use tfor tab and es Ga Est a a need Delimited textfile 3 Layer name Eb Delimiter T X gt a a a Ss x Q a pS de Di r X field y Y field A Help Parse Add Layer Close First select the file to import by clicking on the ellipsis button Select the desired text file from the file dialog Once the file is selected the plugin attempts to parse the file using the last used delimiter in this case see Figure 31 Figure 31 File Selected Greate a Layer from a Delimited Text File Delimited Text Layer Description 4 and this plugin will do the job for you ry i ao bi Use the layer name box to specify the legend name be s for the new layer Use the delimeter box to specify Select the file containing delimited text with lavlon coordinates that you would like to use as a point layer what the delimeter is for your file e g space commar g 4 gt gt Mg Delimited text file hignis_no_east_hemi_tabbed txt sal EN i Layer name Delimiter N 1g As 2 E XY Y T a A a Se field itdec longdec cell x field dec longdec cell y b R Help Parse Add Layer l Close QGIS 0 9 1 User and Installation
157. ms from school that showed an x and y axis You might have used them to chart declining retirement savings or increasing compound mortgage interest but the concepts are essential to geospatial data analysis and mapping There are various ways of representing these geographic coordinates depending on your purpose This is a whole area of study for another day map projections Vector data takes on three forms each progressively more complex and building on the former 1 Points A single coordinate x y represents the discrete geographic location 2 Lines Multiple coordinates x1 y1 x2 y2 x3 y4 xn yn strung together in a certain order Like drawing a line from Point x1 y1 to Point x2 y2 and so on These parts between each point are considered line segments They have a length and the line can be said to have a direction based on the order of the points Technically a line is a single pair of coordinates connected together whereas a line string is multiple lines connected together 3 Polygons When lines are strung together by more than two points with the last point being at the same location as the first we call this a polygon A triangle circle rectangle etc are all polygons The key feature of polygons is that there is a fixed area within them QGIS 0 9 1 User and Installation Guide 6 3 Getting Started This chapter gives a quick overview of running QGIS with data available on the QGIS web page 3 1 I
158. n and la workdwind_dem SRTM derived global elevation 3 arc second Not connected Layers The Layers section lists the layers available from the selected WMS server You may notice that some layers are expandible this means that the layer can be displayed in a choice of image styles You can select several layers at once but only one image style per layer When several layers are selected they will be combined at the WMS Server and transmitted to QGIS in one go Tip 23 WMS LAYER ORDERING In this version of QGIS WMS layers rendered by a server are overlaid in the order listed in the Layers section from top to bottom of the list If you want to overlay layers in the opposite order then you can select Add WMS layer a second time choose the same server again and select the second group of layers that you want to overlay the first group Transparency In this version of QGIS the transparency setting is hard coded to be always on where available Therefore no option for it exists on screen This in theory allows you to overlay WMS layers on other layers raster vector or WMS and still see through to those lower layers QGIS 0 9 1 User and Installation Guide 53 6 2 WMS Client Tip 24 WMS LAYER TRANSPARENCY The availability of WMS image transparency depends on the image encoding used PNG and GIF support transparency whilst JPEG leaves it unsupported Coordinate Reference Sys
159. n configure py p win32 g make make install C 4 4 Compile PyQt c Qt 4 3 0 bin gtvars bat python configure py make make install C 4 5 Final python notes You can delete the directories with unpacked SIP and PyQt4 sources after a successfull install they re not needed anymore C 5 Subversion In order to check out QGIS sources from the repository you need Subversion client This installer should work fine http subversion tigris org files documents 15 36797 svn 1 4 3 setup exe C 6 CMake CMake is build system used by Quantum GIS Download it from here http www cmake org files v2 4 cmake 2 4 6 win32 x86 exe C 7 QGIS Start a cmd exe window Start gt Run gt cmd exe Create development directory and move into it md c dev cpp cd c dev cpp QGIS 0 9 1 User and Installation Guide 128 C 8 Compiling Check out sources from SVN For svn head svn co https svn qgis org repos qgis trunk qgis For svn 0 8 branch svn co https svn qgis org repos qgis branches Release 0_8_0 qgis0 8 C 8 Compiling As a background read the generic building with CMake notes at the end of this document Start a cmd exe window Start gt Run gt cmd exe if you don t have one already Add paths to compiler and our MSYS environment c Qt 4 3 0 bin qtvars bat For ease of use add c Qt 4 3 0 bin to your system path in system properties so you can just type qtvars b
160. nZoomFull QAction QIcon foss4g2007 mActionZoomFullExtent png 61 Zoom Full Extent self frame 62 self connect self actionZoomFull SIGNAL activated 63 self zoomFull 64 65 Create a toolbar 66 self toolbar self addToolBar Map 67 Add the actions to the toolbar 68 self toolbar addAction self actionAddLayer 69 self toolbar addAction self actionZoomIn 70 self toolbar addAction self actionZoomOut 71 self toolbar addAction self actionPan 72 self toolbar addAction self actionZoomFul1 73 74 Create the map tools 75 self toolPan QgsMapToolPan self canvas 76 self toolZoomIn QgsMapToolZoom self canvas False false in 77 self toolZoom0ut QgsMapToolZoom self canvas True true out Lines 21 through 27 are the basic declaration and initialization of the MainWindow and the set up of the user interface using the setupUi method This is required for all applications Next we set the title for the application so it says something more interesting than MainWindow line 30 Once that is complete we are ready to complete the user interface When we created it in Designer we left it very sparse just a main window and a frame You could have added a menu and the toolbar using Designer however we ll do it with Python In lines 33 through 38 we set up the map canvas set the background color to a light blue and enable antialiasing We also tell it not to use a Qlmage for rendering
161. nable buffering 3 Choose a size for the buffer using the spin box 4 Choose a color by clicking on Colour and choosing your favorite from the color selector 5 Click Apply to see if you like the changes If you aren t happy with the results tweak the settings and then test again by clicking Apply A buffer of 2 points seems to give a good result Notice you can also specify the buffer size in map units if that works out better for you The remaining tabs on the Label tab allow you control the appearance of the labels using attributes stored in the layer The Data tabs allow you to set all the parameters for the labels using fields in the layer QGIS 0 9 1 User and Installation Guide 31 4 3 The Vector Properties Dialog 4 3 5 Actions Tab QGIS provides the ability to perform an action based on the attributes of a feature This can be used to perform any number of actions for example running a program with arguments built from the attributes of a feature or passing parameters to a web reporting tool Actions are useful when you frequently want to run an external application or view a web page based on one or more values in your vector layer An example is performing a search based on an attribute value This concept is used in the following discussion Defining Actions Attribute actions are defined from the vector layer properties dialog To define an action open the vector layer properties dialog and click on the Ac
162. nfiguration completes without error click OK to generate the solution and project files QGIS 0 9 1 User and Installation Guide 154 With Visual Studio 2005 open the qgis sin file that will have been created in the Build directory you created earlier Build the ALL_BUILD project This will build all the QGIS binaries along with all the plugins Install QGIS by building the INSTALL project By default this will install to c Program Files qgis lt version gt this can be changed by changing the CMAKE_INSTALL_PREFIX variable in CMake You will also either need to add all the dependency dlls to the QGIS install directory or add their respective directories to your PATH H Building under Windows using MSVC Express Note Building under MSVC is still a work in progress In particular the following dont work yet python grass postgis connections This section of the document is in draft form and is not ready to be used yet Tim Sutton 2007 H 1 System preparation started with a clean XP install with Service Pack 2 and all patches applied have already com piled all the dependencies you need for gdal expat etc so this tutorial wont cover compiling those from source too Since compiling these dependencies was a somewhat painful task hope my pre compiled libs will be adequate If not suggest you consult the individual projects for specific build documentation and support Lets go over the process in a nutshell be
163. nmake nmake install Add qt sql odbc qt sql psql to the configure line if your want odbc and PostgreSQL support build into Qt Note For me in some cases I got a build error on qscreenshot pro If you are only interested in having the libraries needed for building Qt apps you can probably ignore that Just check in c Qt 4 3 2 bin to check all dlls and helper apps assistant etc have been made Configure Visual C to use Qt After building configure the Visual Studio Express IDE to use Qt 1 open Visual Studio Express IDE 2 Tools gt Options gt Projects and Solutions gt VC Directories 3 Add Executable files QTDIR bin Include files QTDIR include QTDIR include Qt QTDIR include QtCore QTDIR include QtGui QTDIR include QtNetwork QTDIR include QtSvg QTDIR include QtXml QTDIR include Qt3Support LIB_DIR include needed during qgis compile to find stdint h and unistd h QGIS 0 9 1 User and Installation Guide 162 H 6 Environment Variables Library files QTDIR lib Source Files QTDIR src Hint You can also add QString t lt d gt data su gt size lt d gt size i gt to AutoExp DAT in C Program Files Microsoft Visual Studio 8 Common7 Packages Debugger before Visualizer That way the Debugger will show the contents of QString when you point at or watch a variable in the debugger There are probably much more additions feel free to add some I
164. nse document but changing it is not allowed Preamble The licenses for most software are designed to take away your freedom to share and change it By contrast the GNU General Public License is intended to guarantee your freedom to share and change free software to make sure the software is free for all its users This General Public License applies to most of the Free Software Foundation s software and to any other program whose authors commit to using it Some other Free Software Foundation software is covered by the GNU Library General Public License instead You can apply it to your programs too When we speak of free software we are referring to freedom not price Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software and charge for this service if you wish that you receive source code or can get it if you want it that you can change the software or use pieces of it in new free programs and that you know you can do these things To protect your rights we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights These restrictions translate to certain responsibilities for you if you distribute copies of the software or if you modify it For example if you distribute copies of such a program whether gratis or for a fee you must give the recipients all the rights that you have You must make sure that they too rece
165. nstallation Building QGIS from source is documented in Appendix for windows Appendix for Mac OSX and Appendix for GNU Linux The Installation instructions are distributed with the QGIS source code and also available at http qgis org Standard installer packages are available for Windows and Mac OS X For many flavors of GNU Linux binary packages are provided Get the latest information on binary packages at the QGIS website at http download qgis org 3 2 Sample Data If you do not have any GIS data handy you can obtain an Alaska dataset from the QGIS web site at http qgis org The projection for the data is Alaska Albers Equal Area with unit meter PROJCS NAD_1927_Albers GEOGCS GCS_North_American_1927 DATUM D_North_American_1927 SPHEROID Clarke_1866 6378206 4 294 9786982 PRIMEM Greenwich 0 0 UNIT Degree 0 0174532925199433 PROJECTION Albers PARAMETER False_Easting 0 0 PARAMETER False_Northing 0 0 PARAMETER Central_Meridian 154 0 PARAMETER Standard_Parallel_i 55 0 PARAMETER Standard_Parallel_2 65 0 PARAMETER Latitude_Of_Origin 50 0 UNIT Meter 1 0 For use with GRASS a sample GRASS database e g Spearfish can be obtained from the official GRASS GIS website http grass itc it download data php The projection of the Spearfish dataset is UTM Zone 13 Northern Hemisphere PROJCS UTM Zone 13 Northern Hem
166. nted as raster data but there are limitations A raster is a regular grid made up of cells or in the case of imagery pixels They have a fixed number of rows and columns Each cell has a numeric value and has a certain geographic size e g 30x30 meters in size Multiple overlapping rasters are used to represent images using more than one colour value i e one raster for each set of red green and blue values is combined to create a colour image Satellite imagery also represents data in multiple bands Each band is essentially a separate spatially overlapping raster where each band holds values of certain wavelengths of light As you can imagine a large raster takes up more file space A raster with smaller cells can provide more detail but takes up more file space The trick is finding the right balance between cell size for storage purposes and cell size for analytical or mapping purposes QGIS 0 9 1 User and Installation Guide 5 2 1 Why is all this so new 2 1 2 Vector Data Vector data is also used in geospatial applications If you stayed awake during trigonometry and coordinate geometry classes you will already be familiar with some of the qualities of vector data In its simplest sense vectors are a way of describing a location by using a set of coordinates Each coordinate refers to a geographic location using a system of x and y values This can be thought of in reference to a Cartesian plane you know the diagra
167. oads it into QGIS Figure 4 shows QGIS after loading the alaska shp file Tip 4 LAYER COLORS When you add a layer to the map it is assigned a random color When adding more than one layer at a time different colors are assigned to each Once loaded you can zoom around the shapefile using the map navigation tools To change the symbology of a layer open the layer properties dialog by double clicking on the layer name or by right clicking on the name in the legend and choosing Properties from the popup menu See Section 4 3 1 for more information on setting symbology of vector layers 4 1 2 Improving Performance To improve the performance of drawing a shapefile you can create a spatial index A spatial index will improve the speed of both zooming and panning Spatial indexes used by QGIS have a qix extension Use these steps to create the index QGIS 0 9 1 User and Installation Guide 22 4 1 ESRI Shapefiles Figure 4 QGIS with Shapefile of Alaska loaded Giant Gis 00 Preview 1 Ganymede review 14 Ble View Layer Settings Plugins Help Daane oMAkGao00 rnammaa v HL gt Go HAG a PPIP URE BB BERBERS RBEC PAD PROMO 1e 06 degrees QGIS 2007 E SAA oy e Load a shapefile e Open the Layer Properties dialog by double clicking on the shapefile name in the legend or by right clicking and choosing Properties from the popup menu e In the tab General
168. on 47 loading 45 metadata 48 metadata properties 49 48 pyramids 48 rendering interpretation resolution pyramids 48 standard deviation 47 statistics 48 supported channels 47 supported formats 123 transparency rasters 47 metadata 54 properties WMS 50 54 options 16 scale dependent 15 suspending 1 6 update during drawing 16 scale 15 security 25 settings 25 shapefile format 21 loading specification 21 shapefiles 21 SHP files 21 spatial bookmarks seebookmarks20 spatial index shapefiles symbology changing 29 TAB files 21 Toggle Editing 35 toolbars 12 vector layers 21 43 add island 39 ring 39 adding feature 36 vertex 38 Arcinfo Coverage 24 copy feature 39 cut feature 39 deleting feature 40 vertex 38 editing vertex 38 ESRI shapefiles 21 MapInfo 23 moving vertex 38 paste feature 39
169. on contains some details on how QGIS accesses PostgreSQL layers Most of the time QGIS should simply provide you with a list of database tables that can be loaded and load them on request However if you have trouble loading a PostgreSQL table into QGIS the information below may help you understand any QGIS messages and give you direction on changing the PostgreSQL table or view definition to allow QGIS to load it QGIS requires that PostgreSQL layers contain a column that can be used as a unique key for the layer For tables this usually means that the table needs a primary key or have a column with a unique constraint on it QGIS additionally requires that this column be of type int4 an integer of size 4 bytes If a table lacks these items the oid column will be used instead Performance will be improved if the column is indexed note that primary keys are automatically indexed in PostgreSQL If the PostgreSQL layer is a view the same requirements exist but views don t have primary keys or columns with unique constraints on them In this case QGIS will try to find a column in the view that is derived from a table column that is suitable If one cannot be found QGIS will not load the layer If this occurs the solution is to alter the view so that it does include a suitable column a type of int4 and either a primary key or with a unique constraint preferably indexed 4 2 4 Importing Data into PostgreSQL shp2pgsql Data can be importe
170. ons of this License If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations then as a consequence you may not distribute the Program at all For example if a patent license would not permit royalty free redistribution of the Program by all those who receive copies directly or indirectly through you then the only way you could satisfy both it and this License would be to refrain entirely from QGIS 0 9 1 User and Installation Guide 169 distribution of the Program If any portion of this section is held invalid or unenforceable under any particular circumstance the balance of the section is intended to apply and the section as a whole is intended to apply in other circumstances It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system it is up to the author donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice This section is intended to make thoroughly clear what is believed to be a consequence o
171. oo o e e e 99 37 Add points to the raster image nfs ie ee cs a A 100 38 Georeferenced map with overlayed roads from spearfish60 location 101 39 Enter new PostGIS table Name 02 002 ee 107 40 Enter field names for new PostGIS tablel o 107 QGIS 0 9 1 User and Installation Guide x List of Figures 41 Enter DSN for connection to PostGIS database o o 108 42 Message Box with Plugin results es es se eee hb OS A RR A eee 109 43 Starting the new demo application 0 000 eee ee 117 44 Adding a layer the demo application 2 162 6b 245 lt 20ps be ee ewe a bE 117 QGIS 0 9 1 User and Installation Guide xi List of Tables List of Tables 1 PostGIS Connection Parameters 0 000 eee ee ee 25 2 _WMS Connection Parameters 0 2 0 0 e a e e a a 51 3 Example Public WMS URLS 2 6 2205 Bee ee ee Re ee ee ee 52 a GRASS Digitizing JO0lS lt soss 025 42 0426 65 54 046 4680 644454454036 4 68 5 QGIS C re Plugins vs se iaa bake pe es EDESA 85 QGIS 0 9 1 User and Installation Guide xii 1 Forward Welcome to the wonderful world of Geographical Information Systems GIS Quantum GIS QGIS is an Open Source Geographic Information System The project was born in May of 2002 and was established as a project on Source
172. ool prefix usr local enable shared disable static with libz usr local with png usr local make make install rm usr local lib libgdal a gt s shared o libgdal dll L usr local lib lz lpng frmts o o gcore o port o alg o ogr ogrsf_frmts o o ogr ogrgeometryfactory o ogr ogrpoint o ogr ogrcurve o ogr ogrlinestring o ogr ogrlinearring o ogr ogrpolygon o ogr ogrutils o ogr ogrgeometry o ogr ogrgeometrycollection o ogr ogrmultipolygon o ogr ogrsurface o ogr ogrmultipoint o ogr ogrmultilinestring o ogr ogr_api o ogr ogrfeature o ogr ogrfeaturedefn o ogr ogrfeaturequery o ogr ogrfeaturestyle o ogr ogrfielddefn o ogr ogrspatialreference o ogr ogr_srsnode o ogr ogr_srs_proj4 o ogr ogr_fromepsg o ogr ogrct o ogr ogr_opt o ogr ogr_srs_esri o ogr ogr_srs_pci o ogr ogr_srs_usgs o ogr ogr_srs_dict o ogr ogr_srs_panorama o ogr swq o ogr ogr_srs_validate o ogr ogr_srs_xml o ogr ograssemblepolygon o ogr ogr2gmlgeometry o ogr gml2ogrgeometry o install libgdal d11 usr local lib cd ogr gt s ogrinfo o o ogrinfo exe L usr local lib lpng lz lgdal gt s ogr2ogr o o ogr2ogr exe lgdal L usr local lib lpng lz lgdal gt s ogrtindex o o ogrtindex exe lgdal L usr local lib lpng 1z lgdal install ogrinfo exe ogr2ogr exe ogrtindex exe usr local bin cd apps gt s gdalinfo o o gdalinfo exe L usr local lib lpng lz lgdal gt s gdal_tr
173. ou need pre packaged and we focus just on getting Visual Studio Express set up and building QGIS Note that this does not currently include GRASS or Python plugins G 1 Setup Visual Studio This section describes the setup required to allow Visual Studio to be used to build QGIS G 1 1 Express Edition The free Express Edition lacks the platform SDK which contains headers and so on that are needed when building QGIS The platform SDK can be installed as described here http msdn microsoft com vstudio express visualc usingpsdk Once this is done you will need to edit the lt vsinstalldir gt Common7 Tools vsvars file as follows Add PlatformSDKDir lIncludelatl1 and PlatformSDKDir Include mfc to the set INCLUDE entry This will add more headers to the system INCLUDE path Note that this will only work when you use the Visual Studio command prompt when building Most of the dependencies will be built with this You will also need to perform the edits described here to remove the need for a library that Visual Studio Express lacks http www codeproject com wtl WTLExpress asp QGIS 0 9 1 User and Installation Guide 149 G 2 Download Install Dependencies G 1 2 All Editions You will need stdint h and unistd h unistd h comes with GnuWin32 version of flex amp bison binaries see later stdint h can be found here http www azillionmonkeys com ged pstdint h Copy both of these to lt
174. ould be oriented For placement of the arrow you have four options corresponding to the four corners of the map canvas Figure 25 North Arrow Plugin Soren ATOW PIOI gt 7 T Angle e Placement Bottom Left X Enable North Arrow x Set direction automatically oK Cancel 11 2 3 Scale Bar Plugin The Scale Bar plugin adds a simple scale bar to the map canvas You control the style and placement as well as the labeling of the bar QGIS 0 9 1 User and Installation Guide 88 11 2 Using the Decorations Plugins QGIS only supports displaying the scale in the same units as your map frame So if the units of your layers are in meters you can t create a scale bar in feet Likewise if you are using decimal degrees you can t create a scale bar to display distance in meters To add a scale bar 1 Open the plugin dialog by clicking on the Scale Bar tool on the Plugins toolbar 2 Choose the placement from the drop down list Choose the style 3 4 Select the color for the bar or use the default black color 5 Set the size of the bar and its label 6 Make sure the Enable scale bar checkbox is checked 7 Optionally choose to automatically snap to a round number when the canvas is resized 8 Click OK Figure 26 Scale Bar Plugin v Scole Bar PINGIN Scale Bar Plugin This plugin draws a scale bar on the map Please note the size option below is a
175. ptions Output Manual Name of input vector map Buffer distance in map units m Name of output vector map Run View output Cone The parser reads this definition and creates a new tab inside the toolbox when you select the module 8 8 Creating a new GRASS layer With this version of QGIS it is also possible to create new vectors from within GRASS very easily Just select Plugins gt GRASS gt Create new GRASS layer from the toolbar give a new name in the text box and start digitizing If you encounter a greyed out button make sure you have a working mapset enabled If you forgot how to enable a mapset have a look at Section 8 2 Since GRASS is able to organize all sort of geometries in one layer there is no need to select the geometry This only applies to shapefile creation see sec 4 4 3 QGIS 0 9 1 User and Installation Guide 73 8 8 Creating anew GRASS layer Some hints to make your digitizing more useful e Make sure to create an attribute table with its needed columns before you start digitizing if you would like to assign attributes to your digitized object Go to the table tab inside the digitize window e If you plan to create a polygon layer consider setting the mode to No category Then start digitizing the boundaries which actually do not need an entry in the attribute ta
176. r the name for the map file to be created You can use the button at the right to browse for the directory where you want the map file created Qgis project file Enter the full path to the QGIS project file qgs you want to export You can use the button at the right to browse for the QGIS project file QGIS 0 9 1 User and Installation Guide 75 9 2 Creating the Map File Map Name A name for the map This name is prefixed to all images generated by the mapserver Map Width Width of the output image in pixels Map Height Height of the output image in pixels Map Units Units of measure used for output Image type Format for the output image generated by MapServer Web Template Full path to the MapServer template file to be used with the map file Web Header Full path to the MapServer header file to be used with the map file Web Footer Full path to the MapServer footer file to be used with the map file Only the Map file and QGIS project file inputs are required to create a map file however you may end up with a non functional map file depending on your intended use Although QGIS is good at creating a map file from your project file it may require some tweaking to get the results you want but it s still way better than writing a map file from scratch Creating a Map File Let s create a map file using the shape files alaska lakes and rivers layers from the qgis_sample_ data 1 Load the alaska rivers and
177. rld file feevspearfish_topo2a wid _ Create Create and load layer 2 You click on a point in the raster map and choose the button from map canvas to add the X and Y coordinates with the help of a georeference map already loaded in QGIS For this example we use the second option and enter the coordinates for the selected points with the help of the roads map provided with the spearfish60 location from http grass itc it sampledata spearfish_grass60data 0 3 tar gz If you don t know how to integrate the spearfish60 location with the GRASS plugin information are provided in Section 8 As you can see in Figure 37 the georeferencer provides buttons to zoom pan add and delete points in the image After you added enough points to the image you need to select the transformation type for the geo QGIS 0 9 1 User and Installation Guide 99 11 6 Using the Georeferencer Plugin Figure 37 Add points to the raster image BUFFALO 6 Mi BELLE AOURONE VIA LES 85 12 W Enter X and Y coordinates which correspond with the selected point on the image Alternatively click the button with icon of a pencil and then click a corresponding point on map canvas of QGIS to fill in coordinates ofthat point X 591630 196868 Y 4927104 309683 A 4 EM ps Transform type Linear w Modified raster Save As World file arfish_toposheet spearfish_
178. rojects 3 6 1 Measure length bu QGIS is also able to measure real distances between given points according to a defined el lipsoid Therefore choose Options from the Settings menu click on the Map tools tab and choose the appropriate ellipsoid The tool then allows you to click points on the map Each segment length shows up in the measure window and additionaly the total length is printed To stop measuring click your right mouse button 3 6 2 Measure areas SE Also areas can be measured The window only shows the accumulated area size in the measure window see figure 2 Figure 2 Measure tools in action Measure 7 oO x a Measure lines b Measure areas 3 7 Projects The state of your QGIS session is considered a Project QGIS works on one project at a time Settings are either considered as being per project or as a default for new projects see Section 3 8 QGIS can save the state of your workspace into a project file using the menu option File gt Save Project Loading saved projects is a similar process The kinds of information saved in a project file include QGIS 0 9 1 User and Installation Guide 17 3 8 GUI Options e Layers added Layer properties including symbolization e Projection for the map view e Last viewed extent The project file is saved in XML format so it is possible to edit the file outside QGIS if you know what you are doing The file format was update
179. roup The content of the right mouse button context menu depends on if the loaded legend item you hold your mouse over is a raster or a vector layer For GRASS vector layers the toggle editing is not available See section 8 5 for infos on editing GRASS vector layers e Right mouse button menue for raster layers Zoom to layer extend Zoom to best scale 100 Show in overview Remove Properties Rename Add Group Expand all Collapse all Show file groups e Right mouse button menue for vector layers Zoom to layer extend Show in overview Remove Open attribute table Toggle editing not available for GRASS layers Save as shapefile Save selection as shapefile Properties Rename Add Group Expand all Collapse all QGIS 0 9 1 User and Installation Guide 13 3 4 QGIS GUI Show file groups e Right mouse button menue for layer groups Remove Rename Add Group Expand all Collapse all Show file groups If several vector data sources have the same vector type and the same attributes their symbolisations may be grouped This means that if the symbolisation of one data source is changed the others automatically have the new symbolisation as well To group symbologies open the right click menu in the legend window and choose Show file groups The file groups of the layers appear It is now possible to drag a file from one f
180. ry between lake and forest is a road so it can have a different attribute table The layer of the feature is defined by layer inside GRASS Layer is the number which defines if there are more than one layer inside the dataset e g if the geometry is forest or lake For now it can be only a number in the future GRASS will also support names as fields in the user interface Attributes can be stored in external database tables for example DBF PostgreSQL MySQL SQLITES etc QGIS 0 9 1 User and Installation Guide 66 8 5 Digitizing and Editing Tools Attributes in database tables are linked to geometry elements using category Category key ID is an integer attached to geometry primitives and it is used as the link to one column in the database table Tip 29 LEARNING THE GRASS VECTOR MODEL The best way to learn the GRASS vector model and its capabilities is to download one of the many GRASS Tutorials where the vector model is described more deeply See http grass itc it gdp manuals php for more information books and tutorials in several languages 8 5 Digitizing and Editing Tools N The digitizing tools for GRASS vector layers are accessed using the Edit GRASS Vector Layer tool on the toolbar Make sure you have loaded a GRASS vector and it is the selected layer in the legend before clicking on the edit tool If you would like to create a new GRASS vector you need to use the too
181. s Only those formats that have been well tested will appear in the list of file types when loading a raster into QGIS Other untested formats can be loaded by selecting the All other files filter Formats known to work in QGIS are indicated in bold e Arc Info ASCII Grid e Arc Info Binary Grid adf e Microsoft Windows Device Independent Bitmap bmp e BSB Nautical Chart Format kap e VTP Binary Terrain Format bt e CEOS Spot for instance e First Generation USGS DOQ doq e New Labelled USGS DOQ doq e Military Elevation Data dt0 dt1 e ERMapper Compressed Wavelets ecw e ESRI hdr Labelled e ENVI hdr Labelled Raster e Envisat Image Product n1 e EOSAT FAST Format e FITS fits e Graphics Interchange Format gif e GRASS Rasters e TIFF GeoTIFF tif e Hierarchical Data Format Release 4 HDF4 e Erdas Imagine img 8GRASS raster support is supplied by the QGIS GRASS data provider plugin QGIS 0 9 1 User and Installation Guide 123 A 2 GDAL Raster Formats e Atlantis MFF2e e Japanese DEM mem e JPEG JFIF jpg e JPEG2000 jp2 j2k e JPEG2000 jp2 j2k e NOAA Polar Orbiter Level 1b Data Set AVHRR e Erdas 7 x LAN and GIS e In Memory Raster e Atlantis MFF e Multi resolution Seamless Image Database MrSID e NITF e NetCDF e OGDI Bridge e PCI aux Labelled e PCI Geomatics Database File e Portable Network Graphics png e Netpbm ppm pgm e USGS
182. s in your raster You must first generate the raster statistics by clicking the Refresh button You can choose which bands to display by selecting them in the list box at the bottom right of the dialog Two different chart types are allowed Barcharts and Linegraphs Once you view the histogram you ll notice that the band statistics have been populated on the meta data tab QGIS 0 9 1 User and Installation Guide 49 6 Working with OGC Data QGIS supports WMS and WFS as data sources The support for WFS is preliminary at this time WMS support is native WFS is implemented using a plugin 6 1 What is OGC Data The Open Geospatial Consortium OGC is an international organization with more than 300 com mercial governmental nonprofit and research organisations worldwide lts members develop and implement standards for geospatial content and services GIS data processing and exchange Describing a basic data model for geographic features an increasing number of specifications are developed to serve specific needs for interoperable location and geospatial technology including GIS Further information can be found under http www opengeospatial org Important OGC specifications are e WMS Web Map Service e WFS Web Feature Service e WCS Web Coverage Service e CAT Web Catalog Service e SFS Simple Features for SQL e GML Geography Markup Language OGC services are increasingly being used to exchange geosp
183. s not issued by a trusted authority Use the fingerprint to validate the certificate manually Certificate information Hostname svn qgis org Valid from Apr 1 00 30 47 2006 GMT until Mar 21 00 30 47 2008 GMT Issuer Developer Team Quantum GIS Anchorage Alaska US Fingerprint 2f cd f1 5a c7 64 da 2b d1 34 a5 20 c6 15 67 28 33 ea 7a 9b R eject accept t emporarily or accept p ermanently suggest you press p to accept the key permanently D 7 Configure the build CMake supports out of source build so we will create a build dir for the build process By convention build my software into a dir called apps in my home directory If you have the correct permissions you may want to build straight into your Applications folder although personally dont really recommend this The instructions below assume you are building into a pre existing HOME apps directory cd qgis mkdir build cd build cmake D CMAKE_INSTALL_PREFIX HOME apps D CMAKE_BUILD_TYPE Release To use a specific GRASS version You can optionally use the following cmake invocation with modi fications to suite your system thanks William Kyngesburye for this hint cmake D CMAKE_INSTALL_PREFIX HOME apps D GRASS_INCLUDE_DIR Applications GRASS 6 3 app Contents Resources include D GRASS_PREFIX Applications GRASS 6 3 app Contents Resources D CMAKE_BUILD_TYPE Release D 8 GEOS Issues had some issues with GEOS
184. se custom install These instructions assume you are installing into the default path of C Program Files Microsoft Platform SDK for Windows Server 2003 R2 We will go for the minimal install that will give us a working environment so on the custom installation screen made the following choices Configuration Options Register Environmental Variables Yes Microsoft Windows Core SDK Tools Yes Tools AMD 64 Bit No unless this applies Tools Intel 64 Bit No unless this applies Build Environment Build Environment AMD 64 Bit No unless this applies Build Environment Intel 64 Bit No unless this applies Build Environment x86 32 Bit Yes Documentation No Redistributable Components Yes Sample Code No Source Code No AMD 64 Source No Intel 64 Source No Microsoft Web Workshop Yes needed for shlwapi h Build Environment Yes Documentation No Sample Code No Tools No Microsoft Internet Information Server IIS SDK No Microsoft Data Access Services MDAC SDK Yes needed by GDAL for odbc Tools QGIS 0 9 1 User and Installation Guide 157 H 4 Install Microsoft Platform SDK2 Tools AMD 64 Bit No Tools AMD 64 Bit No Tools x86 32 Bit Yes Build Environment Tools AMD 64 Bit No Tools AMD 64 Bit No Tools x86 32 Bit Yes Documentation No Sample Code No Microsodt Installer SDK No Microsoft Table PC SDK No
185. section and environment setup Loosely based on Original C Tutorial 2 by Tim Sutton ported to Python by Martin Dobias with enhancements by Gary Sherman for FOSS4G2007 Licensed under the terms of GNU GPL 2 from PyQt4 QtCore import from PyQt4 QtGui import from qgis core import O ON DAF WYN SB from qgis gui import Rh e e O import sys m N import os Import our GUI from mainwindow_ui import Ui_MainWindow e e re o Ae Ww Import our resources icons mn O import resources ER N QGIS 0 9 1 User and Installation Guide 111 12 2 Creating the MainWindow 18 Environment variable QGISHOME must be set to the 0 9 install directory 19 before running this application 20 qgis_prefix os getenv QGISHOME Some of this should look familiar from our plugin especially the PyQt4 and QGIS imports Some specific things to note are the import of our GUI in line 14 and the import of our resources file on line 16 Our application needs to know where to find the QGIS installation Because of this we set the QGISHOME environment variable to point to the install directory of QGIS 0 9 In line 20 we store this value from the environment for later use Next we need to create our MainWindow class which will contain all the logic of our application 21 class MainWindow QMainWindow Ui_MainWindow 22 23 def __init__ self 24 QMainWindow __init__ self 25 26 Required by Qt4 to in
186. ser and Installation Guide 115 123 Finishing Up That s the heart of the application and completes the MainWindow class 12 3 Finishing Up The remainder of the code shown below creates the QgsApplication object sets the path to the QGIS install sets up the main method and then starts the application The only other thing to note is that we move the application window to the upper left of the display We could get fancy and use the Qt API to center it on the screen 120 def main argv 121 create Qt application 122 app QApplication argv 123 124 Initialize qgis libraries 125 QgsApplication setPrefixPath qgis_prefix True 126 QgsApplication initQgis 127 128 create main window 129 wnd MainWindow 130 Move the app window to upper left 131 wnd move 100 100 132 wnd show 133 134 run 135 retval app exec_ 136 137 exit 138 QgsApplication exitQgis 139 sys exit retval 140 141 142 if __name__ __main__ 143 main sys argv 12 4 Running the Application Now we can run the application and see what happens Of course if you are like most developers you ve been testing it out as you went along Before we can run the application we need to set some environment variables On Linux or OS X QGIS 0 9 1 User and Installation Guide 116 12 4 Running the Application export LD_LIBRARY_PATH HOME qgis_09 lib export PYTHONPATH HOME qgis_09 share qgis python export QGI
187. stgreSQL gt e for gps plugin expat gt 1 95 is OK e for mapserver export and PyQGIS Python gt probably 2 3 e for PyQGIS SIP gt 4 5 PyQt gt 4 1 Recommended runtime deps e for gps plugin gosbabel C Building under windows using msys C 1 MSYS MSYS provides a unix style build environment under windows We have created a zip archive that contains just about all dependencies Get this http qgis org uploadfiles msys msys zip and unpack to c msys If you wish to prepare your msys environment yourself rather than using our pre made one detailed instructions are provided elsewhere in this document C 2 Qt4 3 Download qt4 3 opensource precompiled edition exe and install including the download and install of mingw from here http www trolltech com developer downloads qt windows When the installer will ask for MinGW you don t need to download and install it just point the installer to c msys mingw When Qt installation is complete Edit C Qt 4 3 0 bin qtvars bat and add the following lines set PATH PATHZ C msys local bin c msys local lib set PATH PATH C Program Files Subversion bin QGIS 0 9 1 User and Installation Guide 126 C 3 Flex and Bison suggest you also add C Qt 4 3 0 bin to your Environment Variables Path in the windows system preferences If you plan to do some debugging you ll need to compile debug version of Qt C Q
188. t 4 3 0 bin qtvars bat compile_debug Note there is a problem when compiling debug version of Qt 4 3 the script ends with this message mingw32 make No rule to make target debug Stop To compile the debug version you have to go out of src directory and execute the following command c Qt 4 3 0 make C 3 Flex and Bison Note think this section can be removed as it should be installed int the msys image already TS Get Flex http sourceforge net project showfiles php group_id 236178package_id 16424 the zip bin and extract it into c msys mingw bin C 4 Python stuff optional Follow this section in case you would like to use Python bindings for QGIS To be able to compile bindings you need to compile SIP and PyQt4 from sources as their installer doesn t include some development files which are necessary C 4 1 Download and install Python use Windows installer It doesn t matter to what folder you ll install it http python org download C 4 2 Download SIP and PyQt4 sources htmladdnormallink http www riverbankcomputing com Downloads sip4 htmladdnormallink http www riverbankcomputing com Downloads PyQt4 GPL Extract each of the above zip files in a temporary directory Make sure to get versions that match your current Qt installed version QGIS 0 9 1 User and Installation Guide 127 C 5 Subversion C 4 3 Compile SIP c Qt 4 3 0 bin gtvars bat pytho
189. t region to selected map Q Refresh browser window QGIS 0 9 1 User and Installation Guide 71 8 7 GRASS Toolbox The Rename and Delete buttons are only available in your current mapset All other tools also work on maps from other mapsets as well Figure 18 GRASS toolbox GRASS Tools world Il holl Modues Browser aana 000 GRASS Tools world Il holl Raster bluemarble_ng GRASS gt g list rast Rows 2261 bluemarble_ng E naturakarth_001 Columns 2988 E naturakarth_1 N S 0 0166667 E region resolution raster files available in mapset PERMANENT a vector EW 0 0166867 bluemarbe naturakarth naturalearth ost srtm20_topex 8 6 kratze resolution muell naturalsarth_suropa naturalearth west f PERMANENT Norn oT South 27 raster files availabe in mapset holl bluemarble_ng naturalearth_001 naturalearth_1 raster files availabe in mapset kratzenberg LO_SR_W_16200_Ost bgr LC_SR_W_16200_West bgr muell 16 3 Format integer 1bytes GRASS gt g list help Minimum O value Maximum 32767 value Description Lists available GRASS data base files of the user specified data type to stand Usage Data generated by r composite description g list type datatype mapset string Comments r composite Flags red bluemarble_ng red f verbose listing also list map titles green bluemarbl_ng gn blues Paramelers bluemarble_ng
190. tallation Guide 35 4 4 Editing Tip 11 SAVE REGULARLY Remember to toggle Allow editing off or select the Stop editing button regularly This allows you to save your changes thus far and also confirms that your data source can accept all your changes Tip 12 CONCURRENT EDITS This version of QGIS does not track if somebody else is editing a feature at the same time as you The last writer wins Once the layer is in edit mode markers will appear at the vertices You can perform the following editing functions e Add Features point line and polygone e Move Selected Features e Split Selected Feature e Delete Selected Features e Add Vertex of a Feature e Delete Vertex of a Feature e Move Vertex of a Feature e Add Ring e Add Island e Cut Selected Features e Copy Selected Features e Paste Selected Features Adding Features Before you start adding features use the pan and zoom tools to first navigate to the area of interest Then you can use the Capture Point Capture Line or Capture Polygon icon on the toolbar to put the QGIS cursor into digitizing mode For each feature you first digitize the geometry then enter its attributes To digitize the geometry left click on the map area to create the first point of your new feature QGIS 0 9 1 User and Installation Guide 36 4 4 Editing Tip 13 ZOOM IN BEFORE EDITING Before editing a layer you should zoom in to your area of interest first This avo
191. tem A Coordinate Reference System is the OGC terminology for a QGIS Projection Each WMS Layer can be presented in multiple CRSs depending on the capability of the WMS server You may notice that the x changes in the Coordinate Reference System x available header as you select and deselect layers from the Layers section To choose a CRS select Change and a screen similar to Figure 14 in Section 7 2 will appear The main difference with the WMS version of the screen is that only those CRSs supported by the WMS Server will be shown Tip 25 WMS PROJECTIONS For best results make the WMS layer the first layer you add in the project This allows the project projection to inherit the CRS you used to render the WMS layer On the fly projection see Section 7 2 1 can then be used to fit any subsequent vector layers to the project projection In this version of QGIS if you add a WMS layer later and give it a different CRS to the current project projection unpredictable results can occur 6 2 4 Using the Identify Tool Once you have added a WMS server and if any layer from a WMS server is queryable you can then use the dentify tool to select a pixel on the map canvas A query is made to the WMS server for each selection made The results of the query are returned in plain text The formatting of this text is dependent on the particular WMS server used 6 2 5 Viewing Properties Once you have added a
192. th FWTools To create an image from our map e Open a terminal window e If you didn t save your map file in your home directory change to the directory where you saved it e Run shp2img e View the created image Assuming our map file was named mapserver_test map the shp2img command is shp2img m mapserver_test map o mapserver_test png This creates a PNG for us to view containing all the layers that were on when we saved the QGIS project In addition the extent of the PNG will be the same as when we saved the project If you plan to use the map file to serve WMS requests you probably don t have to tweak anything If you plan to use it with a mapping template or a custom interface you may have a bit of manual work to do To see how easy it is to go from QGIS to serving maps on the web take a look at Christopher Schmidt s 5 minute flash video 5 http openlayers org presentations mappingyourdata QGIS 0 9 1 User and Installation Guide 78 10 Map Composer The map composer is a feature that provides limited layout and printing capabilities The composer allows you to add elements such as the QGIS map canvas legend scalebar images and text You can size and position each item and adjust the properties to create your layout The result can be printed exported as an image or exported to SVG To access the map composer click on the Print button in the toolbar or choose Print from the File menu 10 1 Usin
193. these differences 1 when running configure add this argument with grass usr local grass 6 3 cvs 2 when calling g on line 5 which creates libgdal dll add these arguments L usr local grass 6 3 cvs lib lgrass_vect lgrass_dig2 lgrass_dgl lgrass_ rtree lgrass_linkm lgrass_dbmiclient lgrass_dbmibase lgrass_I lgrass_gproj lgrass_vask lgrass_gmath lgrass_gis lgrass_datetime Then again edit gdal config and change line with CONFIG_LIBS CONFIG_LIBS L usr local lib lpng L usr local grass 6 3 cvs lib lgrass_vect lgrass_dig2 lgrass_dgl lgrass_rtree lgrass_linkm lgrass_dbmiclient lgrass_dbmibase lgrass_I lgrass_gproj lgrass_vask lgrass_gmath lgrass_gis lgrass_datetime lz L usr local lib lgdal Now GDAL should be able to work also with GRASS raster layers QGIS 0 9 1 User and Installation Guide 146 F 2 Installing dependencies F 2 5 GEOS Download the sources http geos refractions net geos 2 2 3 tar bz2 Unpack to e g c Amsysllocall src To compile had to patch the sources in file source headers timeval h line 13 Change it from ifdef _WIN32 to if defined _WIN32 amp amp defined _MSC_VER Now in MSYS console go to the source directory and run configure prefix usr local make make install F 2 6 SQLITE You can use precompiled DLL no need to compile from source Download this archive http www sqlite org sqlitedll 3_3_17 zip
194. thon is pretty easy Some plugins won t require a GUI at all For example you might write a plugin that returns the map coordinates for the point you click on the map Such a plugin wouldn t require any user input and could use a standard Qt QMessageBox to display the result You can also write plugins for QGIS in C but that s another story You can find tutorials on writing QGIS plugins in both C and Python on the QGIS blog at http blog qgis org QGIS 0 9 1 User and Installation Guide 109 12 Creating Applications One of the goals of QGIS is to provide not only an application but a set of libraries that can be used to create new applications This goal has been realized with the refactoring of libraries that took place after the release of 0 8 With the release of 0 9 development of standalone applications using either C or Python is possible In this chapter we ll take a brief look at the process for creating a standalone Python application The QGIS blog has several examples of creating PyQGIS applications We ll use one of them as a starting point to get a look at how to create an application The features we want in the application are e Load a vector layer e Pan e Zoom in and out e Zoom to the full extent of the layer e Set custom colors when the layer is loaded This is a pretty minimal feature set Let s start by designing the GUI using Qt Designer 12 1 Designing the GUI Since w
195. tions tab Provide a descriptive name for the action The action itself must contain the name of the application that will be executed when the action is invoked You can add one or more attribute field values as arguments to the application When the action is invoked any set of characters that start with a followed by the name of a field will be replaced by the value of that field The special characters will be replaced by the value of the field that was selected from the identify results or attribute table see Using Actions below Double quote marks can be used to group text into a single argument to the program script or command Double quotes will be ignored if proceeded by a backslash Two example actions are shown below e konqueror http www google com search q jnam e konqueror http www google com search q hh In the first example the web browser konqueror is invoked and passed a URL to open The URL per forms a Google search on the value of the nam field from our vector layer Note that the application or script called by the action must be in the path or you must provided the full path To be sure we could rewrite the first example as opt kde3 bin konqueror http www google com search q nam This will ensure that the konqueror application will be executed when the action is invoked The second example uses the notation which does not rely on a particular field for its value When the action is invoked the will b
196. to find them all in c dev cpp qgislibs release Press configure again after the cmakesetup gui appears and when all the red fields are gone and you have made any personalisations to the setup press ok to close the cmake gui Now open Visual Studio Express and do File gt Open gt Project Solution Now open the cmake generated QGIS solution which should be in QGIS 0 9 1 User and Installation Guide 165 H 11 Running and packaging c dev cpp qgis build qgisX X X sln Where X X X represents the current version number of QGIS Currently have only made release built dependencies for QGIS debug versions will follow in future so you need to be sure to select Release from the solution configurations toolbar Next right click on ALL_BUILD in the solution browser and then choose build Once the build completes right click on INSTALL in the solution browser and choose build This will by default install qgis into c program files qgisX X X H 11 Running and packaging To run QGIS you need to at the minimum copy the dlls from c dev cpp qgislibs release bin into the c program files qgisX X X directory QGIS 0 9 1 User and Installation Guide 166 I GNU General Public License GNU GENERAL PUBLIC LICENSE Version 2 June 1991 Copyright C 1989 1991 Free Software Foundation Inc 59 Temple Place Suite 330 Boston MA 02111 1307 USA Everyone is permitted to copy and distribute verbatim copies of this lice
197. to a prefix of usr local tar xvfz PyQt mac lt version number here gt cd PyQt mac lt version number here gt python configure py yes make sudo make install Cd 43 QGIS 0 9 1 User and Installation Guide 133 D 4 Install CMAKE for OSX D 3 5 Additional Dependencies Bison The version of bison available by default on Mac OSX is too old so you need to get a more recent one on your system Download if from curl 0 http ftp gnu org gnu bison bison 2 3 tar Now build and install it to a prefix of usr local tar xvfz bison 2 3 tar gz cd bison 2 3 configure prefix usr local make sudo make install cd sa D 4 Install CMAKE for OSX Get the latest release from here http www cmake org HTML Download html At the time of writing the file grabbed was gz curl 0 http www cmake org files v2 4 cmake 2 4 6 Darwin universal dmg Once downloaded open the dmg and run the installer D 5 Install subversion for OSX The http sourceforge net projects macsvn project has a downloadable build of svn If you are a GUI inclined person you may want to grab their gui client too Get the command line client here curl 0 http ufpr dl sourceforge net sourceforge macsvn Subversion_1 4 2 zip Once downloaded open the zip file and run the installer You also need to install BerkleyDB available from the same At the time of writing the file was here http sourceforge net projects macs
198. tools in the GRASS toolbar that were disabled are now enabled 8 Click on Add GRASS raster layer choose the map name geology and click OK The geology map will be visualized 9 Click on Add GRASS vector layer choose the map name roads and click OK Now the roads map will be overlayed on top of the geology As you see it is very simple to load GRASS raster and vector layers in QGIS See following sections for editing GRASS data and creating new locations Tip 28 GRASS DATA LOADING If you have problems loading data or QGIS terminates abnormally check to make sure you have loaded the GRASS plugin properly as described in Section 8 1 8 3 Creating a Location GRASS stores data in a location which represents a specific area with a specific coordinate system In order to use GRASS data we must import it into a location Here is an example how to create a GRASS location in Albers Equal Area projection with unit meter for the QGIS sample data see Section 3 2 This is not strictly true you can view external data sets without importing them QGIS 0 9 1 User and Installation Guide 64 8 3 Creating a Location 10 11 12 13 Figure 16 Creating a GRASS location in QGIS z 2 x GRASS location Location O Select location alaska_geo Ra Create new location Alaska The GRASS location is a collection of maps for a particular territory or project
199. topo24 wd Savas Save As Cancel Generate world file Generate world file and load layer referencing process and save the resulting world file together with the Tiff In our example we choose linear transformation although a helmert transformation might be sufficient as well Tip 36 CHOOSING THE TRANSFORMATION TYPE The linear affine transformation is a 1st order transformation and used for scaling translation and rotation of geometrically correct images With the helmert transformation you simply add coordinate information to the image like geocooding If your image is contorted you will need to use software that provides 2nd or 3rd order polynomial transformation e g GRASS GIS The points we added to the map will be stored in a spearfish_topo24 tif points file together with the raster image This allows us to reopen the georeferencer plugin and to add new or delete existing QGIS 0 9 1 User and Installation Guide 100 11 6 Using the Georeferencer Plugin points to optimize the result The spearfish_topo24 tif points file of this example shows the points mapX mapY pixelX pixelY 591630 196867999969982 4927104 309682800434530 591647 4 9271e 06 608453 589164100005291 4924878 995150799863040 608458 4 92487e 06 602554 903929700027220 4915579 220743400044739 602549 4 91556e 06 591511 138448899961077 4915952 302661700174212 591563 4 91593e 06 602649 526155399973504 4919088 353569299913943 602618 4 919
200. ude computing 1 distances between geographic locations 2 the amount of area e g square metres within a certain geographic region 3 what geographic features overlap other features 4 the amount of overlap between features 5 the number of locations within a certain distance of another 6 and so on These may seem simplistic but can be applied in all sorts of ways across many disciplines The re sults of analysis may be shown on a map but are often tabulated into a report to support management decisions The recent phenomena of location based services promises to introduce all sorts of other features but many will be based on a combination of maps and analysis For example you have a cell phone that tracks your geographic location If you have the right software your phone can tell you what kind of restaurants are within walking distance While this is a novel application of geospatial technology it is essentially doing geospatial data analysis and listing the results for you This chapter is by Tyler Mitchell http www oreillynet com pub wlg 7053 and used under the Creative Com mons License Tyler is the author of Web Mapping Illustrated published by O Reilly 2005 QGIS 0 9 1 User and Installation Guide 4 2 1 Why is all this so new 2 1 Why is all this so new Well it s not There are many new hardware devices that are enabling mobile geospatial services Many open source geospatial appli
201. udio C command line from Programs menu cd c Program Files PostgreSQL 8 2 bin dumpbin exports bin libpq dll sed nf lib mkdef sed gt lib libpq def cd lib lib def libpq def machine x86 You ll need an sed for that to work in your path e g from cygwin or msys That s almost it You only need to the include and lib path to INCLUDE and LIB in vevars bat respec tively G 2 3 Qt Build Qt following the instructions here http wiki qgis org qgiswiki Building_QT_4 with_Visual_C 2B 2B_2005 G 2 4 Proj 4 Get proj 4 source from here http proj maptools org Using the Visual Studio command prompt ensures the environment is setup properly run the fol lowing in the src directory nmake f makefile vc QGIS 0 9 1 User and Installation Guide 151 G 2 Download Install Dependencies Install by running the following in the top level directory setting PROJ_DIR as appropriate set PROJ_DIR c lib proj mkdir PROJ_DIR Abin mkdir PROJ_DIR Xinclude mkdir PROJ_DIR Alib copy src dll PROJ_DIRZ bin copy src exe PROJ_DIR Abin copy src h PROJ_DIR include copy src lib PROJ_DIR Xlib This can also be added to a batch file G 2 5 GSL Get gs source from here http david geldreich free fr downloads gsl 1 9 windows sources zip Build using the gsl sin file G 2 6 GEOS Get geos from svn svn checkout http svn refractions net geos trunk g
202. ur screen should now look a bit like Figure 12 which shows the response provided by the NASA JPL OnEarth WMS server Image Encoding The Image encoding section now lists the formats that are supported by both the client and server Choose one depending on your image accuracy requirements Tip 22 IMAGE ENCODING You will typically find that a WMS server offers you the choice of JPEG or PNG image encoding JPEG is a lossy compression format whereas PNG faithfully reproduces the raw raster data Use JPEG if you expect the WMS data to be photographic in nature and or you don t mind some loss in picture quality This trade off typically reduces by 5 times the data transfer requirement compared to PNG Use PNG if you want precise representations of the original data and you don t mind the increased data transfer requirements QGIS 0 9 1 User and Installation Guide 52 6 2 WMS Client Figure 12 Dialog for adding a WMS server showing its available layers gt Add Layer s from a Server ee eS y Server Connections NASA Onearth E m Image encoding PNG JPEG Layers Name daily aqua Daily composite of MODIS AQUA images BMNG Blue Marble Next Generation Global MODIS derived image modis Blue Marble Global MODIS derived image default visual huemapped_srtm SRTM derived global ekvation 3 arc second hue mapped srimplus Global 1km elevation seamless SRTM land elevatio
203. uses for actions For example if you have a point layer containing locations of images or photos along with a file name you could create an action to launch a viewer to display the image You could also use actions to launch web based reports for an attribute field or combination of fields specifying them in the same way we did in our Google search example QGIS 0 9 1 User and Installation Guide 34 4 4 Editing 4 4 Editing QGIS supports basic capabilities for editing spatial data Before reading any further you should note that at this stage editing support is still preliminary Before performing any edits always make a backup of the dataset you are about to edit Note the procedure for editing GRASS layers is different see Section 8 5 for details 4 4 1 Setting the Snap Tolerance Before we can edit vertices we need to set the snapping tolerance This is the distance QGIS uses to search for the polygon and vertex you are trying to edit when you click on the map If you aren t within the snap tolerance QGIS won t find and select the vertex for editing Tolerance is set in map units so you may find you need to experiment to get it set right If you specify too big of a tolerance QGIS may snap to the wrong vertex especially if you are dealing with a large number of vertices in close proximity Set it too small and it won t find anything and it will pop up an annoying warning to that effect To set the sn
204. version of QGIS Some of the more notable exceptions follow Editing WMS Layer Settings Once you ve completed the Add WMS layer procedure there is no ability to change the settings A workaround is to delete the layer completely and start again WMS Servers Requiring Authentication Only public WMS servers are accessible There is no ability to apply a user name and password combination as an authentication to the WMS server 6 3 WFS Client In QGIS a WFS layer behaves pretty much like any other vector layer You can identify and select features and view the attribute table The WFS plugin doesn t support editing at this time Adding a WFS layer is very similar to the procedure used with WMS The difference is there are no default servers defined so we have to add our own 6 3 1 Loading a WFS Layer As an example we use the DM Solutions WFS server and display a layer The URL is http www2 dmsolutions ca cgi bin mswfs_gmap VERSION 1 0 0 amp SERVICE wf s amp REQUEST GetCapabilities 1 Make sure the WFS plugin is loaded if not open the Plugin Manager and load it 2 Click on the Add WFS Layer tool on the plugins toolbar 3 Click on New 4 Enter DM Solutions as the name 5 Enter the URL see previous page 6 Click OK QGIS 0 9 1 User and Installation Guide 56 6 3 WES Client 7 Choose DM Solutions from the drop down box 8 Click Connect 9 Wait for the list of layers to be populated 10 Click on t
205. vn QGIS 0 9 1 User and Installation Guide 134 D 6 Check out QGIS from SVN curl 0 http ufpr dl sourceforge net sourceforge macsvn Berkeley_DB_4 5 20 zip Once again unzip this and run the installer therein Lastly we need to ensure that the svn commandline executeable is in the path Add the following line to the end of etc bashrc using sudo sudo vim etc bashrc And add this line to the bottom before saving and quiting export PATH usr local bin PATH usr local pgsql bin usr local bin needs to be first in the path so that the newer bison that will be built from source further down is found before the bison which is very old that is installed by MacOSX Now close and reopen your shell to get the updated vars D 6 Check out QGIS from SVN Now we are going to check out the sources for QGIS First we will create a directory for working in mkdir p dev cpp cd dev cpp Now we check out the sources Trunk svn co https svn qgis org repos qgis trunk qgis qgis For svn 0 8 branch svn co https svn qgis org repos qgis branches Release 0_8_0 qgis0 8 For svn 0 9 branch svn co https svn qgis org repos qgis branches Release 0_9_0 qgis0 9 QGIS 0 9 1 User and Installation Guide 135 D 7 Configure the build The first time you check out QGIS sources you will probably get a message like this Error validating server certificate for https svn qgis org 443 The certificate i
206. witches to the Output tab and you will see information about the process If all goes well you will see Successfully finished at the end Manual This tab shows the help page of each GRASS module You can have a look at the manual page if you want to get a deeper knowledge about the purpose of the module You may have recognized that some modules have more options and parameters than given in the Options tab This is correct and done by design To keep the GUI simple as possible only the needed options and parameters are put in the Options tab But you can always use the GRASS shell to run the module with all its parameters Tip 32 DISPLAY RESULTS IMMEDIATELY If you want to display your calculation results immediately in your map canvas you can use the View Output button at the bottom of the module tab 8 7 2 GRASS Browser Another useful feature is the GRASS browser In Figure 19 a you can see the current location with its mapsets The browser on the left allows you to browse through all your mapsets inside your selected location The right side of the browser window shows some meta information for the selected dataset e g resolution bounding box data source attribute table for vector data The toolbar inside the browser tab gives you the following tools for the selected dataset E Add selected map to canvas e Copy selected map Rename selected map R Delete selected map e O Set curren
207. x coloured blocks on the page for the various studio family members vb c j etc Simply choose your language under the select your language combo under the yellow C block and your download will begin Under internet explorer had to disable popup blocking for the download to be able to commence Once the setup commences you will be prompted with various options Here is what chose Send useage information to Microsoft No Install options Graphical IDE Yes Microsoft MSDN Express Edition No Microsoft SQL Server Express Edition No Install to folder C Program Files Microsoft Visual Studio 81 default It will need to download around 90mb of installation files and reports that the install will consume 554mb of disk space H 4 Install Microsoft Platform SDK2 Go to this page http msdn2 microsoft com en us express aa700755 aspx Start by using the link provided on the above page to download and install the platform SDK2 QGIS 0 9 1 User and Installation Guide 156 H 4 Install Microsoft Platform SDK2 The actual SDK download page is once again a bit confusing since the links for downloading are hidden amongst a bunch of other links Basically look for these three links with their associated Download buttons and choose the correct link for your platform PSDK amd64 exe 1 2 MB Download PSDK ia64 exe 1 3 MB Download PSDK x86 exe 1 2 MB Download When you install make sure to choo
208. y Can Zoom In Whether or not this layer can be zoomed in by the server This version of QGIS assumes all WMS layers have this set to Yes Deficient layers may be rendered strangely Cascade Count WMS servers can act as a proxy to other WMS servers to get the raster data for a layer This entry shows how many times the request for this layer is forwarded to peer WMS servers for a result Fixed Width Fixed Height Whether or not this layer has fixed source pixel dimensions This version of QGIS assumes all WMS layers have this set to nothing Deficient layers may be rendered strangely WGS 84 Bounding Box The bounding box of the layer in WGS 84 coordinates Some WMS servers do not set this correctly e g UTM coordinates are used instead If this is the case then the initial view of this layer may be rendered with a very zoomed out appearance by QGIS The WMS webmaster should be informed of this error which they may know as the WMS XML elements LatLonBoundingBox EX_GeographicBoundingBox or the CRS 84 BoundingBox Available in CRS The projections that this layer can be rendered in by the WMS server These are listed in the WMS native format Available in style The image styles that this layer can be rendered in by the WMS server QGIS 0 9 1 User and Installation Guide 55 6 3 WES Client 6 2 6 WMIS Client Limitations Not all possible WMS Client functionality had been included in this
209. y Lars Luthman Godofredo Contreras Magnus Homann Martin Dobias David Willis Juergen E Fischer With thanks to Tisham Dhar for preparing the initial msys environment to Tom Elwertowski and William Kyngesburye for help in the MAC OSX Section and to Tara Athan for revisions Copyright 2004 2007 Quantum GIS Project Internet http www qgis org Contents Contents Title i Preamble ii Table of Contents iii List of figures X List of tables xii 1 Forward 1 Wel AA 1 1 2 Whats Newin0 9 20 0000 ee ee 3 2 Introduction To GIS 4 2 1 Why is all this so new sd ese he a Ce ede PARE DSS ED old oe Te 5 2 11 Raster Datas droits ara a ae a ele des dei oe we Ee te ae A RA 5 2 1 2 MectorData ee 6 3 Getting Started 7 3 1 Installation 2 2 ee 7 82 Sample Data sar 62 atea HG ae e a OB Ee OS SS ee al 7 6 3 Starti g QGIS ases ia a eta a ech a oe E OE BA ee ee Ga E ia a 8 3 3 1 Command Line Options s 40d edi e E weet bee oe ED 8 e MEA A A BH Oe Ge eee ee eee oe eng ngs 9 9 41 M nu Ban se ae ali ae Ra a ae de a ee a WE a ee ae ee oe W 11 3A 2 NOOIDAUS sea Be wrth a cera hk sa 6 Saks 05H e A
210. y vector layer This can be done with the slider right below the legend type see fig 5 This is very useful for overlaying several vector layers 4 3 2 General Tab The General tab is essentially like that of the raster dialog It allows you to change the display name set scale dependent rendering options create a spatial index of the vector file only for OGR supported formats and PostGIS and view or change the projection The Query Builder button allows you to create a subset of the features in the layer but this button currently only is available when you open the attribute table and select the Advanced button 4 3 3 Metadata Tab The Metadata tab contains information about the layer including specifics about the type and location number of features feature type and the editing capabilities The projection and attribute fields and their data type are displayed on this tab This is a quick way to get information about the layer 4 3 4 Labels Tab The Labels tab allows you to enable labeling features and control a number of options related to placement style and buffering We will illustrate this by labelling the lakes shapefile of the qgis_example_dataset 1 Load the shapefiles alaska shp and lakes shp in QGIS 2 Zoom in a bit to your favorite area with some lakes 3 Make the akes layer active 4 Open the properties dialog 5 Click on the Labels tab 6 Check the Display labels checkbox to enable l
211. ysical port in your computer that the GPS device is connected to On Linux this is something like dev ttySO or dev ttyS1 and on Windows it s COM1 or COM2 When you click OK the data will be downloaded from the device and appear as a layer in QGIS QGIS 0 9 1 User and Installation Guide 91 11 3 Using the GPS Plugin Figure 28 File selection dialog for the import tool L Selecttile and tormatto import Look in S home dassau 7 o o w Ba je backup bilder 6 muell oertliche E bikler_grass openapp_isodist a daten E Privates E Desktop programmierung downl Ca radardaten r E firefox rer grassdata Ea SOURCES E joomla 3 SPECS larissa vmware Mail montmartre File name Files of type CoPilot Flight Planner DNA Delorme GPS Log Delorme Routes Delorme Street Atlas 2004 Plus EasyGPS Binary Format Fugawi GPSDrive GPSUtil GPSman EM 11 3 6 Uploading GPS data to a device You can also upload data directly from a vector layer in QGIS to a GPS device using the tool Upload to GPS The layer must be a GPX layer To do this you simply select the layer that you want to upload the type of your GPS device and the port that its connected to Just as with the download tool you can specify new device types if your device isn t in the list This tool is very useful togeth

QGIS 0.9.1@let@token User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents