|
| 1 | +# TAGLINE |
| 2 | + |
| 3 | +Open-source Geographic Information System |
| 4 | + |
| 5 | +# TLDR |
| 6 | + |
| 7 | +**Launch QGIS** |
| 8 | + |
| 9 | +```qgis``` |
| 10 | + |
| 11 | +**Open a specific project file** |
| 12 | + |
| 13 | +```qgis --project [path/to/project.qgs]``` |
| 14 | + |
| 15 | +**Open QGIS with specific layers** |
| 16 | + |
| 17 | +```qgis [path/to/file.shp] [path/to/raster.tif]``` |
| 18 | + |
| 19 | +**Export a map snapshot** to an image file |
| 20 | + |
| 21 | +```qgis --snapshot [output.png] --width [1024] --height [768] --project [project.qgs]``` |
| 22 | + |
| 23 | +**Launch without splash screen** and without plugins |
| 24 | + |
| 25 | +```qgis --nologo --noplugins``` |
| 26 | + |
| 27 | +**Export project layers to DXF** |
| 28 | + |
| 29 | +```qgis --dxf-export [output.dxf] --project [project.qgs]``` |
| 30 | + |
| 31 | +**Use a specific user profile** |
| 32 | + |
| 33 | +```qgis --profile [profilename]``` |
| 34 | + |
| 35 | +**Run a Python script on startup** |
| 36 | + |
| 37 | +```qgis --code [path/to/script.py]``` |
| 38 | + |
| 39 | +# SYNOPSIS |
| 40 | + |
| 41 | +**qgis** [_options_] [_file_ ...] |
| 42 | + |
| 43 | +# PARAMETERS |
| 44 | + |
| 45 | +**-p**, **--project** _projectfile_ |
| 46 | +> Load the given QGIS project file. |
| 47 | +
|
| 48 | +**-s**, **--snapshot** _filename_ |
| 49 | +> Emit a snapshot of loaded datasets to the given image file. |
| 50 | +
|
| 51 | +**-w**, **--width** _width_ |
| 52 | +> Width of snapshot to emit. |
| 53 | +
|
| 54 | +**-h**, **--height** _height_ |
| 55 | +> Height of snapshot to emit. |
| 56 | +
|
| 57 | +**-e**, **--extent** _xmin,ymin,xmax,ymax_ |
| 58 | +> Set initial map extent. |
| 59 | +
|
| 60 | +**-n**, **--nologo** |
| 61 | +> Hide the splash screen on startup. |
| 62 | +
|
| 63 | +**-V**, **--noversioncheck** |
| 64 | +> Don't check for new version at startup. |
| 65 | +
|
| 66 | +**-P**, **--noplugins** |
| 67 | +> Don't restore plugins on startup. |
| 68 | +
|
| 69 | +**--nopython** |
| 70 | +> Disable Python support entirely. |
| 71 | +
|
| 72 | +**-B**, **--skipbadlayers** |
| 73 | +> Don't prompt for missing layers. |
| 74 | +
|
| 75 | +**-C**, **--nocustomization** |
| 76 | +> Don't apply GUI customization. |
| 77 | +
|
| 78 | +**-z**, **--customizationfile** _path_ |
| 79 | +> Use given ini file as GUI customization. |
| 80 | +
|
| 81 | +**-f**, **--code** _path_ |
| 82 | +> Run given Python file on load. |
| 83 | +
|
| 84 | +**--profile** _name_ |
| 85 | +> Load a named profile from the profiles folder. |
| 86 | +
|
| 87 | +**-S**, **--profiles-path** _path_ |
| 88 | +> Path to store user profile folders. |
| 89 | +
|
| 90 | +**-l**, **--lang** _language_ |
| 91 | +> Use specified language for the interface. |
| 92 | +
|
| 93 | +**-d**, **--defaultui** |
| 94 | +> Reset user UI settings to default. |
| 95 | +
|
| 96 | +**--hide-browser** |
| 97 | +> Hide the browser widget. |
| 98 | +
|
| 99 | +**--dxf-export** _filename.dxf_ |
| 100 | +> Emit DXF output of loaded datasets. |
| 101 | +
|
| 102 | +**--dxf-extent** _xmin,ymin,xmax,ymax_ |
| 103 | +> Set extent for DXF export. |
| 104 | +
|
| 105 | +**--dxf-symbology-mode** _mode_ |
| 106 | +> Symbology mode for DXF export: none, symbollayer, or feature. |
| 107 | +
|
| 108 | +**-v**, **--version** |
| 109 | +> Display version information and exit. |
| 110 | +
|
| 111 | +**--help** |
| 112 | +> Display help text. |
| 113 | +
|
| 114 | +# DESCRIPTION |
| 115 | + |
| 116 | +**QGIS** is a cross-platform, free and open-source Geographic Information System licensed under the GNU GPLv2+. It supports viewing, editing, and analysis of geospatial data. Written primarily in C++ using the Qt framework, it features extensive Python plugin support. |
| 117 | + |
| 118 | +QGIS handles vector formats (Shapefiles, GeoJSON, GML, KML, GeoPackage, PostGIS, and all OGR-supported formats), raster formats (GeoTIFF, ERDAS IMG, and all GDAL-supported formats), and database sources. It integrates with GRASS GIS for advanced analytical functions and uses GDAL/OGR for data format translation. Features include map composition, spatial analysis, digitizing, geoprocessing, and a rich plugin ecosystem. |
| 119 | + |
| 120 | +For headless or batch processing, use the companion tool **qgis_process** instead. |
| 121 | + |
| 122 | +# CONFIGURATION |
| 123 | + |
| 124 | +User settings stored in **~/.config/QGIS/qgis.conf**. QGIS supports multiple user profiles, each with separate settings, plugins, and project templates. Use **--profile** to switch between profiles or **--profiles-path** to specify a custom profiles directory. |
| 125 | + |
| 126 | +# CAVEATS |
| 127 | + |
| 128 | +QGIS is primarily a GUI application; command-line usage is limited to launching with options, taking snapshots, and DXF export. Python plugins may affect startup time; use **--noplugins** or **--nopython** for faster launches. Large projects with many layers can consume significant memory. The **--configpath** option from QGIS 2.x was replaced by **--profiles-path** in QGIS 3.x. |
| 129 | + |
| 130 | +# HISTORY |
| 131 | + |
| 132 | +Development began in **February 2002** by **Gary Sherman** as **Quantum GIS**, initially a simple PostGIS data viewer for Linux. The first public release came in **July 2002**. It became an **OSGeo** incubator project in **2007**, and version 1.0 was released in **January 2009**. In **September 2013**, version 2.0 was released and the project was officially renamed from Quantum GIS to **QGIS**. Gary Sherman received the **Sol Katz Award** for open-source GIS contributions in **2014**. |
| 133 | + |
| 134 | +# SEE ALSO |
| 135 | + |
| 136 | +[gdalinfo](/man/gdalinfo)(1), [ogr2ogr](/man/ogr2ogr)(1), [ogrinfo](/man/ogrinfo)(1), [gdalwarp](/man/gdalwarp)(1), [gdal_translate](/man/gdal_translate)(1) |
0 commit comments