Dev > Tools

Unit Converter

Converts lengths, areas, volumes and masses as you type, like 12' 6" to mm or 250 sqft in m2. Enter copies the result.

Status

The public ask

No public source is on record for this tool.

Events it listens to

None. It runs only when you click it.

Files

Paths are relative to the Playground.extension folder.

• Dev.tab/Tools.panel/Unit_Converter.pushbutton/bundle.yaml
• Dev.tab/Tools.panel/Unit_Converter.pushbutton/icon.dark.png
• Dev.tab/Tools.panel/Unit_Converter.pushbutton/icon.png
• Dev.tab/Tools.panel/Unit_Converter.pushbutton/icon.small.dark.png
• Dev.tab/Tools.panel/Unit_Converter.pushbutton/icon.small.png
• Dev.tab/Tools.panel/Unit_Converter.pushbutton/script.py

Install

1. Only this tool. In Navisworks, click pyNavis > Playground, search for Unit Converter, tick it and click Install.
2. The whole extension. Download Playground.extension.zip, unzip it, put the Playground.extension folder in %APPDATA%\pyNavis\extensions\, and click pyNavis > Reload. Unit Converter is on the Dev tab, Tools panel.

You need pyNavis 1.3.0 or later.

Source

The tool's own files, word for word as published in pynavis/Playground. Paths are relative to the Playground.extension folder.

script.py

The script that runs on a click.

# -*- coding: utf-8 -*-
"""Opens the unit converter: lengths, areas, volumes and masses as you type."""
from pynavis import toast
from pynavis._api import Application

from namo import converter

if globals().get('__runner__'):
    toast.info('The Unit Converter needs the Navisworks window', 'It cannot open under pynavis run.')
else:
    document = Application.ActiveDocument
    doc_units = None
    if document is not None and document.Models.Count:
        doc_units = str(document.Units)
    converter.show(doc_units)

Library modules this tool uses

From the shared namo library, which installs with every tool. Each name opens the module on GitHub.

• namo.converterUnit Converter: a small calculator window that converts as you type.

bundle.yaml

The bundle contract: the keys pyNavis reads for this tool.

title: Unit\nConverter
tooltip: Converts lengths, areas, volumes and masses as you type, like 12' 6" to mm or 250 sqft in m2. Enter copies the result.