czml3-ext 0.11.0

Create packets of CZML3

czml3-ext

This library is a collection of functions that outputs lists of czml3.packets for various items, as shown in the table below. See czml3 for more information about CZML properties.

Item	Function in czml3_ext.packets
Sensor	sensor
Grid	grid
Border	border
Coverage	coverage

Installation

pip install czml3-ext

Examples

See the examples folder for a full demo of the package. Run pip install czml3_ext[examples] to run the examples locally.

The following code produces a CZML file with a single sensor:

import numpy as np
from czml3 import Document, Packet, CZML_VERSION
from czml3.properties import (
    Color,
    Ellipsoid,
    EllipsoidRadii,
    Material,
    SolidColorMaterial,
)

from czml3_ext import packets
from czml3_ext.colours import RGBA_blue, RGBA_white

sensor = packets.sensor(
    np.array([[31.4], [34.7], [1000]]),
    10,
    30,
    100,
    20,
    10_000,
    5_000,
    name="A Sensor",
    ellipsoid=Ellipsoid(
        radii=EllipsoidRadii(cartesian=[0, 0, 0]),
        material=Material(
            solidColor=SolidColorMaterial(
                color=Color(rgbaf=Colour("blue", alpha=0.3).rgba)
            )
        ),
        outlineColor=Color(rgba=list(Colour("white").rgb)),
        fill=True,
        outline=True,
    ),
)

doc = Document(
    packets=[Packet(name="simple", id="document", version=CZML_VERSION)] + sensor
)
with open("example.czml", "w") as f:
    f.write(doc.dumps())

This produces the following view:

Contributing

PRs are always welcome and appreciated!

After forking the repo install the dev requirements: pip install -e .[dev].