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. 피처 필터

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

파라미터

라벨

이름

유형

설명

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

최종 버퍼를 융해시킬지 여부를 선택할 수 있습니다. 이 옵션을 참으로 설정하면 모든 입력 피처를 커버하는 단일 피처를 산출합니다.

../../../../_images/buffer_dissolve1.png

그림 27.8 일반 버퍼와 융해된 버퍼

End cap style

END_CAP_STYLE

[enumeration]

기본값: Round

버퍼에서 라인의 끝을 어떻게 처리할지 제어합니다.

../../../../_images/buffer_cap_style.png

그림 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) 은 파라미터 이름 및 값을 제공합니다. 파이썬 콘솔에서 공간 처리 알고리즘을 어떻게 실행하는지 자세히 알고 싶다면 콘솔에서 공간 처리 알고리즘 사용 을 참조하세요.