Справка по функциям калькулятора полей QGIS

Эта страница является черновиком статьи.

Справка по функциям калькулятора полей QGIS

Список функций

Операторы

+

оператор плюс

Возвращает сумму значений полей

Синтаксис

a + b

Аргументы

a, b -> поля содержащие целочисленные или десятичные значения

Пример

"field_name1" + "field_name2"

Математические

Математические функции, такие как квадратный корень, sin и cos.

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

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

Строковые

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

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'

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 -> метры, в случае, если точечный слой находится в прямоугольной системе координат.

Поля и значения

Содержит список полей слоя. Конкретные значения поля доступны по правому щелчку мыши.

Выберите значение поля из списка и щелкните по нему правой кнопкой мыши. Появится контекстное меню для загрузки значений из выбранного поля.

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"

Math

This group contains math functions e.g square root, sin and cos

Conversions

This group contains functions to convert on data type to another e.g string to integer, integer to string.

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'

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

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.