> For the complete documentation index, see [llms.txt](https://doc.ancoraspring.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.ancoraspring.com/asmagic/sensors-and-simulation/astriad/quick-start.md).

# Install and Use the Viewer

Install asTriad, adjust its physical size and choose which coordinate axes to display.

[Open the sample in MuJoCo Live](https://doc.ancoraspring.com/asmagic/sensors-and-simulation/astriad.md#open-in-mujoco-live), or install the native viewer below.

{% stepper %}
{% step %}

### Install the package

Use **Python 3.10 or newer**. Download `astriad-0.10.0-py3-none-any.whl` from [Releases](https://github.com/asMagicApp/asTraid/releases/tag/v0.10.0), then run this command in the folder containing the wheel:

```bash
python -m pip install ./astriad-0.10.0-py3-none-any.whl
```

The package includes the native viewer, STL exporter and MJCF exporter. It uses MuJoCo 3.3.7 through 3.x.

Alternatively, install the current repository version:

```bash
python -m pip install git+https://github.com/asMagicApp/asTraid.git
```

{% endstep %}

{% step %}

### Open the viewer

```bash
asTriad --size 20
```

The sphere center is the coordinate origin. `--size 20` sets its physical diameter to **20 mm**; each arrow extends **80 mm** from the origin to its tip.

<figure><img src="https://3069436181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiTOs5tBJUyhQCv2lbX6A%2Fuploads%2Fgit-blob-c0e4272a34a7fdd6edbfbb42b5696f6073af5141%2FasTriad-ui.png?alt=media" alt="asTriad MuJoCo viewer with RGB axes, axis visibility buttons and a ball-diameter slider"><figcaption><p>The included viewer, rendered in MuJoCo. The diameter readout uses millimeters.</p></figcaption></figure>

The native viewer requires a desktop OpenGL display.
{% endstep %}

{% step %}

### Adjust the diameter and visible axes

Drag **Ball diameter** to scale the sphere, shafts and cone heads together.

| Control                               | Result                                          |
| ------------------------------------- | ----------------------------------------------- |
| **Ball diameter** slider or **− / +** | Change the single size parameter                |
| **X**, **Y**, **Z**                   | Toggle each axis independently                  |
| **All**                               | Display all three arrows                        |
| **None**                              | Hide the arrows and retain the origin sphere    |
| **Labels**                            | Show or hide the frame name and axis letters    |
| **Persp / Ortho**                     | Switch perspective or orthographic projection   |
| **Reset**                             | Restore the initial size, view and visible axes |

Drag the scene to orbit, right-drag to pan and scroll to zoom.
{% endstep %}
{% endstepper %}

## Command-line options

Show only X and Z:

```bash
asTriad --size 20 --axes xz
```

Set a frame name and use orthographic projection:

```bash
asTriad --size 20 --name tool --orthographic
```

The name appears as `{tool}` near the origin.

## Python API

```python
from asTriad import AsTriad

frame = AsTriad(size=20)
```

Add the frame to a viewer or rendering loop as described in [Place Frames in a Simulation](https://doc.ancoraspring.com/asmagic/sensors-and-simulation/astriad/simulation.md).

{% hint style="info" %}
`size` uses millimeters; frame positions and local offsets use meters.
{% endhint %}

{% content-ref url="/pages/tYkvISEJExyLGYiMwi1W" %}
[Place and Attach Frames](https://doc.ancoraspring.com/asmagic/sensors-and-simulation/astriad/simulation.md)
{% endcontent-ref %}
