boundary

Options: <json>

GeoJSON polygon limiting the area of the reconstruction. Can be specified either as path to a GeoJSON file or as a JSON string representing the contents of a GeoJSON file. Default: ``

Parameter Type:

String

Parameter Domain:

True: GeoJSON{}

False: null

Parameter Default:

False: null

Resource	Impact
CPU	●●○ \| Medium
GPU	○○○ \| None
HDD	○○○ \| None
RAM	●○○ \| Low
Time	●●○ \| Medium

What is Boundary [GeoJSON]?

The --boundary argument serves to constrain and "crop" all final output products of a processing task to the bounding box created by the GeoJSON string that is passed to the --boundary argument.

When is Boundary [GeoJSON] appropriate?

Passing a --boundary GeoJSON is appropriate in any instance where one would want a specific subset of the entire reconstruction area.

If you are interested in the complete reconstruction, the --auto-boundary option would likely be more appropriate.

Further, given that the --boundary is applied after the products are generated (and thereby modifying them), it adds processing time to the dataset, and may not be appropriate if one's primary concern is generating a complete product as fast as possible.

Why would one use Boundary [GeoJSON]?

One might want to use the --boundary function to limit the final products to a predefined Area Of Interest (AOI).

As an example, you are tasked to survey a given property/lot. You decide to include 20m of overfly in your survey so that the reconstruction is clean and with sufficient overlap right up to the property boundaries. However, due to this overfly and your flight height you also capture and reconstruct bordering properties and homes that are not part of your survey AOI. Using a GeoJSON representation of the AOI property's boundary, you would then "clip" all of the final products to be just what is inside the GeoJSON boundary, providing you with a clean, focused, and "safe" representation of the survey AOI (and nothing beyond it).

How would one create Boundary [GeoJSON]?

GeoJSON.io

http://geojson.io: A quick, simple webapp for creating GeoJSON files.

New GeoJSON

GeoJSON.io interface with empty GeoJSON map and text. — After opening the above link to GeoJSON.io, one should pan and zoom the map preview to find their area of interest.

Creating A Polygon

Choosing the "Draw Polygon" menu option in the Map View. — Selecting the "Draw Polygon" menu option will allow you to place verticies for your polygon by left-clicking on the map.

Placing Verticies

Completing A Polygon

Completed polygon in the Map View and GeoJSON text view. — To close the polygon, you left-click on your first vertex. You will be able to close your polygon once you have placed at least three vertices on the map. A completed polygon will have a different representation than one that is in-progress. It will have a darker border and a fill, implying that it is now a "solid" polygon. If your polygon looks like this, you are ready to save it.

Saving A Polygon

Saving the polygon using the Save menu and choosing GeoJSON. — Select "Save" and then "GeoJSON" to save the completed GeoJSON boundary to disk. Your browser will prompt or otherwise alert you that the file is ready to download. Alternatively, you can copy and paste the text-only representation of the GeoJSON boundary from the right panel with the "JSON" header.

Example GeoJSON textual representation:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {},
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -77.04460859298706,
              38.88532071975074
            ],
            [
              -77.04014539718628,
              38.8801593862463
            ],
            [
              -77.03295707702637,
              38.88331636291941
            ],
            [
              -77.03965187072754,
              38.887959703337145
            ],
            [
              -77.04460859298706,
              38.88532071975074
            ]
          ]
        ]
      }
    }
  ]
}