跳转到主要内容

Python 3库,用于编写CZML

项目描述

名称:

czml3

作者:

Juan Luis Cano Rodríguez

Eleftheria Chatziargyriou

PyPI - Version Conda Version GitHub Actions Workflow Status codecov Pepy Total Downlods Conda Downloads license Join the chat at https://openastronomy.riot.im/#/room/#poliastro-czml:matrix.org

czml3是一个用于编写CZML的Python库。

什么是CZML?

来自官方CZML指南

CZML 是一种用于描述时间动态图形场景的 JSON 格式,主要用于在运行 Cesium 的网页浏览器中显示。它描述了线条、点、标志、模型和其他图形基本元素,并指定它们随时间如何变化。虽然 Cesium 拥有丰富的客户端 API,但 CZML 允许它以数据驱动的方式工作,这样通用的 Cesium 观看器就可以显示丰富的场景,而无需任何自定义代码。

安装

您可以使用 pip 安装 czml3

$ pip install czml3

或 conda

$ conda install czml3 --channel conda-forge

czml3 需要 Python >= 3.7。

示例

CZML 文档是一个包含多个 数据包 的列表,每个数据包都有几个属性。当在交互式解释器中使用 czml3 时,所有对象都显示为漂亮的 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"}'

还有更多复杂示例可供参考

>>> 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 小部件

您可以使用我们交互式的小部件轻松显示您的 CZML 文档

In [1]: from czml3.examples import simple

In [2]: from czml3.widget import CZMLWidget

In [3]: CZMLWidget(simple)

这将得到以下结果

https://raw.githubusercontent.com/poliastro/czml3/master/widget-screenshot.png

支持

Join the chat at https://openastronomy.riot.im/#/room/#poliastro-czml:matrix.org

如果您在 czml3 中发现任何问题或有任何疑问,请在我们的仓库中打开一个问题并加入我们的聊天

贡献

您想贡献吗?太棒了!我们还有很多CZML 属性尚未实现。此外,有一个更好的验证、Jupyter notebook 和 JupyterLab 中的 Cesium 小部件会很棒……欢迎提出想法!

我们推荐这个 GitHub 工作流程来分叉仓库。要运行测试,请使用 tox

$ tox

在您发送拉取请求之前,请记住重新格式化所有代码

$ tox -e reformat

这将应用 ruff 和大量的爱 ❤️

许可证

license

czml3 采用 MIT 许可证发布,因此允许商业使用该库。请参阅 LICENSE 文件。

项目详情


下载文件

下载您平台上的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分布

czml3-1.0.2.tar.gz (1.1 MB 查看哈希值)

上传时间

构建分布

czml3-1.0.2-py3-none-any.whl (30.2 kB 查看哈希值)

上传时间 Python 3

由以下支持