Use Channel in WiTwin Studio

This guide is for WiTwin Studio users who want radio maps without writing a solver script. The Channel Plugin adds components for transmitters, receivers and radio maps, a Library category, a "Channel Sim" Project template, ITU-R P.2040 material presets and an Agent tool. It runs Channel 0.5 in a separate process and draws the radio map in the viewport.

The Plugin id is witwin.channel. Its Python distribution is wt-channel (import name wt_channel), version 0.1.0, and its source is at https://github.com/witwin-ai/wt_channel.

What the Plugin adds#

Get the Plugin#

# Run in the Project folder. Pick one.
witwin add git+https://github.com/witwin-ai/wt_channel
witwin add ../wt_channel          # a local checkout, installed editable

witwin add writes the dependency into the Project's pyproject.toml and syncs its environment. You can also install it from the Plugins page in Studio (from Git or a local folder). See Plugins for the general mechanism.

Install the solver runtime#

Studio imports only the Plugin's components. The solve runs in a child process on the Project's Python interpreter, which needs Channel itself: Python 3.11, torch==2.10.0 with CUDA 12.8, witwin-channel==0.5.0 and an NVIDIA GPU. Follow Installation in that environment. The Plugin's solve extra lists the same stack (witwin>=0.4, witwin-channel>=0.5,<0.6, torch>=2.4).

Create a Project from the Channel Sim template#

While no Project is open, Studio shows Project template cards. Choose Channel Sim. The Scene contains:

• Channel Ground: a concrete ground plane;
• Tx and Rx: a transmitter and a receiver;
• RadioMap: a 2D coverage map over the ground at 3.5 GHz;
• Path Solver: the rays between Tx and Rx.

Select RadioMap and press Solve. The result appears as a colored plane inside the RadioMap's border, in dB by default.

To start in an existing Scene instead, drag Channel Scene (Demo) from the Channel Library category, or drag Tx and RadioMap separately.

Components#

Tx and Rx#

The object's position in the Scene is the antenna position.

RadioMap#

A RadioMap is a 2D Studio Field that is also the receiver grid. Its region (min_bound, max_bound, in the object's local frame) and resolution define the grid; moving the object moves the grid.

The Plugin builds components as "los", plus "reflection" when bounces are above 0, plus "diffraction" when the diffraction order is above 0. Transmission and scattering are not exposed in the panel.

MaterialPreset#

Assigns an ITU-R P.2040 material to a structure: concrete, brick, plasterboard, wood, glass, ceiling_board, chipboard, plywood, marble, floorboard, metal, very_dry_ground, medium_dry_ground or wet_ground. The Plugin evaluates the preset at the solve frequency (or an override) into a PhysicalMaterial. A mesh with no preset and no hand-set values solves as ITU concrete.

Ask the Agent#

With the Plugin enabled, ask the Studio Agent for a radio map, for example "run a radio map of this Scene". The radio-map skill directs it to the witwin.channel.run_radiomap tool, which places a Tx and a RadioMap over the geometry in the Scene if needed, solves, and reports dB statistics.

Limits of Plugin 0.1.0 with Channel 0.5#

The Plugin's own follow-up notes list what is not ported to Channel 0.5 yet:

For anything beyond radio maps (paths, arrays, transmission, gradients, the propagation consumer), use the Python API on these pages. A Studio Project is an ordinary Python project, so you can run such scripts in the same environment with witwin run scripts/<name>.py.