Process Tools
Exports
JSON Results Export
9 min
introduction the json reports file is designed to be a human readabale results export fro amics json is one of the most widely used formats in modern computing the format was invested by douglas crockford and chip morningstar (formally of lucasfilm) with the basic concept of embedding a javascript object inside of an html frame they placed strings into quotations to avoid conflicts with javascript reserved words and functions, and json was formed “one of the key design goals behind json was minimalism my idea was that the less we have to agree on in order to inter operate, the more likely we’re going to be able to inter operate well,” said crockford see this https //hackernoon com/the history of json and the people that created it the official https //www json org/jsonhttps //www json org/json en html en html result file setup and export the results file is a portable file that contained the classification results, intended to automatically share the results between systems results files can be exported as either a human readable docid\ yahokjegvm99gkhmbmt9o , a sqlite based docid mwxvawdypqiaurld6duf , or the compact and portable docid\ aonct13cbxvn eqsuxhxy the results export is designed to hold classification results without the raw data or can classification methods the results file is not a backup or restore file neither the x ray classification table or the classification workflow is stored in this file this file can be shared with end users and they cannot reconstruct the classification methodology setup to set a default results file export on the completion of reclassification do the following open default settings expand the section "calculation result export options" select the export format as json, mre, or binary select export folder locations set export options some options only to specific exports see each type below for specifics the system can be set to save the results file in two locations, and the folder non pm folder pm this folder is folder non pm this folder is default path this folder is export segments cannot be applied in this format export points cannot be applied in this format export spectra cannot be applied to this format export images cannot be applied in this format quant materials cannot be applied in this format use compression cannot be applied in this format use indentation cannot be applied in this format settings that are not applicable are ignored selecting them will have no impact on the file export automatic generation and update if an export format has been selected in the settings the file is automatically generated the first time the file is classified the file is automatically updated after each classification the file will be updated after each classification in batch processes manual edits or saves are only applied after reclassification or manual file update, not on file save or apply manual generation and update to generate or update the file without classification do the following steps the export format file type must be selected in the settings activate the "other tools" ribbon select the "update classification results file" optionally select to open the folder location json specific settings export segments cannot be applied in this format export points adds a table into the file for any materials in the tmq screen with the x y locations and quantification results export spectra cannot be applied to this format export images cannot be applied in this format quant materials will apply the selected material quantification if specified, or the standard quantification if not specified, to a sum spectra from each material the result is presented in the material table use compression cannot be applied in this format use indentation adds whitespace to the file improves the human readability of the format and more closely aligns with the principals of json however, it results in a much larger file settings that are not applicable are ignored selecting them will have no impact on the file export schema "$schema" "http //json schema org/draft 04/schema#", "description" "", "type" "object", "properties" { "format version" { "type" "number" }, "method" { "type" "string", "minlength" 1 }, "project name" { "type" "string", "minlength" 1 }, "sample name" { "type" "string", "minlength" 1 }, "sample uuid" { "type" "string", "minlength" 1 }, "software name" { "type" "string", "minlength" 1 }, "software version" { "type" "string", "minlength" 1 }, "stage offset x" { "type" "number" }, "stage offset y" { "type" "number" }, "sub samples" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "description", "duration", "experiment method", "experiment name", "experiment uuid", "file location", "is composite", "licence experiment", "licence source", "license first update", "license last update", "material grouping name", "measurement time", "pixel size", "proportion", "results creation time", "size fraction", "specimen name", "total area", "total weight", "update time" ], "properties" { "description" { "type" "string" }, "duration" { "type" "number" }, "experiment method" { "type" "string", "minlength" 1 }, "experiment name" { "type" "string", "minlength" 1 }, "experiment uuid" { "type" "string", "minlength" 1 }, "file location" { "type" "string", "minlength" 1 }, "is composite" { "type" "boolean" }, "licence experiment" { "type" "string", "minlength" 1 }, "licence source" { "type" "string" }, "license first update" { "type" "string", "minlength" 1 }, "license last update" { "type" "string", "minlength" 1 }, "material grouping name" { "type" "string", "minlength" 1 }, "measurement time" { "type" "string", "minlength" 1 }, "pixel size" { "type" "number" }, "proportion" { "type" "number" }, "results creation time" { "type" "string", "minlength" 1 }, "size fraction" { "type" "string" }, "specimen name" { "type" "string", "minlength" 1 }, "tables" { "type" "object", "properties" { "calculated elements assay" { "type" "array", "items" { "required" \[], "properties" {} } }, "calculated material composition" { "type" "array", "items" { "required" \[], "properties" {} } }, "field" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "bounding rect height", "bounding rect width", "bounding rect x", "bounding rect y", "id", "scanfield rect height", "scanfield rect width", "scanfield rect x", "scanfield rect y", "segment count", "xray count" ], "properties" { "bounding rect height" { "type" "number" }, "bounding rect width" { "type" "number" }, "bounding rect x" { "type" "number" }, "bounding rect y" { "type" "number" }, "id" { "type" "number" }, "scanfield rect height" { "type" "number" }, "scanfield rect width" { "type" "number" }, "scanfield rect x" { "type" "number" }, "scanfield rect y" { "type" "number" }, "segment count" { "type" "number" }, "xray count" { "type" "number" } } } }, "grain" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "area microns", "area percent", "area pixels", "average grey level", "bounding rect height", "bounding rect width", "bounding rect x", "bounding rect y", "density", "equivalent circle diameter", "equivalent ellipse diameter", "free perimeter", "id", "material id", "material name", "max grey level", "max span", "min grey level", "min span", "particle id", "perimeter", "segment count", "weight", "weight percent", "xray count" ], "properties" { "area microns" { "type" "number" }, "area percent" { "type" "number" }, "area pixels" { "type" "number" }, "average grey level" { "type" "number" }, "bounding rect height" { "type" "number" }, "bounding rect width" { "type" "number" }, "bounding rect x" { "type" "number" }, "bounding rect y" { "type" "number" }, "density" { "type" "number" }, "equivalent circle diameter" { "type" "number" }, "equivalent ellipse diameter" { "type" "number" }, "free perimeter" { "type" "number" }, "id" { "type" "number" }, "material id" { "type" "number" }, "material name" { "type" "string", "minlength" 1 }, "max grey level" { "type" "number" }, "max span" { "type" "number" }, "min grey level" { "type" "number" }, "min span" { "type" "number" }, "particle id" { "type" "number" }, "perimeter" { "type" "number" }, "segment count" { "type" "number" }, "weight" { "type" "number" }, "weight percent" { "type" "number" }, "xray count" { "type" "number" } } } }, "grain interfacial area" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "grain id 1", "grain id 2", "length", "particle id" ], "properties" { "grain id 1" { "type" "number" }, "grain id 2" { "type" "number" }, "length" { "type" "number" }, "particle id" { "type" "number" } } } }, "material" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "atomic number", "chemical formula", "color hex", "density", "id", "name" ], "properties" { "atomic number" { "type" "number" }, "chemical formula" { "type" "string", "minlength" 1 }, "color hex" { "type" "number" }, "density" { "type" "number" }, "id" { "type" "number" }, "name" { "type" "string", "minlength" 1 } } } }, "material association" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "particle count", "percent", "source material id", "source material name", "target material id", "target material name" ], "properties" { "particle count" { "type" "number" }, "percent" { "type" "number" }, "source material id" { "type" "number" }, "source material name" { "type" "string", "minlength" 1 }, "target material id" { "type" "number" }, "target material name" { "type" "string", "minlength" 1 } } } }, "material association parameter" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "material id", "material name", "particle count", "value" ], "properties" { "material id" { "type" "number" }, "material name" { "type" "string", "minlength" 1 }, "particle count" { "type" "number" }, "value" { "type" "number" } } } }, "material composition" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "element", "material id", "material name", "weight percent" ], "properties" { "element" { "type" "string", "minlength" 1 }, "material id" { "type" "number" }, "material name" { "type" "string", "minlength" 1 }, "weight percent" { "type" "number" } } } }, "material modal" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "area microns", "area percent", "area pixels", "color hex", "density", "grain count", "material id", "material name", "particle count", "segment count", "weight", "weight percent" ], "properties" { "area microns" { "type" "number" }, "area percent" { "type" "number" }, "area pixels" { "type" "number" }, "color hex" { "type" "number" }, "density" { "type" "number" }, "grain count" { "type" "number" }, "material id" { "type" "number" }, "material name" { "type" "string", "minlength" 1 }, "particle count" { "type" "number" }, "segment count" { "type" "number" }, "weight" { "type" "number" }, "weight percent" { "type" "number" } } } }, "particle" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "area microns", "area percent", "area pixels", "average grey level", "axis metrics max x", "axis metrics min x", "bounding rect height", "bounding rect width", "bounding rect x", "bounding rect y", "convex hull area", "convex hull perimeter", "density", "equivalent circle diameter", "equivalent ellipse diameter", "grain count", "id", "max grey level", "max span", "min grey level", "min span", "perimeter", "segment count", "shape factor", "weight", "weight percent", "xray count" ], "properties" { "area microns" { "type" "number" }, "area percent" { "type" "number" }, "area pixels" { "type" "number" }, "average grey level" { "type" "number" }, "axis metrics max x" { "type" "number" }, "axis metrics min x" { "type" "number" }, "bounding rect height" { "type" "number" }, "bounding rect width" { "type" "number" }, "bounding rect x" { "type" "number" }, "bounding rect y" { "type" "number" }, "convex hull area" { "type" "number" }, "convex hull perimeter" { "type" "number" }, "density" { "type" "number" }, "equivalent circle diameter" { "type" "number" }, "equivalent ellipse diameter" { "type" "number" }, "grain count" { "type" "number" }, "id" { "type" "number" }, "max grey level" { "type" "number" }, "max span" { "type" "number" }, "min grey level" { "type" "number" }, "min span" { "type" "number" }, "perimeter" { "type" "number" }, "segment count" { "type" "number" }, "shape factor" { "type" "number" }, "weight" { "type" "number" }, "weight percent" { "type" "number" }, "xray count" { "type" "number" } } } }, "particle material composition" { "type" "array", "uniqueitems" true, "minitems" 1, "items" { "required" \[ "grain count", "material area microns", "material area percent", "material area pixels", "material id", "material name", "material weight", "material weight percent", "particle area pixels", "particle id", "particle weight" ], "properties" { "grain count" { "type" "number" }, "material area microns" { "type" "number" }, "material area percent" { "type" "number" }, "material area pixels" { "type" "number" }, "material id" { "type" "number" }, "material name" { "type" "string", "minlength" 1 }, "material weight" { "type" "number" }, "material weight percent" { "type" "number" }, "particle area pixels" { "type" "number" }, "particle id" { "type" "number" }, "particle weight" { "type" "number" } } } }, "quantified elements assay" { "type" "array", "items" { "required" \[], "properties" {} } }, "quantified material composition" { "type" "array", "items" { "required" \[], "properties" {} } } }, "required" \[ "calculated elements assay", "calculated material composition", "field", "grain", "grain interfacial area", "material", "material association", "material association parameter", "material composition", "material modal", "particle", "particle material composition", "quantified elements assay", "quantified material composition" ] }, "total area" { "type" "number" }, "total weight" { "type" "number" }, "update time" { "type" "string", "minlength" 1 } } } } }, "required" \[ "format version", "method", "project name", "sample name", "sample uuid", "software name", "software version", "stage offset x", "stage offset y", "sub samples" ] }
