27.1.8. 모델 설계자 도구

경고

이 도구들은 모델 설계자에서만 사용할 수 있습니다. 공간 처리 툴박스에서 사용할 수는 없습니다.

27.1.8.1. 조건부 분기 

표현식 평가를 기반으로 모델의 일부가 실행될 수 있도록 모델에 조건부 분기(conditional branch)를 추가합니다. 대부분의 경우 모델의 흐름을 제어하기 위해 도구 의존성을 이용합니다.

파라미터

라벨	이름	유형	설명
Field	`BRANCH`	[string]	조건의 이름
Field	`CONDITION`	[expression]	평가할 표현식

산출물

없음

파이썬 코드

알고리즘 ID: native:condition

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.2. 디렉터리 생성 

파일 시스템 상에 새 디렉터리를 생성합니다. 디렉터리는 재귀적으로 생성될 것입니다. 즉, 지정된 디렉터리 경로 전체를 구성하기 위해 필요한 모든 상위 디렉터리도 생성할 것입니다. 지정한 디렉터리가 이미 존재하는 경우 오류를 발생시키지 않습니다.

파라미터

라벨	이름	유형	설명
Directory path	`PATH`	[string]	생성할 폴더 경로

산출물

라벨	이름	유형	설명
Output	`OUTPUT`	[folder]	생성한 폴더

파이썬 코드

알고리즘 ID: native:createdirectory

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.3. 피처 필터 

입력 레이어에서 피처를 필터링해서 하나 또는 몇 개의 산출물로 전송(傳送)합니다. 가능한 모든 입력 레이어에 공통된 속성 이름을 하나도 모르는 경우, $id 및 uuid 같은 피처 도형 및 일반 레코드 메커니즘에 대해서만 필터링할 수 있습니다.

파라미터

라벨

이름

유형

설명

Input layer

INPUT

[vector: any]

입력 레이어

Outputs and filters

(하나 이상)

OUTPUT_<name of the filter>

[same as input]

필터링된 산출 레이어 (필터의 개수만큼)

산출물

라벨

이름

유형

설명

Output

(하나 이상)

native:filter_1:OUTPUT_<name of filter>

[same as input]

필터링된 피처를 가진 산출 레이어 (필터의 개수만큼)

파이썬 코드

알고리즘 ID: native:filter

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.4. 레이어 유형으로 필터링 

레이어를 레이어 유형으로 필터링합니다. 입력 레이어가 벡터 레이어냐 또는 래스터 레이어냐에 따라, 입력 레이어를 서로 다른 산출물로 전송(傳送)할 것입니다.

파라미터

라벨	이름	유형	설명
Input layer	`INPUT`	[layer]	일반 맵 레이어

산출물

라벨

이름

유형

설명

Vector features

부가적

VECTOR

[vector]

호환 가능한 경우, 입력물의 벡터 레이어

Raster layer

부가적

RASTER

[raster]

호환 가능한 경우, 입력물의 래스터 레이어

파이썬 코드

알고리즘 ID: native:filterlayersbytype

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.5. 프로젝트로 레이어 불러오기 

레이어를 현재 프로젝트로 불러옵니다.

파라미터

라벨	이름	유형	설명
Layer	`INPUT`	[layer]	범례에 불러올 레이어
Loaded layer name	`NAME`	[string]	불러온 레이어의 이름

산출물

라벨	이름	유형	설명
Layer	`OUTPUT`	[same as input]	(재명명된) 불러온 레이어

파이썬 코드

알고리즘 ID: native:loadlayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.6. 예외 발생 

예외를 발생시켜 모델의 실행을 취소합니다. 예외 메시지를 사용자 정의할 수 있고, 표현식 기반 조건을 지정할 수 있는 옵션도 있습니다. 표현식 조건을 사용한다면, 표현식 결과가 참인 경우에만 예외를 발생시킬 것입니다. 결과가 거짓인 경우 예외를 발생시키지 않고, 모델은 방해받지 않고 계속 실행됩니다.

파라미터

라벨

이름

유형

설명

Message

MESSAGE

[string]

표시할 메시지

Condition

부가적

CONDITION

[expression]

참인지 평가할 표현식

산출물

로그 패널에 메시지를 표시합니다.

파이썬 코드

알고리즘 ID: native:raiseexception

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.7. 메시지 발생 

NEW in 3.26

로그에 정보 메시지를 발생시킵니다. 메시지를 사용자 정의할 수 있고, 표현식 기반 조건을 지정할 수 있는 옵션도 있습니다. 표현식 조건을 사용한다면, 표현식 결과가 참인 경우에만 메시지를 로그에 작성할 것입니다. 결과가 거짓인 경우 메시지를 발생시키지 않을 것입니다.

파라미터

라벨

이름

유형

설명

Information message

MESSAGE

[string]

표시할 메시지

Condition

부가적

CONDITION

[expression]

참인지 평가할 표현식

산출물

로그 패널에 메시지를 표시합니다.

파이썬 코드

알고리즘 ID: native:raisemessage

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.8. 경고 발생 

로그에 경고 메시지를 발생시킵니다. 경고 메시지를 사용자 정의할 수 있고, 표현식 기반 조건을 지정할 수 있는 옵션도 있습니다. 표현식 조건을 사용한다면, 표현식 결과가 참인 경우에만 경고를 로그에 작성할 것입니다. 결과가 거짓인 경우 경고를 발생시키지 않을 것입니다.

파라미터

라벨

이름

유형

설명

Message

MESSAGE

[string]

표시할 메시지

Condition

부가적

CONDITION

[expression]

참인지 평가할 표현식

산출물

로그 패널에 메시지를 표시합니다.

파이썬 코드

알고리즘 ID: native:raisewarning

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.9. 레이어 재명명하기 

레이어를 재명명합니다.

파라미터

라벨	이름	유형	설명
Layer	`INPUT`	[layer]	재명명할 레이어
New name	`NAME`	[string]	레이어의 새 이름

산출물

라벨	이름	유형	설명
Layer	`OUTPUT`	[same as input]	(재명명된) 산출물 레이어

파이썬 코드

알고리즘 ID: native:renamelayer

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.10. 로그를 파일로 저장 

모델의 실행 로그를 파일로 저장합니다. 로그를 HTML 서식 버전으로 저장할 수 있는 옵션이 있습니다.

파라미터

라벨

이름

유형

설명

Use HTML

USE_HTML

[Boolean]

기본값: False

HTML 서식 사용 여부

산출물

라벨	이름	유형	설명
File	`OUTPUT`	[string]	로그 저장 위치

파이썬 코드

알고리즘 ID: native:savelog

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.11. 프로젝트 변수 설정 

현재 프로젝트에 대해 표현식 변수를 설정합니다.

파라미터

라벨	이름	유형	설명
Variable name	`NAME`	[string]	변수의 이름
Variable value	`VALUE`	[string]	저장할 값

산출물

없음

파이썬 코드

알고리즘 ID: native:setprojectvariable

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.12. 문자열 연결 

공간 처리 프레임워크 모델 설계자에서 문자열 2개를 하나로 연결(concatenation)합니다.

파라미터

라벨	이름	유형	설명
Input 1	`INPUT_1`	[string]	첫 번째 문자열
Input 2	`INPUT_2`	[string]	두 번째 문자열

산출물

라벨	이름	유형	설명
Concatenation	`CONCATENATION`	[string]	연결된 문자열

파이썬 코드

알고리즘 ID: native:stringconcatenation

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.

27.1.8.13. 가변 거리 버퍼 

경고

이 알고리즘은 중요도가 떨어져 더 이상 사용되지 않기 때문에 언제든 사라지게 될 수 있습니다. 대신 버퍼 알고리즘을 사용하는 편이 좋습니다.

입력 레이어의 모든 피처에 대한 버퍼 영역을 계산합니다.

지정한 피처에 대한 버퍼 크기는 속성에 따라 정의됩니다. 따라서 서로 다른 피처의 버퍼 크기가 서로 다를 수 있습니다.

버퍼

파라미터

라벨	이름	유형	설명
Input layer	`INPUT`	[vector: any]	입력 벡터 레이어
Distance field	`DISTANCE`	[tablefield: numeric]	버퍼의 거리 반경을 정의할 속성
Segments	`SEGMENTS`	[number] 기본값: 5	둥글린(rounded) 오프셋을 생성하는 경우 사분원에 가깝게 만드는 데 사용할 라인 선분의 개수를 제어합니다.
Dissolve result	`DISSOLVE`	[boolean] 기본값: False	최종 버퍼를 융해시킬지 여부를 선택할 수 있습니다. 이 옵션을 참으로 설정하면 모든 입력 피처를 커버하는 단일 피처를 산출합니다. 그림 27.8 일반 버퍼와 융해된 버퍼
End cap style	`END_CAP_STYLE`	[enumeration] 기본값: Round	버퍼에서 라인의 끝을 어떻게 처리할지 제어합니다. 그림 27.9 둥글림, 편평 및 정사각형 캡 스타일
Join style	`JOIN_STYLE`	[enumeration] 기본값: Round	라인에 있는 모서리를 오프셋시킬 때 둥글림, 마이터, 또는 베벨 결합을 사용할지 여부를 지정합니다.
Miter limit	`MITER_LIMIT`	[number] 기본값: 2.0	마이터 결합 스타일에만 적용할 수 있으며, 마이터 결합 생성시 사용할 오프셋 곡선으로부터의 최장 거리를 제어합니다.

산출물

라벨	이름	유형	설명
Buffer	`OUTPUT`	[vector: polygon]	버퍼 폴리곤 벡터 레이어

파이썬 코드

알고리즘 ID: qgis:variabledistancebuffer

import processing
processing.run("algorithm_id", {parameter_dictionary})

공간 처리 툴박스에 있는 알고리즘 위에 마우스를 가져가면 알고리즘 ID 를 표시합니다. 파라미터 목록(dictionary) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.