24.1.6. 모델 생성기 도구

이 도구들은 그래픽 모델 생성기에서만 사용할 수 있습니다. 공간 처리 툴박스에서 사용할 수는 없습니다.

24.1.6.1. 조건부 분기

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

파라미터

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

산출물

없음

파이썬 코드

알고리즘 ID: native:condition

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

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

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

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

파라미터

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

산출물

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

파이썬 코드

알고리즘 ID: qgis:loadlayer

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

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

24.1.6.3. 예외 발생

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

파라미터

라벨	명칭	유형	설명
Message	MESSAGE	[string]	표시할 메시지
Condition	CONDITION	[expression]	참인지 평가할 표현식

산출물

없음

파이썬 코드

알고리즘 ID: native:raiseexception

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

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

24.1.6.4. 경고 발생

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

파라미터

라벨	명칭	유형	설명
Message	MESSAGE	[string]	표시할 메시지
Condition	CONDITION	[expression]	참인지 평가할 표현식

산출물

없음

파이썬 코드

알고리즘 ID: native:raisewarning

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

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

24.1.6.5. 레이어 재명명하기

레이어를 재명명합니다.

파라미터

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

24.1.6.6. 로그를 파일로 저장

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

파라미터

라벨	명칭	유형	설명
Use HTML	USE_HTML	[Boolean] 기본값: False	HTML 서식 사용 여부

산출물

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

파이썬 코드

알고리즘 ID: native:savelog

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

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

24.1.6.7. 프로젝트 변수 설정

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

파라미터

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

산출물

없음

파이썬 코드

알고리즘 ID: native:setprojectvariable

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

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

24.1.6.8. 문자열 연결

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

파라미터

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

산출물

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

파이썬 코드

알고리즘 ID: qgis:stringconcatenation

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

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