02StreetView carries a street-level imagery study from a street network to mapped, aggregated indicators inside QGIS. It samples points along the streets, matches open images from Panoramax and Mapillary or your own geotagged photos to them, keeps the licence and attribution of every image, segments the images locally, computes the green view index, sky view factor, tree and building view factors, sky share, visual enclosure and element shares with solid-angle weighting for 360° panoramas, aggregates them to street segments and areas, checks photographic SVF against a DSM, and writes a self-contained HTML report in which every formula is typeset with KaTeX.
The chain is available in the lab dock (page by page, with an image viewer, charts and styled layers) and in the Processing provider (one algorithm per step plus the whole chain). Only qgis.core, GDAL, NumPy and PyQt are required; SciPy is used for speed when present (same results without it) and onnxruntime is optional, for the scene-parsing model.
Why it exists: inside QGIS the street-level imagery tools stop at viewing (the Panoramax plugin, MapillaryClickPreview, mapillary2QGIS and several panorama viewers); the one analysis plugin, Green View Index, needs a paid Google Street View key and computes a single colour-rule GVI; the research packages that run the full chain (ZenSVI, streetscape, Treepedia) work outside QGIS and need PyTorch. Related Geophilo plugins compute SVF rasters from a DSM (PlanX, 02Geo3D) or a geometric visible-greenness index vgvi (02GreenRule); here the DSM only checks the photographs, and gvi is photographic.
onnxruntime (1.16 or later, CPU build) is installed and, if not, the exact pip command for the Python of the running QGIS with a Copy command button. Run it in the OSGeo4W Shell (Windows) or a terminal and restart QGIS. The plugin never runs pip itself.Run time of the ONNX model on a CPU with 4 threads: about 1.47 s per 512 × 512 tile, three tiles per 1024 × 512 panorama plus resampling, so roughly 7 to 9 s per panorama. The Segment page shows an estimate before the run, and a run is capped at 300 images unless you raise the cap. The colour rules take well under 0.2 s per panorama.
Sampling interval, matching radius, segment lengths and aggregation are computed in a projected CRS in metres. If the street layer is geographic, not in metres, or Web Mercator, every input is reprojected to the UTM zone of the layer's extent centre (EPSG:326xx north, 327xx south); otherwise its CRS is kept. Image services are queried in WGS84 and image positions are transformed into the working CRS before any distance is computed. The Network page badge, the run log and the report say which CRS was used and why.
Angles: azimuth in degrees clockwise from true north; elevation in degrees above the horizon; zenith angle . The centre column of a panorama looks along its heading (Panoramax view:azimuth, Mapillary computed_compass_angle), so the left edge is at .
Pick the street line layer, an optional area polygon layer (with a name field) and an optional DSM. Set the sampling interval (default 20 m), the offset of the first point (0 m) and the minimum gap (5 m: a point closer than this to an earlier point, as at junctions, is dropped). Sample points runs the sampling; Load demo street adds the synthetic canyons of section 13; Run the whole chain runs every step with the settings of every page. KPI cards: network length, segments, samples.
Source cards with switches. Panoramax: endpoint (default the federated API https://api.panoramax.xyz/api), no account needed. Mapillary: paste your client token (from the Mapillary developer page) and press Save token; it is stored in the QGIS authentication database as an API-header configuration and never in project files or logs. Local folder: JPEGs with EXIF GPS tags. Then the date range, the capture months (for example 5-9 to keep leaf-on pictures in the northern hemisphere, 11-3 in the southern; winter pictures of deciduous trees lower GVI and TVF; empty keeps every month), matching radius (15 m), panorama preference and heading tolerance (45°). Search and match runs as a background task; KPI cards show images found, matched samples, coverage, the share of panoramas and the median capture year, with a bar per source. A layer of the matched images, styled by capture year, is added.
Download images fetches the matched images into the local cache (progress, cancel); the cache size and Clear cache are shown. The viewer shows the image of a sample (step with the arrows, or press the pick tool and click a sample on the map), the segmentation overlay in the group colours, a fisheye view of panoramas (equidistant projection of the upper hemisphere, the view behind SVF) and, under the picture, the attribution line and a link to the source page.
Chips choose the segmenter: Colour, ONNX ADE20K or Custom ONNX. The runtime card shows the onnxruntime status and install command; the model card shows size, licence and source, and Download model is enabled once the licence notice is ticked. Threads (default ) and the run-time estimate are shown. Run segmentation runs as a background task; label files are reused when the same segmenter revision labelled the image before. KPI cards: images segmented, seconds per image.
A checklist of the indicators of section 8 with label, formula, unit and reference as tooltips; items the chosen segmenter cannot produce are disabled with the reason. The elevation band (default , a pedestrian eye-level band) applies to the share indicators on panoramas. Compute indicators fills the sample fields; KPI gauges show mean GVI, SVF and enclosure, and the sample layer is styled by the chosen indicator (quantile classes).
Targets (street segments, areas), statistics (mean, median, n), minimum coverage (0.5) and street-length weighting for areas. Aggregate writes the layers and fills a ranked table with small bars. Compare with DSM computes svf_dsm at every sample and draws a scatter of photo SVF against DSM SVF with , MAE and bias.
Writes the HTML report, CSV files and a GeoPackage with every layer (attribution and licence fields included; the attribution lines are also written to the layer metadata) into a chosen folder; a link opens the report.
A short guide, the method references, the data licences, the privacy note and links to this manual and the repository.
Every long step runs as a QGIS background task with a progress bar and a Cancel button; the dock stays responsive. Results go to a 02StreetView layer group. A cancelled run keeps the steps finished before the cancel.
Panoramax is the federated open street-level imagery commons. The plugin searches the federated STAC API anonymously over the sample extent grown by the matching radius, with at most four requests per second and back-off on HTTP 429 and 5xx. For every picture it reads the licence (properties.license, for example CC-BY-SA-4.0), the producer, heading, capture time, field of view (360 for panoramas), position accuracy and the 2048 px sd image asset. The same capture can be listed by two instances; duplicates are removed by producer, original file name and capture time, and by the same capture time within 1 m.
Mapillary needs a client token: every user registers their own application on the Mapillary developer page. The token is sent as Authorization: OAuth <token>; it never appears in logs, error messages or cache sidecars. Searches are split into cells smaller than 0.01 degree² (an API rule); the API returns at most 2000 images per query without paging, so a cell whose answer is full is split in four and asked again (up to six times), and the log names any cell that is still full. Image URLs are signed and expire, so images are downloaded in the same session as the search. Mapillary content is under CC BY-SA 4.0 and the Mapillary terms, which ask apps to supplement the service rather than redistribute the images: the plugin keeps images in a local cache and has no image export.
Local folder: JPEGs with EXIF GPS latitude and longitude (read through GDAL); the heading from EXIF when present; 2:1 images are treated as equirectangular panoramas.
Privacy. Panoramax and Mapillary blur faces and number plates. The plugin does not attempt any de-blurring or person identification, and the segmentation groups (person, vehicle) are used only as shares of the view.
An equirectangular panorama of pixels maps row and column to elevation and azimuth:
Pixel elevation and azimuth of an equirectangular panorama:
Exact solid angle of a pixel:
Exact cosine-weighted view-factor share of a pixel:
Both weights are exact integrals over each pixel row (not centre-point approximations), so they sum to and 1 to rounding error. Shares weighted by are equal-area: a raw pixel count over-weights the rows near the zenith and nadir. The view-factor weight is the cosine (Lambertian) weight of a horizontal surface at camera height. The mapping holds only for a full sphere, which is a 2:1 picture: a picture tagged 360° that is not 2:1 (within one pixel or 1 %) is a cropped or partial panorama, and all its indices are NULL with a note in the log rather than computed on invented elevations.
Two closed forms are used as checks in the tests and the demo:
Sky view factor at the centre of an infinite canyon:
Sky view factor under a uniform horizon at elevation :
The fisheye view renders the upper hemisphere in equidistant projection, ; svf_steyn applies the Steyn annulus formula to it as an independent cross-check of svf.
Every segmenter labels each pixel with one of twelve groups: sky, vegetation, building, road, sidewalk, vehicle, person, wall/fence, pole/sign, terrain, water, other. Label files are written next to the cached image as <id>.<segmenter>.png with a JSON note of the segmenter revision and the groups it can produce. An indicator needing a group the segmenter does not produce is NULL, never 0.
Excess-green vegetation rule:
Colour sky rule:
Colour rules (built in, NumPy). Vegetation: excess green on the chromatic coordinates above with and (Woebbecke et al. 1995; the spectral rule of Li et al. 2015). Sky: brightness at least , , above the horizon, and 4-connected to the top edge (so a white wall separated from the sky by a dark roof line is not sky). Produces sky, vegetation and other. Known weaknesses: white or blue façades touching the sky, overcast sky, dark foliage. The colour rules are the offline baseline, not the reference method.
ONNX ADE20K: UperNet (Xiao et al. 2018) with a ConvNeXt-T backbone (Liu et al. 2022) trained on ADE20K (Zhou et al. 2017), 150 classes mapped to the groups (for example building, house and skyscraper to building; tree, grass and plant to vegetation). Panoramas are resized to 1024 × 512 (an option up to 4096 px wide), split into 512 × 512 tiles with 64 px overlap, normalised with the ImageNet mean and standard deviation; logits are averaged in the overlaps, upsampled bilinearly and the arg-max class is taken. Perspective images are resized so the short side is 512. CPU session with threads by default. The weights are MIT; ADE20K images are under the dataset's research terms.
Custom ONNX: any model with an NCHW float input and per-class logits, plus a JSON class map {"input_size": 512, "mean": [...], "std": [...], "labels": {"0": "sky", ...}, "groups": {...}}. You are responsible for the model's licence.
Share indicators on panoramas use the solid-angle weight of eq. (2) within the elevation band ; on perspective images they are pixel shares. View factors use the weight of eq. (3) over the upper hemisphere and need a 360° panorama. is 1 when the condition holds and 0 otherwise; is the group of pixel .
| Field | Indicator | Unit | Needs groups | Reference |
|---|---|---|---|---|
gvi | Green view index | ratio | vegetation | Li et al. 2015 |
gvi_pixel | Green view index (pixel share) | ratio | vegetation | Yang et al. 2009; Zhang & Dong 2018 |
svf | Sky view factor | ratio | sky panoramas only | Johnson & Watson 1984; Oke 1987; Gong et al. 2018 |
tvf | Tree view factor | ratio | vegetation panoramas only | Gong et al. 2018 |
bvf | Building view factor | ratio | building panoramas only | Gong et al. 2018 |
ovf | Other view factor | ratio | building panoramas only | Gong et al. 2018 |
sky_share | Sky share (openness) | ratio | sky | Gong et al. 2018 |
enclosure | Visual enclosure | ratio | building, wall_fence, vegetation | Ma et al. 2021; Ewing & Handy 2009 |
bld_share | Building share | ratio | building | Zhang et al. 2018 |
road_share | Road share | ratio | road | Zhang et al. 2018 |
walk_share | Sidewalk share | ratio | sidewalk | Zhang et al. 2018 |
veh_share | Vehicle share | ratio | vehicle | Zhang et al. 2018 |
svf_steyn | Sky view factor (Steyn annuli) | ratio | sky panoramas only, off by default | Steyn 1980 |
gvi_li | Green view index (Li et al. 18 views) | ratio | vegetation panoramas only, off by default | Li et al. 2015 |
gviPanorama: solid-angle share of vegetation within the elevation band; perspective: vegetation pixels / all pixels.
gvi_pixelVegetation pixels / pixels whose centre lies in the elevation band (unweighted).
svfCosine-weighted share of the upper hemisphere, with for sky.
tvfThe SVF integral with for vegetation.
bvfThe SVF integral with for buildings.
ovfThe SVF integral with for every group other than sky, vegetation and building ().
sky_sharePanorama: solid-angle share of sky in the full sphere; perspective: sky pixels / all pixels.
enclosureSolid-angle share of building, wall/fence and vegetation within elevations to .
bld_shareSolid-angle share of buildings within the elevation band.
road_shareSolid-angle share of road within the elevation band.
walk_shareSolid-angle share of sidewalk within the elevation band.
veh_shareSolid-angle share of vehicles within the elevation band.
svf_steynAnnulus sum on an equidistant fisheye with rings, sky pixels and all pixels of ring .
gvi_liMean vegetation pixel share of 18 perspective views cut from the panorama: headings from the panorama heading, pitches , field of view (the Google Street View view set of Li et al. 2015), for comparison with studies that use it.
The ratios are dimensionless in . With the four view factors computed from their own groups, holds as a check, not by construction. The Steyn formula uses rings, sky pixels and all pixels of ring on the equidistant fisheye.
Samples are placed every interval metres along each line from offset, both ends included, with the bearing of the local line direction. For each sample the candidate images are those within the radius after de-duplication and the age and accuracy filters. With prefer panorama the nearest panorama wins over a nearer perspective image; otherwise the nearest image. A perspective image must look along the street: or for image azimuth , street bearing and tolerance . Each image is used by one sample only, the nearest. Results do not depend on the input order.
Aggregation joins samples to their street through seg_id (an id field or the line feature id) and to areas by location (a sample on a shared boundary counts once, for the polygon with the lowest feature id). Statistics leave NULL values out. Coverage:
and low_coverage = 1 when is below the minimum coverage (0.5). With length weighting each sample in an area is weighted by , its street length over the number of samples on that street.
With a DSM (metres), the horizon elevation is searched along azimuths (default 36) up to the radius (100 m) from the DSM height plus the eye height (1.6 m), following Zakšek et al. (2011):
This cosine-weighted form equals for a uniform horizon at , the same quantity as the photographic svf. The agreement is reported as
with the photo SVF and the DSM SVF, plus Pearson's . The DSM only checks the photographs at the same points; it does not produce an SVF raster (PlanX and 02Geo3D do that). Distances and the radius are metres: a DSM in degrees (EPSG:4326), in feet or in Web Mercator is first resampled (nearest neighbour) onto a metric grid in the working CRS around the samples, at about its own ground resolution; heights are read as metres. The DSM code is the vendored skyview SDK (MIT).
Provider zero2streetview. The steps exchange two layers: the sample points (match and indicator fields) and the image points, which carry every field of an image record (source, id, capture time, projection, field of view, size, download URL, licence, attribution, page link, sequence, accuracy) and, after the later steps, image_path and label_path. A model built from the step algorithms therefore gives the same values as the whole-chain algorithm (the test suite checks this to ). Inputs are copied; metric steps run in the working CRS; outputs keep real field types (doubles for indicators, NULL where a value is undefined) and are not styled. Parameters marked advanced are under Advanced parameters. From Python: processing.run("zero2streetview:<id>", {...}). Help in the Processing dialog gives the formulas in plain text; this manual typesets them.
Id: zero2streetview:demo_street
Writes the synthetic test site of 02StreetView: four straight 200 m streets in EPSG:32635, each the centre line of an infinite street canyon of width m with aspect ratios and , two area polygons (West, East) and a DSM of the same canyons (1 m cells, roofs at m because the panoramas are taken 1.6 m above the street). The panoramas are rendered from this geometry and served by the Demo image source of the other algorithms, so the whole chain runs offline.
The street layer carries the planted truth in closed form: svf_true, (Sky view factor at the centre of an infinite canyon) and gvi_true, , the solid-angle share of the planted vegetation band within the elevation band .
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
NETWORK | Demo streets | Feature sink (output) | - | |
AREAS | Demo areas | Feature sink (output) | - | |
DSM | Demo DSM | Raster (output) | - | |
STREETS | Number of streets | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:sample_network
Places sample points every interval metres along each street line, from offset, both ends included, with the local street bearing (degrees clockwise from north). A point closer than the minimum gap to an earlier point (junction overlap) is dropped. Geographic or Web Mercator input is reprojected to the UTM zone of the layer centre and the output is written in that CRS.
Output fields: sample_id, seg_id (the id field value, or the feature id of the line), dist_along (m), bearing (degrees) and seg_len (m, the line length, used for length weighting). Give an id field when the samples are aggregated back to the lines later.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
NETWORK | Street lines | Vector features | - | |
ID_FIELD | Street id field (empty: feature id) optional | Field | - | |
INTERVAL | Sampling interval (m) | Number | 20.0 | min 0.5 |
OFFSET | Offset of the first point (m) | Number | 0.0 | min 0 |
MIN_GAP | Minimum gap between points (m) | Number | 5.0 | min 0 |
OUTPUT | Sample points | Feature sink (output) | - | |
SAMPLES | Number of samples | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:search_images
Queries the chosen sources over the sample extent (grown by the radius) and matches at most one image to each sample: images within the radius, duplicates across Panoramax instances removed (same producer, original file and capture time, or the same capture within 1 m), images older than the age limit or with a worse position accuracy dropped. With Nearest panorama a 360 degree panorama is preferred over a perspective image; a perspective image must look along the street ( or for image azimuth , street bearing and heading tolerance ). An image is used by one sample only (the nearest).
Sources. Panoramax is the federated open street-level imagery commons (no account; the licence of every picture is read from the service). Mapillary needs your own free client token, stored as a QGIS authentication configuration of the API header type holding Authorization: OAuth <token>; Mapillary download URLs are signed and expire after some hours, so download soon after the search. A local folder is searched for JPEGs with EXIF GPS tags. Demo serves the synthetic panoramas that belong to Create demo street and never uses the network.
Outputs: the samples with image_id, source, dist_m, captured, projection and licence (NULL when unmatched), and the image points layer.
The image points layer holds one point per matched image with every field of the image record (source, id, capture time, projection, field of view, size, download URL, licence, attribution, page link, sequence, accuracy) and, after the later steps, image_path and label_path. Keep the attribution with any map or figure.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
SAMPLES | Sample points (from 'Sample street network') | Vector features | - | |
SOURCES | Image sources | Enumeration | 0 | 0: Panoramax (open, no account); 1: Mapillary (client token); 2: Local folder of geotagged JPEGs; 3: Demo (synthetic panoramas, offline) |
ENDPOINT | Panoramax API endpoint advanced | String | https://api.panoramax.xyz/api | |
AUTHCFG | Mapillary token (authentication configuration) optional | Authentication configuration | - | |
FOLDER | Local folder of geotagged JPEGs optional | File or folder | - | |
SINCE | Captured on or after (ISO date, optional) optional | String | - | |
UNTIL | Captured on or before (ISO date, optional) optional | String | - | |
RADIUS | Matching radius (m) | Number | 15.0 | min 0.1 |
MAX_AGE | Maximum image age (years, 0 = no limit) | Number | 8.0 | min 0 |
PREFER | Preference within the radius | Enumeration | 0 | 0: Nearest panorama; 1: Nearest image (any) |
HEADING_TOL | Heading tolerance for perspective images (degrees) advanced | Number | 45.0 | min 0, max 90 |
MIN_ACCURACY | Drop images with a position accuracy worse than (m, 0 = keep all) advanced | Number | 10.0 | min 0 |
MAX_IMAGES | Image cap per run | Number | 2000 | min 1 |
REFERENCE_DATE | Reference date for the age limit (ISO date, empty = today) optional advanced | String | - | |
MONTHS | Capture months kept (e.g. 5-9 for leaf-on in the north, 11-3 in the south; empty = all) optional advanced | String | - | |
OUTPUT | Matched samples | Feature sink (output) | - | |
IMAGES | Image points | Feature sink (output) | - | |
FOUND | Images found in the search area | Output number | - | Returned in the result dictionary. |
MATCHED | Matched samples | Output number | - | Returned in the result dictionary. |
COVERAGE | Coverage (matched / samples) | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:download_images
Downloads the image of every point of the image layer into the local cache (<cache>/<source>/<id[:2]>/<id>.jpg, with a JSON sidecar holding the licence and attribution; a file already in the cache is reused). Local-folder images are used where they are. Requests go through the QGIS network settings (proxy, SSL) with at most four requests per second and back-off on HTTP 429 and 5xx. A failed download is reported and skipped. The cache stays on this computer; there is no image export.
Output: the image layer with image_path (NULL when the download failed).
The image points layer holds one point per matched image with every field of the image record (source, id, capture time, projection, field of view, size, download URL, licence, attribution, page link, sequence, accuracy) and, after the later steps, image_path and label_path. Keep the attribution with any map or figure.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
IMAGES | Image points (from 'Search and match images') | Vector features | - | |
CACHE_DIR | Cache folder (empty: the plugin data folder) optional | File or folder | - | |
AUTHCFG | Mapillary token (authentication configuration) optional | Authentication configuration | - | |
OUTPUT | Downloaded images | Feature sink (output) | - | |
DOWNLOADED | Images in the cache | Output number | - | Returned in the result dictionary. |
FAILED | Failed downloads | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:segment_images
Labels every downloaded image with one group per pixel (sky, vegetation, building, road, sidewalk, vehicle, person, wall/fence, pole/sign, terrain, water, other) and writes the label file next to the image as <id>.<segmenter>.png with a JSON note of the segmenter revision and the groups it can produce; a label file of the same revision is reused.
Colour rules (built in, numpy): vegetation where the excess green of the chromatic coordinates exceeds the threshold and , (eq. 4); sky where the brightness is at least the minimum, , above the horizon and 4-connected to the top edge. Produces sky, vegetation and other only. ONNX ADE20K: UperNet + ConvNeXt-T scene parsing (150 classes, MIT weights, downloaded from the dock's Segment page and checked by SHA-256), panoramas resized to the panorama width and tiled in 512 px tiles with 64 px overlap, classes mapped to the groups; needs the optional onnxruntime package. Custom ONNX: any model with NCHW float input and per-class logits plus a JSON class map (input_size, mean, std, labels, groups).
Output: the image layer with label_path.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
IMAGES | Downloaded images (from 'Download images to the cache') | Vector features | - | |
SEGMENTER | Segmenter | Enumeration | 0 | 0: Colour rules (built in); 1: ONNX UperNet ConvNeXt-T ADE20K; 2: Custom ONNX model + JSON class map |
MODEL | Custom ONNX model (custom segmenter) optional advanced | File or folder | - | |
CLASS_MAP | JSON class map of the custom model optional advanced | File or folder | - | |
THREADS | ONNX threads (0 = automatic) advanced | Number | 0 | min 0, max 64 |
PANO_WIDTH | Panorama width for the ONNX model (px) advanced | Number | 1024 | min 512, max 4096 |
ONNX_CAP | ONNX image cap advanced | Number | 300 | min 1 |
EXG_THRESHOLD | Colour rules: excess green threshold advanced | Number | 0.05 | min -1, max 2 |
SKY_BRIGHTNESS | Colour rules: minimum sky brightness (0-1) advanced | Number | 0.55 | min 0, max 1 |
OUTPUT | Segmented images | Feature sink (output) | - | |
SEGMENTED | Images with a label file | Output number | - | Returned in the result dictionary. |
SECONDS_PER_IMAGE | Seconds per newly segmented image | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:compute_indicators
Adds one field per indicator to the matched samples, computed from the label file of the sample's image. On a 360 degree panorama the pixel at row has elevation (eq. 1); shares are solid-angle weighted with the exact pixel solid angle (eq. 2), so the poles are not over-weighted, and view factors use the cosine weight (eq. 3) with zenith angle (, ). Share indices use the elevation band; perspective images use pixel shares. An indicator whose groups the segmenter does not produce, or that needs a panorama, is NULL (never 0). Fields label_path and the band are also recorded.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
SAMPLES | Matched samples (from 'Search and match images') | Vector features | - | |
IMAGES | Segmented images (from 'Segment images') | Vector features | - | |
INDICES | Indicators (empty: the defaults the segmenter supports) optional | Enumeration | - | 0: gvi - Green view index; 1: gvi_pixel - Green view index (pixel share); 2: svf - Sky view factor; 3: tvf - Tree view factor; 4: bvf - Building view factor; 5: ovf - Other view factor; 6: sky_share - Sky share (openness); 7: enclosure - Visual enclosure; 8: bld_share - Building share; 9: road_share - Road share; 10: walk_share - Sidewalk share; 11: veh_share - Vehicle share; 12: svf_steyn - Sky view factor (Steyn annuli); 13: gvi_li - Green view index (Li et al. 18 views) |
BAND_LOW | Elevation band for shares, lower bound (degrees) | Number | -45.0 | min -90, max 90 |
BAND_HIGH | Elevation band for shares, upper bound (degrees) | Number | 45.0 | min -90, max 90 |
OUTPUT | Samples with indicators | Feature sink (output) | - | |
WITH_VALUES | Samples with indicator values | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:aggregate_segments
Joins the samples to the street lines they were sampled from through seg_id (the id field given to 'Sample street network', or the line feature id when none was given; use the same street layer in the same order) and writes a copy of the lines in the samples' CRS with the statistics.
Statistics of the chosen sample fields (empty: every indicator field found): mean, median and n (number of non-NULL values); optional sd (sample standard deviation) and ci95 (half-width of the 95 % confidence interval of the mean, Student t); written as <field>_<stat>, plus n_samples, n_images (samples with an image), coverage and low_coverage (1 when is below the minimum coverage, NULL without samples). NULL values are left out of every statistic.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
SAMPLES | Samples with indicators | Vector features | - | |
NETWORK | Street lines | Vector features | - | |
ID_FIELD | Street id field used for sampling (empty: feature id) optional | Field | - | |
FIELDS | Fields to aggregate (empty: every indicator) optional | Field | - | |
STATS | Statistics | Enumeration | 0, 1, 2 | 0: mean; 1: median; 2: n; 3: sd; 4: ci95 |
MIN_COVERAGE | Minimum coverage (below: low_coverage = 1) | Number | 0.5 | min 0, max 1 |
OUTPUT | Street segments | Feature sink (output) | - |
Id: zero2streetview:aggregate_areas
Statistics of the samples inside each polygon (a sample on a boundary shared by two polygons counts once, for the polygon with the lowest feature id). With weight by street length each sample is weighted by the length of its street divided by the number of samples on that street, so short and long streets count in proportion to their length.
Statistics of the chosen sample fields (empty: every indicator field found): mean, median and n (number of non-NULL values); optional sd (sample standard deviation) and ci95 (half-width of the 95 % confidence interval of the mean, Student t); written as <field>_<stat>, plus n_samples, n_images (samples with an image), coverage and low_coverage (1 when is below the minimum coverage, NULL without samples). NULL values are left out of every statistic.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
SAMPLES | Samples with indicators | Vector features | - | |
AREAS | Area polygons | Vector features | - | |
FIELDS | Fields to aggregate (empty: every indicator) optional | Field | - | |
STATS | Statistics | Enumeration | 0, 1, 2 | 0: mean; 1: median; 2: n; 3: sd; 4: ci95 |
WEIGHT_BY_LENGTH | Weight samples by street length | Boolean | False | |
MIN_COVERAGE | Minimum coverage (below: low_coverage = 1) | Number | 0.5 | min 0, max 1 |
OUTPUT | Areas | Feature sink (output) | - |
Id: zero2streetview:dsm_svf_check
Computes the sky view factor from a DSM at every sample and compares it with the photographic svf. At each sample the horizon elevation is searched along azimuths up to the radius, from the DSM height plus the eye height: , and (eq. 8) (Sky view factor from DSM horizon angles; cosine-weighted, equal to for a uniform horizon at ). Output field svf_dsm; outputs , Pearson's , MAE and bias (eq. 9, with the svf and the svf_dsm of sample ). The DSM only checks the photographs at the same points; it does not produce an SVF raster.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
SAMPLES | Samples with indicators | Vector features | - | |
DSM | Digital surface model (metres) | Raster layer | - | |
RADIUS | Horizon search radius (m) | Number | 100.0 | min 1 |
DIRECTIONS | Number of azimuths | Number | 36 | min 4, max 720 |
EYE_HEIGHT | Eye height above the DSM (m) | Number | 1.6 | min 0 |
OUTPUT | Samples with svf_dsm | Feature sink (output) | - | |
N | Pairs compared | Output number | - | Returned in the result dictionary. |
PEARSON_R | Pearson r | Output number | - | Returned in the result dictionary. |
MAE | Mean absolute error | Output number | - | Returned in the result dictionary. |
BIAS | Bias (photo - DSM) | Output number | - | Returned in the result dictionary. |
Id: zero2streetview:street_imagery_lab
The whole chain in one run, as in the dock: sample the street network, search and match images, download them into the cache, segment them, compute the indicators, aggregate to street segments (and to areas when given), check photo SVF against a DSM when given, and write the HTML report (formulas typeset with KaTeX, offline, with every attribution line, licence and reference). Each step behaves as the algorithm of the same name. A cancelled run keeps the finished steps.
Sources. Panoramax is the federated open street-level imagery commons (no account; the licence of every picture is read from the service). Mapillary needs your own free client token, stored as a QGIS authentication configuration of the API header type holding Authorization: OAuth <token>; Mapillary download URLs are signed and expire after some hours, so download soon after the search. A local folder is searched for JPEGs with EXIF GPS tags. Demo serves the synthetic panoramas that belong to Create demo street and never uses the network.
The image points layer holds one point per matched image with every field of the image record (source, id, capture time, projection, field of view, size, download URL, licence, attribution, page link, sequence, accuracy) and, after the later steps, image_path and label_path. Keep the attribution with any map or figure.
Statistics of the chosen sample fields (empty: every indicator field found): mean, median and n (number of non-NULL values); optional sd (sample standard deviation) and ci95 (half-width of the 95 % confidence interval of the mean, Student t); written as <field>_<stat>, plus n_samples, n_images (samples with an image), coverage and low_coverage (1 when is below the minimum coverage, NULL without samples). NULL values are left out of every statistic.
| Parameter | Description | Type | Default | Notes |
|---|---|---|---|---|
NETWORK | Street lines | Vector features | - | |
ID_FIELD | Street id field (empty: feature id) optional | Field | - | |
AREAS | Area polygons (optional) optional | Vector features | - | |
DSM | DSM for the SVF check (optional) optional | Raster layer | - | |
INTERVAL | Sampling interval (m) | Number | 20.0 | min 0.5 |
OFFSET | Offset of the first point (m) advanced | Number | 0.0 | min 0 |
MIN_GAP | Minimum gap between points (m) advanced | Number | 5.0 | min 0 |
SOURCES | Image sources | Enumeration | 0 | 0: Panoramax (open, no account); 1: Mapillary (client token); 2: Local folder of geotagged JPEGs; 3: Demo (synthetic panoramas, offline) |
ENDPOINT | Panoramax API endpoint advanced | String | https://api.panoramax.xyz/api | |
AUTHCFG | Mapillary token (authentication configuration) optional | Authentication configuration | - | |
FOLDER | Local folder of geotagged JPEGs optional | File or folder | - | |
SINCE | Captured on or after (ISO date, optional) optional | String | - | |
UNTIL | Captured on or before (ISO date, optional) optional | String | - | |
RADIUS | Matching radius (m) | Number | 15.0 | min 0.1 |
MAX_AGE | Maximum image age (years, 0 = no limit) | Number | 8.0 | min 0 |
PREFER | Preference within the radius | Enumeration | 0 | 0: Nearest panorama; 1: Nearest image (any) |
HEADING_TOL | Heading tolerance for perspective images (degrees) advanced | Number | 45.0 | min 0, max 90 |
MIN_ACCURACY | Drop images with a position accuracy worse than (m, 0 = keep all) advanced | Number | 10.0 | min 0 |
MAX_IMAGES | Image cap per run | Number | 2000 | min 1 |
REFERENCE_DATE | Reference date for the age limit (ISO date, empty = today) optional advanced | String | - | |
MONTHS | Capture months kept (e.g. 5-9 for leaf-on in the north, 11-3 in the south; empty = all) optional advanced | String | - | |
CACHE_DIR | Cache folder (empty: the plugin data folder) optional advanced | File or folder | - | |
SEGMENTER | Segmenter | Enumeration | 0 | 0: Colour rules (built in); 1: ONNX UperNet ConvNeXt-T ADE20K; 2: Custom ONNX model + JSON class map |
MODEL | Custom ONNX model (custom segmenter) optional advanced | File or folder | - | |
CLASS_MAP | JSON class map of the custom model optional advanced | File or folder | - | |
THREADS | ONNX threads (0 = automatic) advanced | Number | 0 | min 0, max 64 |
PANO_WIDTH | Panorama width for the ONNX model (px) advanced | Number | 1024 | min 512, max 4096 |
ONNX_CAP | ONNX image cap advanced | Number | 300 | min 1 |
INDICES | Indicators (empty: the defaults the segmenter supports) optional | Enumeration | - | 0: gvi - Green view index; 1: gvi_pixel - Green view index (pixel share); 2: svf - Sky view factor; 3: tvf - Tree view factor; 4: bvf - Building view factor; 5: ovf - Other view factor; 6: sky_share - Sky share (openness); 7: enclosure - Visual enclosure; 8: bld_share - Building share; 9: road_share - Road share; 10: walk_share - Sidewalk share; 11: veh_share - Vehicle share; 12: svf_steyn - Sky view factor (Steyn annuli); 13: gvi_li - Green view index (Li et al. 18 views) |
BAND_LOW | Elevation band for shares, lower bound (degrees) | Number | -45.0 | min -90, max 90 |
BAND_HIGH | Elevation band for shares, upper bound (degrees) | Number | 45.0 | min -90, max 90 |
STATS | Statistics advanced | Enumeration | 0, 1, 2 | 0: mean; 1: median; 2: n; 3: sd; 4: ci95 |
MIN_COVERAGE | Minimum coverage (below: low_coverage = 1) advanced | Number | 0.5 | min 0, max 1 |
WEIGHT_BY_LENGTH | Weight area statistics by street length | Boolean | False | |
DSM_RADIUS | DSM horizon search radius (m) advanced | Number | 100.0 | min 1 |
DSM_DIRECTIONS | DSM azimuths advanced | Number | 36 | min 4, max 720 |
EYE_HEIGHT | Eye height above the DSM (m) advanced | Number | 1.6 | min 0 |
SAMPLES | Samples | Feature sink (output) | - | |
IMAGES | Images | Feature sink (output) | - | |
SEGMENTS | Street segments | Feature sink (output) | - | |
AREAS_OUT | Areas optional | Feature sink (output) | - | |
REPORT | HTML report optional | File (output) | - | |
N_SAMPLES | Samples | Output number | - | Returned in the result dictionary. |
MATCHED | Matched samples | Output number | - | Returned in the result dictionary. |
COVERAGE | Coverage | Output number | - | Returned in the result dictionary. |
DSM_R | Pearson r of photo SVF and DSM SVF | Output number | - | Returned in the result dictionary. |
| Layer | Geometry | Fields |
|---|---|---|
| Samples | Point | sample_id, seg_id, dist_along (m), bearing (°), seg_len (m); match fields image_id, source, dist_m, captured, projection, licence (NULL when unmatched); image_path, label_path; one double per indicator; svf_dsm after the DSM check |
| Images | Point | image_id, source, captured, year, projection, azimuth, licence, attribution, page_url, sequence, image_path (the Processing step layer also carries every other image record field) |
| Street segments | MultiLineString | the street fields, <field>_mean, <field>_median, <field>_n, n_samples, n_images, coverage, low_coverage |
| Areas | Polygon | the area fields and the same statistics and coverage fields |
The HTML report holds the KPI cards, the indicator means with their formulas, the method equations (1) to (10), the street table, the DSM check, the image sources with every attribution line and licence, the parameters, timings, log and references. It starts with <!DOCTYPE html> and embeds KaTeX and its fonts, so it renders offline.
The demo has four straight streets 200 m long in EPSG:32635, each the centre line of an infinite street canyon of width m with aspect ratio , and a 1024 × 512 panorama rendered every 20 m (positions jittered by up to 2 m, random headings). In each panorama the wall top at azimuth from the street axis lies at elevation ; above it is sky, below the horizon is road, and a band of vegetation is planted between elevations and below the horizon. The truth is written in closed form: (eq. 6) and for the band . A DSM of the same canyons (buildings 40 m deep, 1 m cells) is written for the DSM check; the panoramas are taken 1.6 m above the street, so the DSM roofs stand at m and the DSM eye (1.6 m) sees the same horizon.
44 samples, 44 matched, coverage 100 %. Largest per-sample error against the truth: SVF 0.00011, GVI 0.00170. DSM check: , , MAE 0.0089, bias -0.0089 (photo minus DSM). The small remaining difference comes from the 1 m DSM cells (the horizon is read at cell centres, up to half a cell behind the wall face) and the finite DSM canyons (buildings 40 m deep, horizon searched to 100 m).
| Street | H/W | SVF truth | mean svf | mean svf_dsm | GVI truth | mean gvi | samples |
|---|---|---|---|---|---|---|---|
| Canyon A | 0.2 | 0.9285 | 0.9284 | 0.9332 | 0.2308 | 0.2314 | 11 |
| Canyon B | 0.5 | 0.7071 | 0.7071 | 0.7195 | 0.3929 | 0.3946 | 11 |
| Canyon C | 0.9 | 0.4856 | 0.4857 | 0.4970 | 0.0588 | 0.0579 | 11 |
| Canyon D | 1.5 | 0.3162 | 0.3162 | 0.3232 | 0.4789 | 0.4777 | 11 |
The colour segmenter produces sky, vegetation and other only, so bvf, ovf, enclosure and the element shares are left out (or NULL when requested); with the ONNX model they are computed as well.
Eminoğlu, Y. (2026). 02StreetView - Street-Level Imagery Lab (version 0.1.1) [QGIS plugin]. https://gitlab.com/geophilo1/zero2streetview. https://doi.org/10.5281/zenodo.24263662. The DOI 10.5281/zenodo.24263662 always resolves to the latest version; version 0.1.1 has DOI https://doi.org/10.5281/zenodo.24263663.
Licence GPL-2.0-or-later. Vendored skyview modules: MIT. KaTeX: MIT.