Справка по функциям калькулятора полей QGIS
Справка по функциям калькулятора полей QGIS
Список функций
Операторы
+
Оператор "плюс"
Возвращает сумму значений полей
Синтаксис
a + b
Аргументы
a, b -> числа или поля содержащие целочисленные или десятичные значения
Пример
"field_name1" + "field_name2"
-
Оператор "минус"
Возвращает разность значений полей
Синтаксис
a - b
Аргументы
a, b -> числа или поля содержащие целочисленные или десятичные значения
Пример
"field_name1" - "field_name2"
*
Оператор "произведение"
Возвращает произведение значений полей
Синтаксис
a * b
Аргументы
a, b -> числа или поля содержащие целочисленные или десятичные значения
Пример
"field_name1" * "field_name2"
/
Оператор "частное"
Возвращает частное значений полей
Синтаксис
a / b
Аргументы
a, b -> числа или поля содержащие целочисленные или десятичные значения
Пример
"field_name1" / "field_name2"
%
Оператор
Синтаксис
Аргументы
Пример
^
Оператор "Степень"
Возвращает результат возведения числа a в степень b.
Синтаксис
a ^ b
Аргументы
a, b -> числа или поля содержащие целочисленные или десятичные значения
Пример
"field_name1" ^ 2
"field_name1" ^ "field_name2"
=
Оператор "равно"
Синтаксис
Аргументы
Пример
>
Оператор "больше"
Синтаксис
Аргументы
Пример
<
Оператор "меньше"
Синтаксис
Аргументы
Пример
<>
Оператор "не равно"
Синтаксис
Аргументы
Пример
<=
Оператор "меньше или равно"
Синтаксис
Аргументы
Пример
>=
Оператор "больше или равно"
Синтаксис
Аргументы
Пример
||
Оператор конкатенации
Синтаксис
Аргументы
Пример
LIKE
Оператор
Синтаксис
Аргументы
Пример
ILIKE
Оператор
Синтаксис
Аргументы
Пример
IS
Оператор
Синтаксис
Аргументы
Пример
OR
Оператор "или"
Синтаксис
Аргументы
Пример
AND
Оператор "и"
Синтаксис
Аргументы
Пример
NOT
Оператор "не"
Синтаксис
Аргументы
Пример
Математические
Математические функции, такие как квадратный корень, sin и cos.
sqrt
Функция
Синтаксис
Аргументы
Пример
sin
Функция
Синтаксис
Аргументы
Пример
cos
Функция
Синтаксис
Аргументы
Пример
tan
Функция
Синтаксис
Аргументы
Пример
asin
Функция
Синтаксис
Аргументы
Пример
acos
Функция
Синтаксис
Аргументы
Пример
atan
Функция
Синтаксис
Аргументы
Пример
atan2
Функция
Синтаксис
Аргументы
Пример
exp
Функция
Синтаксис
Аргументы
Пример
ln
Функция
Синтаксис
Аргументы
Пример
log10
Функция
Синтаксис
Аргументы
Пример
log
Преобразования
Функции для преобразования одного типа данных в другой, например для преобразования строковых данных в числовые, числовых в строковые.
toint
Функция
Синтаксис
Аргументы
Пример
toreal
Функция
Синтаксис
Аргументы
Пример
tostring
Функция
Синтаксис
Аргументы
Пример
Строковые
Функции для работы со строковыми данными, например замена или преобразование в верхний регистр.
lower
Функция lower()
Преобразует текстовую строку в нижний регистр.
Синтаксис
lower(string)
Аргументы
string -> текстовая строка. Строка, регистр которой необходимо понизить.
Пример
lower('HELLO World') -> 'hello world'
upper
Функция upper()
Преобразует текстовую строку в верхний регистр.
Синтаксис
upper(string)
Аргументы
string -> текстовая строка. Строка, регистр которой необходимо повысить.
Пример
upper('hello WOrld') -> 'HELLO WORLD'
lenght
Функция length()
Возвращает длину строки.
Синтаксис
length(string)
Аргументы
string -> текстовая строка. Строка, длину которой необходимо измерить.
Пример
length('HELLO') -> 5
replace
Функция replace()
Возвращает тестовую строку с определенными заменами.
Синтаксис
replace(string,before,after)
Аргументы
string -> строка. Исходная строка.
before -> строка. Заменяемая часть строки.
after -> строка. Заменяющая часть строки.
Пример
replace('QGIS SHOULD ROCK','SHOULD','DOES') -> 'QGIS DOES ROCK'
regexp_replace
Функция
Синтаксис
Аргументы
Пример
substr
Функция substr()
Возвращает определенную часть строки.
Синтаксис
substr(string,startpos,length)
Аргументы
string -> строка. Исходная полная строка.
startpos -> число. Стартовая позиция откуда следует начинать экстракцию.
length -> is number. Длина экстрагируемой строки.
Пример
substr('HELLO WORLD',3,5) -> 'LLO W'
Геометрические
Функции для операций с геометрией объектов, например для расчета длин и площадей.
xat
Функция xat()
Возвращает координату X (долготу) n-ой точки линии.
Синтаксис
xat(n)
Аргументы
n - целое число, номер n-ой точки линии (индекс начинается с 0; отрицательные значения отсчитываются от последнего значения индекса).
Пример
xat(1) -> градусы, в случае, если полилиния находится в географической системе координат
xat(1) -> метры, в случае, если полилиния в прямоугольной проекции.
yat
Функция yat()
Возвращает координату Y (широту) n-ой точки линии.
Синтаксис
yat(n)
Аргументы
n - целое число, номер n-ой точки линии (индекс начинается с 0; отрицательные значения отсчитываются от последнего значения индекса).
Пример
yat(1) -> градусы, в случае, если полилиния находится в географической системе координат
yat(1) -> метры, в случае, если полилиния в прямоугольной проекции.
$area
Функция $area
Возвращает площадь полигона. Внимание! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Синтаксис
$area
Аргументы
Нет аргументов.
Примеры
$area -> метры, полигональный слой должен быть в прямоугольной проекции.
$length
Функция $area
Возвращает длину линии. Внимание! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Синтаксис
$length
Аргументы
Нет аргументов.
Пример
$length -> метры, линейный слой должен быть в прямоугольной проекции.
$perimeter
Функция $perimeter
Возвращает периметр полигона. Внимание! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Синтаксис
$perimeter
Аргументы
Нет аргументов.
Пример
$perimeter -> метры, линейный слой должен быть в прямоугольной проекции.
$x
Функция $x
Возвращает координату X (долготу) точки. Внимание! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Синтаксис
$x
Аргументы
Нет аргументов.
Пример
$x -> градусы, в случае, если точечный слой находится в географической системе координат.
$x -> метры, в случае, если точечный слой находится в прямоугольной системе координат.
$y
Функция $y
Возвращает координату Y (широту) точки. Внимание! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Синтаксис
$y
Аргументы
Нет аргументов.
Пример
$y -> градусы, в случае, если точечный слой находится в географической системе координат.
$y -> метры, в случае, если точечный слой находится в прямоугольной системе координат.
Записи
$rownum
Функция
Синтаксис
Аргументы
Пример
$id
Функция
Синтаксис
Аргументы
Пример
Поля и значения
Содержит список полей слоя. Конкретные значения поля доступны по правому щелчку мыши.
Выберите значение поля из списка и щелкните по нему правой кнопкой мыши. Появится контекстное меню для загрузки значений из выбранного поля.
Function List
Operators
This group contains operators e.g + - *
+
plus Operator
Return a summ of fields
Syntax
a + b
Arguments
a, b -> integer or real fields
Example
"field_name1" + "field_name2"
-
Operator
Syntax
Arguments
Example
*
Operator
Syntax
Arguments
Example
/
Operator
Syntax
Arguments
Example
%
Operator
Syntax
Arguments
Example
^
Operator
Syntax
Arguments
Example
=
Operator
Syntax
Arguments
Example
>
Operator
Syntax
Arguments
Example
<
Operator
Syntax
Arguments
Example
<>
Operator
Syntax
Arguments
Example
<=
Operator
Syntax
Arguments
Example
>=
Operator
Syntax
Arguments
Example
||
Operator
Syntax
Arguments
Example
LIKE
Operator
Syntax
Arguments
Example
ILIKE
Operator
Syntax
Arguments
Example
IS
Operator
Syntax
Arguments
Example
OR
Operator
Syntax
Arguments
Example
AND
Operator
Syntax
Arguments
Example
NOT
Operator
Syntax
Arguments
Example
Math
This group contains math functions e.g square root, sin and cos
sqrt
function
Syntax
Arguments
Example
sin
function
Syntax
Arguments
Example
cos
function
Syntax
Arguments
Example
tan
function
Syntax
Arguments
Example
asin
function
Syntax
Arguments
Example
acos
function
Syntax
Arguments
Example
atan
function
Syntax
Arguments
Example
atan2
function
Syntax
Arguments
Example
exp
function
Syntax
Arguments
Example
ln
function
Syntax
Arguments
Example
log10
function
Syntax
Arguments
Example
log
function
Syntax
Arguments
Example
Conversions
This group contains functions to convert on data type to another e.g string to integer, integer to string.
toint
function
Syntax
Arguments
Example
toreal
function
Syntax
Arguments
Example
tostring
function
Syntax
Arguments
Example
String
This group contains functions that operate on strings e.g replace, convert to upper case.
lower
lower() function
Converts a string to lower case letters.
Syntax
lower(string)
Arguments
string -> is string. The String to convert to lower case.
Example
lower('HELLO World') -> 'hello world'
upper
upper() function
Converts a string to upper case letters.
Syntax
upper(string)
Arguments
string -> is string. The String to convert to upper case.
Example
upper('hello WOrld') -> 'HELLO WORLD'
lenght
length() function
Returns the length of a string.
Syntax
length(string)
Arguments
string -> is string. The String to count the length of.
Example
length('HELLO') -> 5
replace
replace() function
Returns a string with the the supplied string replaced.
Syntax
replace(string,before,after)
Arguments
string -> is string. The start string.
before -> is string. The string to replace.
after -> is string. The string that will replace before
Example
replace('QGIS SHOULD ROCK','SHOULD','DOES') -> 'QGIS DOES ROCK'
regexp_replace
function
Syntax
Arguments
Example
substr
substr() function
Return a part of a string
Syntax
substr(string,startpos,length)
Arguments
string -> is string. The full string.
startpos -> is number. The start position to extract from.
length -> is number. The length of the string to extract.
Example
substr('HELLO WORLD',3,5) -> 'LLO W'
Geometry
This group contains functions that operate on geometry objects e.g length, area.
xat
xat() function
Return x coordinate (longitude) of n-th point of a line.
Syntax
xat(n)
Arguments
n - integer, point number of a line (indices start at 0; negative values apply to the last index)
Example
xat(1) -> degree, if polyline layer is in Geographic Coordinate System
xat(1) -> meters, if polyline layer is in Projected Coordinate System
yat
yat() function
Return y coordinate (latitude) of n-th point of a line.
Syntax
yat(n)
Arguments
n - integer, point number of a line (indices start at 0; negative values apply to the last index)
Example
yat(1) -> degree, if polyline layer is in Geographic Coordinate System
yat(1) -> meters, if polyline layer is in Projected Coordinate System
$area
$area function
Return area of polygon. Attention! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Syntax
$area
Arguments
No arguments.
Example
$area -> meters, (polygone layer must be in projected coordinate system)
$length
$area function
Return length of a line. Attention! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Syntax
$length
Arguments
No arguments.
Example
$length -> meters, (polyline layer must be in projected coordinate system)
$perimeter
$perimeter function
Return perimeter of a polygone. Attention! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Syntax
$perimeter
Arguments
No arguments.
Example
$perimeter -> meters, (polygone layer must be in projected coordinate system)
$x
$x function
Return X-coordinate (longitude) of point. Attention! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Syntax
$x
Arguments
No arguments.
Example
$x -> degree, if point layer is in Geographic Coordinate System
$x -> meters, if point layer is in Projected Coordinate System
$y
$y function
Return Y-coordinate (latitude) of point. Attention! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Syntax
$y
Arguments
No arguments.
Example
$y -> degree, if point layer is in Geographic Coordinate System
$y -> meters, if point layer is in Projected Coordinate System
Record
$rownum
function
Syntax
Arguments
Example
$id
function
Syntax
Arguments
Example
Fields and Values
Contains a list of fields from the layer. Sample values can also be accessed via right-click.
Select the field name from the list then right-click to access context menu with options to load sample values from the selected field.