Справка по функциям калькулятора полей QGIS: различия между версиями
Bolotoved (обсуждение | вклад) |
Bolotoved (обсуждение | вклад) (→$x) |
||
| Строка 596: | Строка 596: | ||
<span style="color:blue">Example</span> | <span style="color:blue">Example</span> | ||
$x -> degree, if | $x -> degree, if point layer is in Geographic Coordinate System | ||
$x -> meters, if | $x -> meters, if point layer is in Projected Coordinate System | ||
=== $y === | === $y === | ||
Версия от 15:37, 3 февраля 2012
Справка по функциям калькулятора полей QGIS
Список функций
Операторы
+
оператор плюс
Возвращает сумму значений полей
Синтаксис
a + b
Аргументы
a, b -> поля содержащие целочисленные или десятичные значения
Пример
"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"
-
*
/
%
^
=
>
<
<>
<=
>=
||
LIKE
ILIKE
IS
OR
AND
NOT
Math
This group contains math functions e.g square root, sin and cos
sqrt
sin
cos
tan
asin
acos
atan
atan2
exp
ln
log10
log
Conversions
This group contains functions to convert on data type to another e.g string to integer, integer to string.
toint
toreal
tostring
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
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
() function
Return Y-coordinate (latitude) of point. Attention! Следите, чтобы количество разрядов в результатах расчетов не превышало количество разрядов заданных при создании поля.
Syntax
$y
Arguments
No arguments.
Example
$y -> degree, if polyline layer is in Geographic Coordinate System
$y -> meters, if polyline layer is in Projected Coordinate System
Record
$rownum
$id
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.