Diskussion:Workshop QGIS Python GeoPython 2017: Unterschied zwischen den Versionen

Aus Geoinformation HSR
Wechseln zu: Navigation, Suche
K (Using Expression Functions =)
(Usage of Expression Functions)
 
(35 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
 
See also
 
See also
* https://github.com/simran001/PyQGIS_workshop
+
* Step-by-step guide for the workshop on [https://github.com/simran001/GeoPython-Workshop/blob/master/README.md Github.]
 +
* https://github.com/simran001/PyQGIS
 
* https://etherpad.coredump.ch/p/Python-Workshop
 
* https://etherpad.coredump.ch/p/Python-Workshop
  
''Custom Python Expression Functions for QGIS''
+
== Usage of Expression Functions ==
  
 +
Examples where Expression Functions (EFns) can be used in QGIS are: symbology, labeling, calculating fields, defining virtual fields, selecting and filtering data, layouts, atlas serial printing and reports, map tips, custom python expressions, parameters for processing, and many more.
  
=== Using Expression Functions ===
+
This is a more systematic list:
 +
# "Server-side" / data-related:
 +
## "Select features using an expression" based on a field(Layer property).
 +
## "Filtering features" while loading from source. See form view of Attribute table (button on bottom right corner) > click on 'Show All Features' (bottom left) and select 'Advanced Filter (Expression)'.
 +
## "Layer > Properties > Tab Fields" in Button "Text Edit" in default- and in constraints field.
 +
## "Layer > Properties > Tab Style" in "Label with" field.
 +
## "Field Calculator" to defining new or virtual fields (Layer property).
 +
## "Conditional formatting" of a field in Attribute table (Create a new rule and set the condition to the output of a custom EFn).
 +
# Analysis-related:
 +
## "Statistics Panel" / "Statistical Summary" of a field.
 +
## "Atlas Generation" in the Print Composer. Project > Print Composer > Check 'generate an atlas' > Set EFn based values for page name, filter and output filename.
 +
## Processing
 +
# "Client-side" / style-related:
 +
## "Map Tip" tool (Layer property).
 +
## "Rule based labeling" (drop-down menu) in Layer Properties > Labels; click on '+' button and add a EFn based filter to a field.
 +
## Part of "Geometry generator" for geometry field in "Style > Symbol Layer Type"
  
Where are Expression Functions used?
+
== Possible examples of custom Custom Expression Functions ==
* Any place where expressions are allowed, e.g. in Attribute Table as Select-Filter, Label-Properties, in Field Calculator when creating/updatin fields.
+
# Function doing something "local" like from other field(s).
* Processing => Refactor fields
+
# Functions reading something like a "Singleton" like a system environment variable (usage "env('USERNAME')") layer properties or number sequence (spcial Plugin needed?).  
 
 
How to use:
 
* See http://docs.qgis.org/testing/en/docs/user_manual/working_with_vector/expression.html?highlight=expression
 
*
 
 
 
Possible examples:
 
# Function doing something "local".
 
# Function reading from other field(s).
 
# Functions aka "Singleton" like system environment variables (usage "env('USERNAME')") layer properties or number sequence (spcial Plugin needed?).  
 
 
# Function for remote webservice: geocoding (reading from the internet).
 
# Function for remote webservice: geocoding (reading from the internet).
# Function reading from other layers (outlook, rather candidate for a plugin).
+
# Function reading from other layers (out of scope for a workshop rather, ev. also a processing or plugin candidate).
 
 
=== Writing Expression Functions ===
 
 
 
How to install and share an Expression Function?
 
* Save and (Re-)Load in "Function Edtior" (saves to "%USERHOME%.qgis2\python\expressions" (where %USERHOME% under Windows is e.g. "C:\Users\sfkeller\").
 
* Add Fn. to qgis2/python/startup.py
 
* Add Fn. to the "Expresion Plus Plugin"
 
* Add Fn. to any (own and loaded) QGIS plugin
 
 
 
Debugging:
 
* use "print"
 
* use pdb (see QGIS docs and giswiki)
 
* (use Remote Debug Plugin)
 
 
 
  
 
== Notes ==
 
== Notes ==
Zeile 46: Zeile 40:
 
Plugins:
 
Plugins:
 
* ExpressionPlus (for QGIS) Extra functions for the expression engine which didn't make it into QGIS 2.0: https://plugins.qgis.org/plugins/qgsexpressionsplus/
 
* ExpressionPlus (for QGIS) Extra functions for the expression engine which didn't make it into QGIS 2.0: https://plugins.qgis.org/plugins/qgsexpressionsplus/
* refFunctions
+
* refFunctions: http://plugins.qgis.org/plugins/refFunctions/
* spatialJoin
+
* spatialJoin (depends on refFunctions): http://plugins.qgis.org/plugins/spatialJoin/
* AutoFields (obsolete) - Automatic Field Calculator Plugin: http://plugins.qgis.org/plugins/AutoFields/  
+
* AutoFields (obsolete?) - Automatic Field Calculator Plugin: http://plugins.qgis.org/plugins/AutoFields/  
  
 
Open:
 
Open:
 
* How to store a value in PyQGIS? Use QSettings (/.qgis) or QGISProject (.qgs)
 
* How to store a value in PyQGIS? Use QSettings (/.qgis) or QGISProject (.qgs)
 
 
 
 
 
 
* Resource Sharing Plugin (http://plugins.qgis.org/plugins/qgis_resource_sharing/). e.g. https://github.com/mara91/qgis_styles.git
 
* Resource Sharing Plugin (http://plugins.qgis.org/plugins/qgis_resource_sharing/). e.g. https://github.com/mara91/qgis_styles.git

Aktuelle Version vom 20. April 2018, 01:10 Uhr

See also

Usage of Expression Functions

Examples where Expression Functions (EFns) can be used in QGIS are: symbology, labeling, calculating fields, defining virtual fields, selecting and filtering data, layouts, atlas serial printing and reports, map tips, custom python expressions, parameters for processing, and many more.

This is a more systematic list:

  1. "Server-side" / data-related:
    1. "Select features using an expression" based on a field(Layer property).
    2. "Filtering features" while loading from source. See form view of Attribute table (button on bottom right corner) > click on 'Show All Features' (bottom left) and select 'Advanced Filter (Expression)'.
    3. "Layer > Properties > Tab Fields" in Button "Text Edit" in default- and in constraints field.
    4. "Layer > Properties > Tab Style" in "Label with" field.
    5. "Field Calculator" to defining new or virtual fields (Layer property).
    6. "Conditional formatting" of a field in Attribute table (Create a new rule and set the condition to the output of a custom EFn).
  2. Analysis-related:
    1. "Statistics Panel" / "Statistical Summary" of a field.
    2. "Atlas Generation" in the Print Composer. Project > Print Composer > Check 'generate an atlas' > Set EFn based values for page name, filter and output filename.
    3. Processing
  3. "Client-side" / style-related:
    1. "Map Tip" tool (Layer property).
    2. "Rule based labeling" (drop-down menu) in Layer Properties > Labels; click on '+' button and add a EFn based filter to a field.
    3. Part of "Geometry generator" for geometry field in "Style > Symbol Layer Type"

Possible examples of custom Custom Expression Functions

  1. Function doing something "local" like from other field(s).
  2. Functions reading something like a "Singleton" like a system environment variable (usage "env('USERNAME')") layer properties or number sequence (spcial Plugin needed?).
  3. Function for remote webservice: geocoding (reading from the internet).
  4. Function reading from other layers (out of scope for a workshop rather, ev. also a processing or plugin candidate).

Notes

Collected (special) use cases:

Plugins:

Open: