Справка по функциям калькулятора полей 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

Функция

Синтаксис

Аргументы

Пример

Преобразования

Функции для преобразования одного типа данных в другой, например для преобразования строковых данных в числовые, числовых в строковые.

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.