CityJSON to JSON-FG
A command line tool for converting CityJSON files to JSON-FG format.
JSON-FG stands for OGC Features and Geometries JSON, which is (currently) a candidate standard. JSON-FG extends GeoJSON to support a wider range of use cases. For cityjson2jsonfg the most important capability of JSON-FG is 3D data storage, since CityJSON is a 3D spatial data format. CityJSON is a JSON-based encoding for storing 3D city models, also called digital maquettes or digital twins.
Supported versions:
- CityJSON: 1.1
- JSON-FG: 0.2.2
Installation
Required python: >= 3.8
Additionally, you need a relatively new version of pip and setuptools that supports building from pyproject.toml files.
You can install cityjson2jsonfg with pip.
pip install cityjson2jsonfg
Usage
Convert a single CityJSON file to JSON-FG.
cityjson2jsonfg <input.city.json> <output.fg.json>
See the help menu and the tool version
cityjson2jsonfg --help
cityjson2jsonfg --version
Pipe from cjio
cjio is a CLI tool for manipulating 3D city models that are stored in CityJSON files. You can pipe cjio's output directly into cityjson2jsonfg without saving an intermedate file. This is particularly useful if you want to modify the citymodel before the conversion. For instance, upgrade the CityJSON file to v1.1 and then convert it to JSON-FG.
cjio --suppress_msg <input.city.json> upgrade save stdout | cityjson2jsonfg - <output.fg.json>
Limitations
Version 1.0 was primarily developed to convert CityJSON files of the Dutch 3D BAG and 3D Basisvoorziening data sets. Conversion from other data sets might not work.
Converted data
A subset of the 3D BAG and 3D Basisvoorziening is available at https://data.3dgi.xyz/jsonfg. Both the source and converted files are provided.
CityJSON --> JSON-FG conversion table
Not all the information contained in a CityJSON document can be represented by JSON-FG. Therefore, some information can be lost in the conversion. Below is a mapping of the CityJSON concepts to JSON-FG as it is implemented in cityjson2jsonfg.
| CityJSON | JSON-FG |
|---|---|
| Multiple LoDs in one CityObject, each from a different family eg. (0, 1.3, 2.2). | If the CityObject has a geometry with LoD < 0.2, this geometry is assumed to be 2.5D and added as GeoJSON geometry to "geometry". If the rest of the geometries are LoD >= 1, then the geometry with the highest LoD is added as JSON-FG geometry to "place". |
| Multiple LoDs in one CityObject, each from the same family eg. (1.1, 1.3). | The geometry with the highest LoD is added to the feature. |
City model creation date in CityJSON.metadata.referenceDate. |
Assigned as an instant time to time.date as full-date. |
| Semantic surfaces | Not converted. |
| Appearances | Not converted. |
Metadata (other than referenceDate and referenceSystem) |
Not converted. |
| CityObject hierarchy (parent and children relations) | Not converted. |
Communication
All work takes place in the current GitHub repository. The primary channel for communication is the GitHub Discussions. Feel free to ask questions you’re wondering about, share ideas and engage with other community members.
Contributing
Contributions to the project are very welcome! You could help with testing, documentation, bug reports, bug fixes, implementing new features and more. Please read the CONTRIBUTING.md on how to get started.
Funding
Version 1.0 was funded by Geonovum.
1 maintainer
Metadata
1 maintainer
Release files for cityjson2jsonfg 1.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cityjson2jsonfg-1.2.tar.gz | 10.1 kB | Without provenance | Details for cityjson2jsonfg-1.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cityjson2jsonfg-1.2-py3-none-any.whl | Python 3 | none | any | Details for cityjson2jsonfg-1.2-py3-none-any.whl |
Total release size: 21.1 kB
Release files / cityjson2jsonfg-1.2.tar.gz
| Download URL | cityjson2jsonfg-1.2.tar.gz |
|---|---|
| Size | 10.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
17c34c401a363cad258633ec94bb3407a8dc6fee1bfff1843ba1cf7b137814e1
|
|
BLAKE2b-256 checksum How to use checksums |
01e4ddeebbf9f3526499ebd4757fd5465a9ff3c65dbc09a9e4949c2e9856d931
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.18
|
Release files / cityjson2jsonfg-1.2-py3-none-any.whl
| Download URL | cityjson2jsonfg-1.2-py3-none-any.whl |
|---|---|
| Size | 11.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c843c3e7ae628cf98cc844510d71a0ecdb77211abc585f65e0366d830372ee1d
|
|
BLAKE2b-256 checksum How to use checksums |
74f3ba581a17f65327123b2258edc5c7e4f4f73432607a80374d1b45da03535d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.0.0 CPython/3.9.18
|
Security for cityjson2jsonfg 1.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
