Open citygml data for the United States
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples use remote urls to images to keep binaries out of repo. Jan 18, 2019
releases/2019-jan
README.md fix typos. Jan 15, 2019
test.html

README.md

Open City Model

Open City Model is an initiative to provide open cityGML data for all the buildings in the United States. By using other open datasets such as USBuildingFootprints in conjunction with our own code and algorithms it is our goal to provide 3D geometries for US building inventory.

This data contains roughly 125 million buildings.

The Data

The data is provided via AWS S3 in the bucket opencitymodel. We include two data formats: gml (CityGML) and json (CityJSON) which are identical in content and purely vary in their structure. Within the folder for a data format each US state has its own folder with all of its files. The files for each US state are futher separated by US county and then partitioned into files of 40k buildings to keep file sizes more manageable. Please note that the GML files are zip compressed to minimize download sizes.

The full path to a single file looks like ..

https://s3.amazonaws.com/opencitymodel/<data-version>/<file-format>/<StateName>/<CountyCodeFIPS>/<StateName>-<CountyCodeFIPS>-<FileNumber>.[zip|json]

We also provide some easier to navigate file indexes for each state. If you are familiar with accessing AWS S3 directly then you can simply use the AWS tools to list and download files from the opencitymodel bucket directly.

State Files Size (GML compressed) Size (JSON)
Alabama 102 474MB 2091MB
Alaska 6 24MB 103MB
Arizona 73 521MB 2336MB
Arkansas 88 267MB 1255MB
California 301 2357MB 10159MB
Colorado 93 372MB 1731MB
Connecticut 34 236MB 1044MB
Delaware 10 70MB 303MB
DistrictofColumbia 2 12MB 52MB
Florida 209 1431MB 6213MB
Georgia 202 711MB 3236MB
Hawaii 9 49MB 221MB
Idaho 52 158MB 767MB
Illinois 178 897MB 4121MB
Indiana 129 598MB 2777MB
Iowa 111 349MB 1660MB
Kansas 117 260MB 1308MB
Kentucky 134 423MB 1945MB
Louisiana 89 396MB 1787MB
Maine 26 147MB 637MB
Maryland 55 324MB 1409MB
Massachusetts 57 403MB 1762MB
Michigan 165 914MB 4179MB
Minnesota 120 518MB 2405MB
Mississippi 89 267MB 1258MB
Missouri 149 572MB 2616MB
Montana 62 131MB 635MB
Nebraska 100 181MB 928MB
Nevada 34 229MB 902MB
NewHampshire 19 110MB 491MB
NewJersey 71 486MB 2127MB
NewMexico 43 200MB 909MB
NewYork 149 957MB 4206MB
NorthCarolina 168 875MB 3854MB
NorthDakota 55 89MB 460MB
Ohio 174 1036MB 4633MB
Oklahoma 98 384MB 1792MB
Oregon 67 347MB 1605MB
Pennsylvania 156 975MB 4256MB
RhodeIsland 11 77MB 317MB
SouthCarolina 79 427MB 1859MB
SouthDakota 68 98MB 517MB
Tennessee 126 564MB 2523MB
Texas 415 1878MB 8483MB
Utah 44 190MB 883MB
Vermont 15 68MB 295MB
Virginia 158 554MB 2514MB
Washington 96 657MB 2771MB
WestVirginia 61 181MB 834MB
Wisconsin 115 582MB 2619MB
Wyoming 25 66MB 319MB

FAQ - Technical

How can I read cityGML files?

There are a lot of great options on the cityGML website. We like to use Azul for quick viewing of files and citygml4j for programmatic uses.

What is included in the files?

The files currently contain building data and focus specifically on the 3D geometry of the building. We also include a few useful attributes such as the area of the footprint, the height of the building, the US state & county (FIPS code), and the UBID (Universal Building ID).

What units are used in the data?

The data is written using the epsg:4979 coordinate system for geo positions. This means that all of the 2D coordinates use WGS84 lat/lon values in degrees and the 3D coordinate is in meters.

What is the level of detail (LOD) of the data?

All of the files contain only LOD1 buildings at present. Our first goal is to get the best possible coverage of LOD1 for all of the buildings in the USA. Once we feel comfortable with our LOD1 coverage then we are interested in shooting for LOD2, but we consider that a ways away.

Can I access the files programmatically?

Certainly! All of the files are available on S3 in the bucket opencitymodel so you can list the contents of that bucket using any s3 client to get the files that way if you wish.

Will you be releasing more cityGML files in the future?

Our current plans include releasing files covering all buildings in the United States. Beyond that we don't have any plans, but we are open to talking about it.

How accurate are the building footprints used?

We gather footprints from various sources, so the accuracy depends on the source. Our goal is to provide the best possible accuracy while still providing full coverage of all buildings.

Currently the majority of the building footprints were created by Microsoft using high resolution imagery and advanced machine learning algorithms. Microsoft claims that the footprints in most cases are at least as accurate as those created through field digitization by hand in Open Street Maps. See Microsoft’s USBuildingFootprints for details.

The source of each footprint is attributed in the data.

What is the data source for building heights in OCM?

Wherever possible we attempt to use data with measured building heights. When that is not possible we use machine learning to estimate the height of the remaining buildings.

Currently the modeled building heights were generated with a simple regression analysis algorithm comparing building footprint areas with heights using a 4M buildings OSM dataset. It should be reasonably accurate across the vast majority of buildings with the exception of dense urban environments with tall, multistory buildings, i.e. skyscrapers.

The source of the building height for each footprint is attributed in the data.

Are there plans for increasing the accuracy of building heights?

Yes. We are working on more sophisticated training data sets and algorithms. We welcome contributions to this effort. We also plan to incorporate “actual” building heights from other data sets like OSM when possible.

What is a Universal Building ID (UBID) and why is it important?

UBID is an initiative by the US Department of Energy (DOE) to establish a system for generating and maintaining unique ID’s for all buildings across the planet. The UBID algorithm generates a unique ID based on the geo-spatial location and form of a building footprint. A unique building ID will provide a universal indexing mechanism for the collection, linking and aggregation of building-centric data from disparate sources.

FAQ - General

What is CityGML?

CityGML is a data model (schema) for describing urban environments. CityGML describes urban objects like buildings, roads, bridges, trees, etc. in 3D geographical space. CityGML urban object data attribute classes include: Semantics, Geometry, Topology, and Appearance. CityGML is an open, international consensus standard with over fifteen years of cooperative development and use. It is recognized and supported by the Open Source Geospatial Foundation

Application Domain Extensions (ADE) exist for Energy, Noise, Utilities and other application domains, and new ADE’s are being developed. The ADE’s provide schemas that extend the CityGML model to include data attributes that support domain specific applications such as building energy modeling at building, district and city scale. Detailed information is available at CityGML.org.

Why is CityGML important?

Urban environments are highly complex and require sophisticated software tools to enable proper analysis and design. A stable, tested, open, consensus standard urban data model is essential for effective and efficient software development, collaboration, sharing and scaling globally. Cities and districts world wide face daunting planning challenges in energy, GHG reduction, water, transportation, noise, pollution, etc. CityGML provides the necessary data architecture for complex urban planning and modeling, and the open standard platform to enable efficient collaboration and sharing amongst stakeholders worldwide.

Are there other open consensus urban data models like CityGML?

No. To our knowledge CityGML is the global de facto standard for 3D, geo-spatially-enabled urban models. The European Union has incorporated CityGML within its Spatial Data Infrastructure plan, Inspire.

ESRI, the leading private sector provider of GIS software solutions for governments and industry worldwide, has 3D urban data models. However, they are proprietary, not open consensus standards. They require the use of ESRI software, for example, ArcGIS.

What software currently supports the CityGML data model?

  • ESRI GIS software recognizes CityGML along with other open GIS data standards and provides tools for importing/exporting CityGML data sets. Therefore CityGML urban models can be imported and used in ESRI applications. Conversely, ESRI applications can export urban models as CityGML for use with other software.

  • AutoDesk, RevIt and most other mainstream Building Information Modeling (BIM) software tools recognize CityGML and provide import/export tools to support it.

  • Safe Software FME data extract/transform/load software supports CityGML.

  • Virtual City Systems is a leading provider of software tools for use with CityGML.

  • CesiumJS is an Open Source javascript library for creating geospatial applications that render 3D visualizations in a web browser including 3D CityGML models. Cesium.com provides content and authoring services for creation and streaming of 3D tilesets for rendering visualizations in web browsers using CesiumJS.

  • See the CityGML.org website for more information.

Who is using CityGML?

  • Many European countries including: UK, Germany, Austria, France, Switzerland, Netherlands, Belgium, Sweden, Finland, Poland, and more with a variety of applications
  • European Union: specified for Spatial Data Infrastructure
  • International Building Performance Simulation Association (IBPSA): next generation energy modeling tools
  • Lawrence Berkeley National Laboratory (LBNL): urban scale energy retrofit analysis (CityBES)
  • BuildZero.Org: building energy planning, design and modeling
  • New York
  • Montreal, Canada
  • Singapore

What kind of applications use CityGML?

Why was the Open City Model (OCM) created?

Open Street Maps was the inspiration for the creation of the Open City Model. GIS data and software has evolved beyond the limits of 2D mapping applications. 3D applications including urban models for various use cases are in strong demand and evolving rapidly. OCM was created to accelerate the development and use of 3D urban models for critical applications related to climate action.

What is the vision for evolution of the Open City Model?

We hope that establishing OCM as an Open Data platform using the consensus standard CityGML urban data model will accelerate development, collaboration and sharing. Time is of the essence for climate action. Other urban planning domains can certainly benefit. Bring on the “Smart City”!

Who is BuildZero.Org?

BuildZero.Org is a 501(c)3 non-profit creating public-access digital infrastructure for climate action apps in local communities. BuildZero provides a free, open-standards-based, scalable platform of data and climate action apps. BuildZero is “social infrastructure” funded by social capital serving local governments, citizens, building professionals, and other public/private sector stakeholders.

License

This data is licensed by BuildZero.Org under the Open Data Commons Open Database License (ODbL)

Contact

Feel free to create an issue via github or you can email us via OpenCityModel at BuildZero.Org