https://github.com/3dcitydb/plugin-spreadsheet-generator
Importer/Exporter plugin to export feature attributes as spreadsheets
https://github.com/3dcitydb/plugin-spreadsheet-generator
Last synced: 11 months ago
JSON representation
Importer/Exporter plugin to export feature attributes as spreadsheets
- Host: GitHub
- URL: https://github.com/3dcitydb/plugin-spreadsheet-generator
- Owner: 3dcitydb
- License: apache-2.0
- Created: 2014-04-17T18:52:19.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-09-14T13:03:10.000Z (almost 2 years ago)
- Last Synced: 2024-09-15T23:04:01.907Z (almost 2 years ago)
- Language: Java
- Homepage:
- Size: 58.4 MB
- Stars: 4
- Watchers: 16
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- License: LICENSE
Awesome Lists containing this project
README
Spreadsheet Generator Plugin
============================
> [!NOTE]
> This repository hosts the 3DCityDB v4 Spreadsheet Generator Plugin. Although 3DCityDB v5 is now available, 3DCityDB v4
> remains stable and operational. However, it is in **maintenance mode**, meaning no significant new features are
> planned, though existing bugs will continue to be addressed. Development is now focused on 3DCityDB v5, and we recommend
> upgrading to benefit from new features and improvements. Please refer to the [3DCityDB v5 user manual](https://3dcitydb.github.io/3dcitydb-mkdocs/)
> for more information.
The Spreadsheet Generator Plugin allows users export attribute data of the city objects stored in the 3D City Database
in tabular form as comma-separated values (CSV) or Microsoft Excel (XLSX) file.
The Spreadsheet Generator is implemented as plugin for the
[3D City Database Importer/Exporter](https://github.com/3dcitydb/importer-exporter).
License
-------
The Spreadsheet Generator Plugin is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
See the `LICENSE` file for more details.
Note that releases of the software before version 2.1.0 continue to be licensed under GNU LGPL 3.0.
To request a previous release of the 3D City Database Importer/Exporter under Apache License 2.0 create a GitHub issue.
Latest release
--------------
The latest stable release of the Spreadsheet Generator Plugin is 4.3.1.
Download the software [here](https://github.com/3dcitydb/plugin-spreadsheet-generator/releases/download/v4.3.1/plugin-spreadsheet-generator-4.3.1.zip).
Previous releases are available from the [releases section](https://github.com/3dcitydb/plugin-spreadsheet-generator/releases).
Installation
------------
The Spreadsheet Generator plugin is shipped with the [3D City Database Suite installer](https://github.com/3dcitydb/3dcitydb-suite/releases).
When running the installer, a setup wizard will let you choose to install the plugin together with the required
version of the Importer/Exporter tool. This is the recommended and easiest way to install the plugin.
Alternatively, you may download the software from the [releases section](https://github.com/3dcitydb/plugin-spreadsheet-generator/releases)
(or build it from source) and unzip it into the `plugins` folder within the installation folder of the
Importer/Exporter. Please note that in this case you have to make sure yourself that the plugin version you
download can be used together with your installation of the Importer/Exporter. After a restart of the
Importer/Exporter, the Spreadsheet Generator will be ready to use.
System requirements
-------------------
Each version of the Spreadsheet Generator plugin is built against a specific version of the Importer/Exporter.
Please check the release notes of the version you want to use for more information.
Documentation
-------------
A complete and comprehensive user manual on the Spreadsheet Generator Plugin is available
[online](https://3dcitydb-docs.readthedocs.io/en/latest/plugins/spreadsheet/).
Contributing
------------
* To file bugs found in the software create a GitHub issue.
* To contribute code for fixing filed issues create a pull request with the issue id.
* To propose a new feature create a GitHub issue and open a discussion.
Building
--------
The Spreadsheet Generator plugin uses [Gradle](https://gradle.org/) as build system. To build the plugin from source,
clone the repository to your local machine and run the following command from the root of the repository.
> gradlew installDist
The build process will produce the plugin software package under `build/install`. Simply copy the contents of this
folder into the `plugins` folder of your Importer/Exporter installation to use the plugin.
Developers
----------
The Spreadsheet Generator plugin has been developed by and with the support from the following cooperation partners:
* [Chair of Geoinformatics, Technical University of Munich](https://www.gis.bgu.tum.de/)
* [Virtual City Systems, Berlin](https://vc.systems/)
* [M.O.S.S. Computer Grafik Systeme GmbH, Taufkirchen](http://www.moss.de/)