Skip to main content

Python 3 library to write CZML

Project description

Authors: Juan Luis Cano Rodríguez
Eleftheria Chatziargyriou

circleci codecov license Join the chat at

czml3 is a Python library to write CZML.

What is CZML?

From the official CZML Guide:

CZML is a JSON format for describing a time-dynamic graphical scene, primarily for display in a web browser running Cesium. It describes lines, points, billboards, models, and other graphical primitives, and specifies how they change with time. While Cesium has a rich client-side API, CZML allows it to be data-driven so that a generic Cesium viewer can display a rich scene without the need for any custom code.


You can install czml3 using pip:

$ pip install czml3

or conda:

$ conda install czml3 --channel conda-forge

czml3 requires Python >= 3.6.


A CZML document is a list of packets, which have several properties. When using czml3 in an interactive interpreter, all objects show as nice CZML (JSON):

>>> from czml3 import Packet
>>> print(Packet())
    "id": "adae4d3a-7087-4fda-a70b-d18a262a890e"
>>> packet0 = Packet(id="Facility/AGI", name="AGI")
>>> print(packet0)
    "id": "Facility/AGI",
    "name": "AGI"
>>> packet0.dumps()
'{"id": "Facility/AGI", "name": "AGI"}'

And there are more complex examples available:

>>> from czml3.examples import simple
>>> print(simple)
        "id": "document",
        "version": "1.0",
        "name": "simple",
        "clock": {
            "interval": "2012-03-15T10:00:00Z/2012-03-16T10:00:00Z",
            "currentTime": "2012-03-15T10:00:00Z",
            "multiplier": 60,
            "range": "LOOP_STOP",
            "step": "SYSTEM_CLOCK_MULTIPLIER"

Jupyter widget

You can easily display your CZML document using our interactive widget:

In [1]: from czml3.examples import simple

In [2]: from czml3.widget import CZMLWidget

In [3]: CZMLWidget(simple)

And this would be the result:


Join the chat at

If you find any issue on czml3 or have questions, please open an issue on our repository and join our chat!


You want to contribute? Awesome! There are lots of CZML properties that we still did not implement. Also, it would be great to have better validation, a Cesium widget in Jupyter notebook and JupyterLab… Ideas welcome!

We recommend this GitHub workflow to fork the repository. To run the tests, use tox:

$ tox

Before you send us a pull request, remember to reformat all the code:

$ tox -e reformat

This will apply black, isort, and lots of love ❤️



czml3 is released under the MIT license, hence allowing commercial use of the library. Please refer to the LICENSE file.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for czml3, version 0.6.0
Filename, size File type Python version Upload date Hashes
Filename, size czml3-0.6.0-py3-none-any.whl (30.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size czml3-0.6.0.tar.gz (46.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page