Reading your results

A released job gives you a report, the sources as CSV and GeoJSON, and a section figure, and the same results in more formats for other software. This page explains what is in them and what the depths mean, in the report's own words.

Viewing results online

Under My surveys, click a ready job to see its results before you download them: the section figure, a map of your line with its targets, the targets table and the report. These are the released files themselves, shown on the page; nothing is shown for a job that is still in review. Click a row of the table, or a target on the map, and it is marked on the map and on the section, and its opinion is shown under the table. The table rounds numbers for display; the files carry the full values. The four download buttons are under the report, with More formats below them. Download all (.zip), above the buttons, saves every file in one go. If a file does not download, use Download all (.zip).

A target is placed on the map by its distance along your line, so the map shows the line as it was flown. If your line has no map position, the map says so and the targets are still in the table and the files.

Survey results page

The lines you submit together are listed together under My surveys, under a row for the survey. Once a line is released, View results on that row opens one page for all of them:

The map shows every released line of the survey and every target. The targets of the selected line carry their rank numbers; the targets of the other lines are small dots, and pointing at one shows its rank. Click a line or a target to show it.
The section below the map is the section figure of the selected line, with each of its targets labelled by rank; the selected target is ringed, and its description is shown under the section.
The ranked table on the right lists the targets of all the lines, tightest depth first: the target whose depth estimates agree most closely (the smallest spread as a fraction of the depth, the spread_fraction column of the CSV) comes first, and where two agree equally the shallower comes first. Click a column heading to sort by line, position along the line, depth or spread (in metres) instead, and again to reverse it; click # to go back to the ranking. The rank says how well the estimates agree with each other, not how they compare with the ground, and no confidence grade is given.
About these results gives the survey's name, the field, the coordinate statement your files carry, the number of lines and stations, the spacing between the lines shown when they run side by side, the dates, the parameter set identifier printed in your report, and the data statement (the source and licence of the data, or that it is your own, confidential).
Files: Download all (.zip) saves every file of every released line in one go, one folder per line. Each line also has its report, its targets CSV and its own .zip. These are the same files as each line's own downloads.

A line that is still in review or processing is named at the top of the map and is added to the page when it is released. A line submitted on its own opens its own results, as above.

The report

The report (report.html) opens in any web browser. Its sections, from the top:

Review banner. The date of the review and the company that countersigned it. A report seen before release says NOT RELEASED.
Summary. For the processed part of the line ("Segment 1: ... m to ... m along the line"): how many sources were found, the strongest source (its depth below the measurement line, its position along the line and its spread), the statement about the top of the source, the declared comparison, and the opinion.
What the depth is. What every depth on the page means and does not mean. Read it; the main points are below.
Sources. One row per source, strongest first, and the opinion for each. The caption under the table states the coordinate system.
Section. The figure: sources drawn under the line.
QC record. What was checked on your line: its spacing, gaps and readings.
Provenance. Where the data came from. For your own upload it is marked client-supplied and confidential.
Parameters and versions. The field type, a parameter-set reference, the software versions and a fingerprint (input sha256) of the data that was run, so a report can be traced to exactly what produced it.
Review. The review statement again.

No source found is a result: the summary says "No source was found on this segment."

What a depth means

These are the report's own statements.

Source, not ore. "The depth reported is the depth to a geophysical source -- a magnetic or density contrast -- below the measurement line. It is not a depth to ore. Where a body has been drilled, the source can sit away from it."
The plane of the line. "This method reads a vertical plane through the measurement line. It assumes every response comes from a source in that plane, so a source lying to the side of the line is outside what the method can represent and may still produce a reading. Depths on this page are depths in the plane of the line, and a line that does not pass over a body does not report it correctly."
Sources beside the line. The report gives figures for how much a source to the side of the line adds to the depth on one synthetic test, and states that how far to the side a source lies cannot be determined from one line.
Depth to a corner or axis, and the top. "Each depth is to a corner or axis of the source, not to its top. The one statement made about the top is a bound: the top is at or above that corner or axis. A reported depth can itself read shallow, by up to 22 % on compact synthetic sources, so the bound given with each source allows for that and is deeper than the depth reported." In the files, this bound is the column top_at_most_m.
Declared systematic. A paragraph headed Declared systematic gives the figures measured on synthetic sources for lines of your line's length relative to the depth, and says where those figures stop applying. They are figures for synthetic sources, not a correction to apply to your line.
Spread. "The spread quoted with each depth is the RMS scatter of the estimates that make it up. It measures how well the estimates agree with each other and nothing about how well they agree with the ground."
No grade. No confidence grade is issued: the report says the criterion for one has not yet passed every test set for it, and gives a written opinion for each source instead.

Nothing in the report is a promise of how close a depth is to a drilled depth. The report states what was measured on synthetic sources and what the depth is a depth to; treat each depth as the reading of one line, read together with the geology you know.

The declared comparison

Each depth is also estimated by a second, standard method, and the report shows both: the reported (corrected) depth and the comparison (standard) depth for the same source, with the difference (reported minus comparison). An empty comparison means the comparison method found no estimate of the same source.

The targets files

targets.csv starts with comment lines (each beginning with #) that carry the provenance, the QC record, the release state and the coordinate statement, then one header row, then one row per source, strongest first within each segment. targets.geojson has the same rows as point features, with the same statements beside the features.

Column	Meaning
`segment`	The part of the line the source came from.
`position_m`	Distance along the line from its first station, in metres.
`easting`, `northing`	The source's position on the flown line, in the delivered coordinate system. Named `longitude` and `latitude` when results are delivered in longitude and latitude.
`depth_m`	Depth to the geophysical source below the measurement line, in metres: the reported (corrected) depth.
`spread_m`	RMS scatter of the estimates that make up the depth, in metres.
`spread_fraction`	`spread_m` divided by `depth_m`.
`top_at_most_m`	The top of the source is no deeper than this. It is deeper than `depth_m` because it allows for a depth that reads shallow.
`comparison_depth_m`	The comparison (standard) depth of the same source, or empty.
`difference_m`	`depth_m` minus `comparison_depth_m`, or empty.
`field`	`magnetic_tmi` or `gravity_gz`.
`opinion`	The written opinion for the source, as in the report.

A projected GeoJSON (eastings and northings) says on its face that it is not longitude and latitude; a GeoJSON in longitude and latitude follows the GeoJSON standard (RFC 7946).

The section figure

section.svg shows the sources under the line. When the run carried the sensor and ground elevations, the figure is in elevation above the survey datum and shows the measurement line and the ground surface. Otherwise it shows depth below the measurement line and no ground surface, and the caption says so.

Depths and the vertical scale. Every depth in the targets table, the report and the files is measured down from the measurement line (the sensor). When the figure's vertical scale is elevation above the survey datum, read a source's depth as the height of the measurement line above it, not as its elevation; the figure's key says so. Each mark's bar is its spread, written in the table as metres and as a percentage of the depth. A line split at a gap in the data is drawn in parts, numbered from 1.

The downward-continued field (some accounts)

On some accounts a released line also offers a picture of the downward-continued field, dc_section_client.svg. It shows the field you measured continued downward under the line, in its own units, with the reported targets and their depth spread marked on it. It is a display of the measured field, not a model of the ground and not a depth estimate: read the depths from the report and the targets files. Where the continuation is unstable the field is still drawn, with faint grey dots over it: the values under the dots are not reliable, and where they run beyond the colour scale their colours saturate at its ends. The line ends, where there is no value, are plain dark grey. Noise in the measured line can make most of the picture dotted, and the picture says so when it does. If your account offers it, it is shown in the results viewer and on the survey results page, and it is in the downloads and the zip.

More formats

Below the four main files, More formats offers the same results for other software. Each file says on its face what it is, the release state and the coordinate system.

File	What it is
`section.sgy`	The section as SEG-Y (revision 1, depth domain): one trace per position along the line, carrying its coordinates.
`section.ers`	The section as an ER Mapper grid header: along-line distance across, depth down.
`section`	The ER Mapper grid's data file; keep it beside `section.ers` under the same name.
`section.ers.txt`	Notes for the ER Mapper grid: what its values are, the release state and the coordinates of the line's ends.
`section.csv`	The section as CSV: one row per grid cell, with `distance_m`, `depth_m` and `value`.
`targets.xyz`	The targets as Geosoft XYZ, with the columns of `targets.csv`; each row's opinion is the comment line above it.
`targets.dat`	The targets as ASEG-GDF2 data, with the columns of `targets.csv` and its statements as comment records.
`targets.dfn`	The ASEG-GDF2 definition file for `targets.dat`; download the two together.
`targets_shapefile.zip`	The targets as a point shapefile for GIS software, with its coordinate system file and a note naming each attribute; open it from the zip.
`targets.kml`	The targets for Google Earth in WGS 84 longitude and latitude, offered when your coordinates can be put in longitude and latitude.

In the shapefile each point is a row of targets.csv, at its position in your coordinate system. A shapefile attribute name has at most 10 characters, so the columns are renamed (for example depth_m is DEPTH_M and comparison_depth_m is COMP_DEP_M), and the opinion is split over OPINION, OPINION_2 and so on; targets.txt in the zip lists every name. In targets.kml each source is placed at the ground above its position on the line; its depth below the measurement line is in its description. The file says how its longitude and latitude were obtained.

The section files are the section figure on a regular grid of distance along the line by depth below the measurement line. Their values are marks: 2 at a source's depth, 1 within its spread, -1 between the measurement line and the ground (when the run carried the ground), 0 elsewhere. They are drawn from the targets; they are not measured or modelled values. The SEG-Y and ER Mapper grids are in metres along the line and below it; the SEG-Y traces also carry their position in your coordinate system.

The coordinate statement

Every file says which coordinate system its positions are in, whether they were converted and how, and the conversion's stated uncertainty. See The coordinate system of your results.