Open and check CityGML and CityJSON files

In Insula3D, choose FileOpen… and pick a CityGML or CityJSON file. Insula3D shows the model with its textures, reads its geometry back and lights up the objects with open or flipped surfaces, one at a time.

  1. 1Choose FileOpen… and pick the file
  2. 2Click Diagnostics on the icon rail
  3. 3Click Scan to go through the flagged objects
  4. 4Copy a name and fix the object at its source
Scan mode. The scene is dark and the flagged objects light up. A card next to A-302 reads Area mismatch, with the sheet area of 55 m², the model area of 48 m² and the difference. In the panel, the grade counts and Conversion errors with Fix and Review.
Scan on a sample model: flagged objects light up and the card names the problem.

What the diagnosis shows

  1. Grades

    How many objects failed, are approximated, need a recheck or disagree with the spreadsheet area.

  2. Issue card

    What is wrong with the selected object, with the numbers behind it.

  3. Fix and Review

    The flagged objects in two groups: wrong as written, and worth a look.

Step by step

  1. 1

    Open the file

    Choose FileOpen… and pick a CityGML 1.0, 2.0 or 3.0 file or a CityJSON file, or drag it onto the window. The textures next to the file come along.

    Open a model file in the user guide

  2. 2

    Look at the diagnosis

    Click Diagnostics on the icon rail. The panel counts the objects by grade and lists the flagged ones under Fix and Review.

    A file Insula3D wrote also brings back the grades from its conversion, such as an area that disagrees with the spreadsheet.

    Find problems in the user guide

  3. 3

    Go through the issues

    Click Scan. The scene darkens and the flagged objects light up. Next moves to the next issue, and Copy name copies the object's name.

    Find problems in the user guide

What gets checked

Closed surfaces
Whether the surfaces of each object close into a shell, and where they do not.
Flipped surfaces
Faces that point inward.
Holes
Inner rings that lie outside their face.
Coordinates
Files in latitude and longitude are measured in meters, not degrees.

Insula3D converts the model as it is and reports what it finds. It does not quietly fix or drop objects, and a check that did not run never shows as a pass.

Fix and check again

Insula3D reports what it finds and leaves the file as it is. Fix the objects at their source, then convert or open the file again.

Questions

Which versions can it open?

CityGML 1.0, 2.0 and 3.0, and CityJSON. Textures next to the file are shown too.

Can I try it before buying?

Yes. The 30-day trial unlocks everything.

Convert your own model

Windows 10 and 11, 64-bit. The trial unlocks everything for 30 days.

Other ways in