particle_step — GFX2D particle op

• 데이터 종류: table → table

• 호출: import gfx2d; gfx2d.particle_step(state, dt, gravity=(0.0, 98.0), drag=0.0)(또는 opsgfx2d.get("particle_step"))

사용법

입자 상태를 `dt` 초 진행시킵니다. 새로운 dict 를 돌려줍니다.

> 아래 상세 설명은 원문입니다 —— 요약과 제목은 번역되어 있습니다.

Semi-implicit (symplectic) Euler::

v <- v + (g - drag*v) * dt

p <- p + v * dt

age <- age + dt

which makes the closed form exact and checkable: with `gravity=(0,0)` and

`drag=0 the position after k steps is p0 + v0*k*dt`, and with drag

the speed is `v0 * (1 - drag*dt)**k`. Both are compared as equalities in

the test suite.

`gravity is (gx, gy) in px/s^2, positive gy` pulling down the

screen. The input dict is never mutated.

Raises ValueError: `dt <= 0; drag * dt >= 1`, which is the point where

explicit drag stops decaying the speed and starts reversing it — an

instability that otherwise shows up as particles flying backwards rather

than as an error.

참고(샘플 데이터·문헌)

• 샘플 데이터 카탈로그(DL URL / 라이선스) —— 2-D 는 skimage.data(BSD/public)+ 합성, 3-D 는 실데이터 소스(Stanford/PDS 등)의 DL URL.

• 연산자의 내력·참고문헌 —— 이 연산자 족의 바탕이 된 연구/기법의 출처.

• 알고리즘의 정전(저자·연도)과 용도는 위의 패밀리 사용 가이드에 적혀 있습니다.

실행 가능한 예제(이 연산자를 실제로 호출하는 검증된 샘플)

• gfx2d_scene — py -3.11 examples/gfx2d_scene.py

타입이 이어지는 다음 연산자(table 를 입력으로 받는 것)

layer_stack · particle_render

같은 카테고리(particle)

particle_emit · particle_render

*Provenance: gfx2d.py — GFX2D 연산자 레지스트리. 이 op 노트는 tools/opdocs.py md 가 자동 생성합니다(직접 편집하지 마세요).*

© 2026 Kazufumi Furuse — Fullseye operator documentation. Licensed under Apache-2.0.