{"_id":"573e0c707161463600014a18","project":"55faeacad0e22017005b8265","category":{"_id":"56ddf6df8a5ae10e008e3926","project":"55faeacad0e22017005b8265","pages":["56ddf8a4a6eb5c170042d72f"],"__v":1,"version":"55faeacad0e22017005b8268","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-03-07T21:47:11.224Z","from_sync":false,"order":21,"slug":"imagery","title":"IDAHO Guide"},"parentDoc":null,"version":{"_id":"55faeacad0e22017005b8268","project":"55faeacad0e22017005b8265","__v":36,"createdAt":"2015-09-17T16:31:06.800Z","releaseDate":"2015-09-17T16:31:06.800Z","categories":["55faeacbd0e22017005b8269","55faf550764f50210095078e","55faf5b5626c341700fd9e96","55faf8a7825d5f19001fa386","560052f91503430d007cc88f","560054f73aa0520d00da0b1a","56005aaf6932a00d00ba7c62","56005c273aa0520d00da0b3f","5601ae7681a9670d006d164d","5601ae926811d00d00ceb487","5601aeb064866b1900f4768d","5601aee850ee460d0002224c","5601afa02499c119000faf19","5601afd381a9670d006d1652","561d4c78281aec0d00eb27b6","561d588d8ca8b90d00210219","563a5f934cc3621900ac278c","5665c5763889610d0008a29e","566710a36819320d000c2e93","56ddf6df8a5ae10e008e3926","56e1c96b2506700e00de6e83","56e1ccc4e416450e00b9e48c","56e1ccdfe63f910e00e59870","56e1cd10bc46be0e002af26a","56e1cd21e416450e00b9e48e","56e3139a51857d0e008e77be","573b4f62ef164e2900a2b881","57c9d1335fd8ca0e006308ed","57e2bd9d1e7b7220000d7fa5","57f2b992ac30911900c7c2b6","58adb5c275df0f1b001ed59b","58c81b5c6dc7140f003c3c46","595412446ed4d9001b3e7b37","59e76ce41938310028037295","5a009de510890d001c2aabfe","5a96f89c89442e002041144b"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"v1","version_clean":"1.0.0","version":"1"},"user":"55fae9d4825d5f19001fa379","__v":6,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-05-19T18:56:48.973Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":1,"body":"# IDAHO Image Metadata Files Overview\n\nThese are the metadata files associated with IDAHO images. Not all metadata files are available for all IDAHO images. The metadata files available for an IDAHO image depends on the data source of the image. See \"profile\" information below.\n\nThis is the list of metadata files for an image. Click the name to see an example and metadata descriptions.\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"filename\",\n    \"h-1\": \"description\",\n    \"h-2\": \"example\",\n    \"0-0\": \"[image.json](#image.json)\",\n    \"0-1\": \"core image metadata files\",\n    \"1-0\": \"[rrds.json](#rrds.json)\",\n    \"1-1\": \"A listing of Reduced Resolution Datasets available for the IDAHO image\",\n    \"2-0\": \"[georeferencing.json](#georeferencing.json)\",\n    \"2-1\": \"Georeferencing information for the IDAHO Image\",\n    \"3-0\": \"[rpcs.json](#rpcs.json)\",\n    \"3-1\": \"DigitalGlobe RPC sensor model parameters\",\n    \"4-0\": \"[native_warp_spec.json](#native_warp_spec.json)\",\n    \"4-1\": \"Wrap grid for orthorectifying the IDAHO image.\",\n    \"5-0\": \"[histogram.json](#histogram.json)\",\n    \"5-1\": \"Histogram for the IDAHO image\"\n  },\n  \"cols\": 2,\n  \"rows\": 6\n}\n[/block]\n## Profiles\nIDAHO images fit into one of the  profiles listed here. The profile indicates which types of metadata are available for that image. \n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Profile Name (profileName)\",\n    \"h-1\": \"Source Image\",\n    \"0-0\": \"dg_1b\",\n    \"0-1\": \"DigitalGlobe level 1B image.\",\n    \"h-2\": \"Metadata types\",\n    \"0-2\": \"image.json\\nrpcs.json file\\nnative_warp_spec.json file\\n histogram.json file\\n 5 rrd levels\\nDG product metadata (.IMD, .XML, etc)\",\n    \"1-0\": \"georectified_image\",\n    \"1-1\": \"geoferenced image (as opposed to a raw or otherwise unrectified image)\",\n    \"1-2\": \"image.json\\ngeoreferencing.json\"\n  },\n  \"cols\": 3,\n  \"rows\": 2\n}\n[/block]\n## vendor Dataset Identifier\nFor DigitalGlobe images the vendorDatasetIdentifier is formatted; \"{PRODUCT_LEVEL}:{PRODUCT_ORDER_ID}:{CAT_ID}:{PRODUCT_CAT_ID}\". This identifier is useful as a means to reference back to other vendor-supplied catalogs.\n\nExample vendorDatasetIdentifier: \"LV1B:053864309030_01_P001:1030010037A14B00:2020010129405000\"\n\n# <a name=\"image.json\"></a>image.json\n\nThis file contains the core image metadata, such as number of rows/cols, data types, and  other common values used to select the image. The image.json file is required for all IDAHO images.\n\n### Example image.json file\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n  \\\"imageId\\\": \\\"bde4b243-a647-4699-807b-6abe0d6fcd12\\\",\\n  \\\"version\\\": \\\"1.0\\\",\\n  \\\"profileName\\\": \\\"dg_1b\\\",\\n  \\\"tileBucketName\\\": \\\"idaho-demo-oregon\\\",\\n  \\\"tilePartition\\\": \\\"0000\\\",\\n  \\\"nativeTileFileFormat\\\": \\\"TIF\\\",\\n  \\\"tileXOffset\\\": 0,\\n  \\\"tileYOffset\\\": 0,\\n  \\\"numXTiles\\\": 35,\\n  \\\"numYTiles\\\": 27,\\n  \\\"tileXSize\\\": 256,\\n  \\\"tileYSize\\\": 256,\\n  \\\"numBands\\\": 8,\\n  \\\"dataType\\\": \\\"UNSIGNED_SHORT\\\",\\n  \\\"imageHeight\\\": 6773,\\n  \\\"imageWidth\\\": 8820,\\n  \\\"sensorPlatformName\\\": \\\"WV02\\\",\\n  \\\"sensorName\\\": \\\"8-band (Coastal, Blue, Green, Yellow, Red, Red-edge, NIR1, NIR2) Multispectral\\\",\\n  \\\"vendorName\\\": \\\"DigitalGlobe, Inc.\\\",\\n  \\\"vendorDatasetIdentifier\\\": \\\"LV1B:053864309030_01_P001:1030010037A14B00:2020010129405000\\\",\\n  \\\"acquisitionDate\\\": \\\"2014-09-09T06:50:26.467Z\\\",\\n  \\\"colorInterpretation\\\": \\\"WORLDVIEW_8_BAND\\\",\\n  \\\"imageBoundsWGS84\\\": \\\"POLYGON ((58.71332241 25.66113728, 58.91368505 25.63821421, 58.91276839 25.50867659, 58.71402146 25.52907957, 58.71332241 25.66113728))\\\",\\n  \\\"groundSampleDistanceMeters\\\": 2.229\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Contents of image.json file\n[block:parameters]\n{\n  \"data\": {\n    \"0-0\": \"imageId\",\n    \"h-0\": \"Element\",\n    \"h-1\": \"Type\",\n    \"1-0\": \"version\",\n    \"2-0\": \"profileName\",\n    \"3-0\": \"tileBucketName\",\n    \"4-0\": \"tilePartition\",\n    \"5-0\": \"nativeTileFileFormat\",\n    \"6-0\": \"tileXOffset\",\n    \"7-0\": \"tileYOffset\",\n    \"8-0\": \"numXTiles\",\n    \"9-0\": \"numYTiles\",\n    \"10-0\": \"tileXSize\",\n    \"11-0\": \"tileYSize\",\n    \"12-0\": \"numBands\",\n    \"13-0\": \"dataType\",\n    \"14-0\": \"imageHeight\",\n    \"15-0\": \"imageWidth\",\n    \"16-0\": \"sensorPlatformName\",\n    \"17-0\": \"sensorName\",\n    \"18-0\": \"vendorName\",\n    \"19-0\": \"vendorDatasetIdentifier\",\n    \"20-0\": \"acquisitionDate\",\n    \"21-0\": \"colorInterpretation\",\n    \"22-0\": \"imageBoundsWGS84\",\n    \"23-0\": \"groundSampleDistanceMeters\",\n    \"h-2\": \"Description\",\n    \"0-1\": \"string\",\n    \"0-2\": \"The IDAHO ID\",\n    \"1-1\": \"string\",\n    \"1-2\": \"the IDAHO specification version\",\n    \"2-1\": \"string\",\n    \"2-2\": \"the profile that this IDAHO image conforms to. This can be used to know what files will exist for the image.\",\n    \"3-1\": \"string\",\n    \"3-2\": \"the bucket where the IDAHO images' tiles exist.\",\n    \"4-1\": \"string\",\n    \"4-2\": \"he partition where the IDAHO images' tiles exist. This value is used in deriving each tile's hash prefix\",\n    \"5-1\": \"string\",\n    \"5-2\": \"the image file format for the IDAHO images' tiles. Can be \\\"PNG\\\" or \\\"TIF\\\"\",\n    \"6-1\": \"number\",\n    \"6-2\": \"the X offset for the first upper left pixel of the IDAHO image\",\n    \"7-1\": \"number\",\n    \"7-2\": \"the Y offset for the first upper left pixel of the IDAHO image\",\n    \"8-1\": \"number\",\n    \"8-2\": \"the number of tiles across the X direction of the IDAHO image\",\n    \"9-1\": \"number\",\n    \"9-2\": \"the number of tiles in the Y direction of the IDAHO image\",\n    \"10-1\": \"number\",\n    \"10-2\": \"the number of pixels across the X direction in the IDAHO image tiles\",\n    \"11-1\": \"number\",\n    \"11-2\": \"the number of pixels in the Y direction in the IDAHO image tiles\",\n    \"12-1\": \"number\",\n    \"12-2\": \"the number of image bands in the IDAHO image tiles\",\n    \"13-1\": \"string\",\n    \"13-2\": \"the data type of the pixeles in the IDAHO image tiles\",\n    \"14-1\": \"number\",\n    \"14-2\": \"The number of pixels in the Y dimension of the IDAHO imag\",\n    \"15-1\": \"number\",\n    \"15-2\": \"The number of pixels in the X dimension of the IDAHO image\",\n    \"16-1\": \"string\",\n    \"16-2\": \"the name of the sensor platform (satellite) that captured the image\",\n    \"17-1\": \"string\",\n    \"17-2\": \"the name of the sensor that captured the image\",\n    \"18-1\": \"string\",\n    \"18-2\": \"the name of the company that produced the image\",\n    \"19-1\": \"string\",\n    \"19-2\": \"the vendor specific ID of the image\",\n    \"20-1\": \"string\",\n    \"20-2\": \"The date time when the image was captured\",\n    \"21-1\": \"string\",\n    \"21-2\": \"the name that indicates the band order of the image\",\n    \"22-1\": \"string\",\n    \"22-2\": \"the WKT geographical bounds of the image\",\n    \"23-1\": \"number\",\n    \"23-2\": \"the approximate size in meters of one pixel\"\n  },\n  \"cols\": 3,\n  \"rows\": 24\n}\n[/block]\n#  <a name=\"rrds.json\"></a>rrds.json\n\nThis file contains a list of Reduced Resolution Datasets (RRDs) of the IDAHO image. RRDs have lower spatial resolution and therefore are smaller and quicker to load then the full dataset. They  are used for quickly browsing over the imagery.\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"RRDs are each IDAHO images themselves and will contain their own metadata files.\"\n}\n[/block]\n### Example rrds.json file\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"reducedResolutionDataset\\\": [{\\n        \\\"sourceImage\\\": \\\"bde4b243-a647-4699-807b-6abe0d6fcd12\\\",\\n        \\\"targetImage\\\": \\\"f53538cc-58c0-4b4d-bb09-150f4ae4567d\\\",\\n        \\\"inverseScaleFactor\\\": 2.0\\n    }, {\\n        \\\"sourceImage\\\": \\\"f53538cc-58c0-4b4d-bb09-150f4ae4567d\\\",\\n        \\\"targetImage\\\": \\\"a35a0e9f-a07e-4df8-a72d-3c0e9bc9a315\\\",\\n        \\\"inverseScaleFactor\\\": 2.0\\n    }, {\\n        \\\"sourceImage\\\": \\\"a35a0e9f-a07e-4df8-a72d-3c0e9bc9a315\\\",\\n        \\\"targetImage\\\": \\\"7a315eb5-e9b5-4f89-bb0b-5abcbf43aec1\\\",\\n        \\\"inverseScaleFactor\\\": 2.0\\n    }, {\\n        \\\"sourceImage\\\": \\\"7a315eb5-e9b5-4f89-bb0b-5abcbf43aec1\\\",\\n        \\\"targetImage\\\": \\\"5df79860-90d3-4810-ade3-79ad0b063769\\\",\\n        \\\"inverseScaleFactor\\\": 2.0\\n    }, {\\n        \\\"sourceImage\\\": \\\"5df79860-90d3-4810-ade3-79ad0b063769\\\",\\n        \\\"targetImage\\\": \\\"d4adebe2-ee6b-401b-9d33-d2b9dfdbeaa2\\\",\\n        \\\"inverseScaleFactor\\\": 2.0\\n    }]\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Contents of rrds.json file\n\nThe rrds.json file contains a reducedResolutionDataset. Each rrd listed in the dataset consists of the following values:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Value\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"sourceImage\",\n    \"0-1\": \"string\",\n    \"0-2\": \"the IDAHO ID of the RRDs' source image\",\n    \"1-0\": \"targetImage\",\n    \"1-1\": \"string\",\n    \"1-2\": \"the IDAHO ID of the RRD image\",\n    \"2-0\": \"inverseScaleFactor\",\n    \"2-1\": \"number\",\n    \"2-2\": \"the scale factor used to produce the RRD\"\n  },\n  \"cols\": 3,\n  \"rows\": 3\n}\n[/block]\n### Location \n\nRRDs will be located in the same S3 bucket as the source image.\n\n#  <a name=\"georeferencing.json\"></a>georeferencing.json\n\nThis file contains the geographical referencing for the IDAHO image. The georeferencing metadata contains the parameters to build the affine transformation needed to georeference the image. IDAHO images with a profile of \"georectified_image\" will include the georeferencing.json file.\n\n### Example georeferencing.json\n\n\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"spatialReferenceSystemCode\\\": \\\"EPSG:4326\\\",\\n    \\\"scaleX\\\": 4.48787913602941E-6,\\n    \\\"scaleY\\\": -4.48787913602941E-6,\\n    \\\"translateX\\\": -108.63281025606044,\\n    \\\"translateY\\\": 46.66991963106043,\\n    \\\"shearX\\\": 0.0,\\n    \\\"shearY\\\": 0.0\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n### Contents georeferencing.json\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Value\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"spatialReferenceSystemCode\",\n    \"0-1\": \"string\",\n    \"0-2\": \"the system:value that specifies the spatial reference system\",\n    \"1-0\": \"scaleX\",\n    \"1-1\": \"number\",\n    \"1-2\": \"specifies the scale factor along the x axis\",\n    \"2-0\": \"scaleY\",\n    \"2-1\": \"number\",\n    \"2-2\": \"specifies the scale factor along the x axis\",\n    \"3-0\": \"translateX\",\n    \"3-1\": \"number\",\n    \"3-2\": \"specifies the displacement along the x axi\",\n    \"4-0\": \"translateY\",\n    \"4-2\": \"specifies the displacement along the y axis\",\n    \"4-1\": \"number\",\n    \"5-0\": \"shearX\",\n    \"5-1\": \"number\",\n    \"5-2\": \"specifies the shear factor along the x axis\",\n    \"6-0\": \"shearY\",\n    \"6-1\": \"number\",\n    \"6-2\": \"specifies the shear factor along the y axis\"\n  },\n  \"cols\": 3,\n  \"rows\": 7\n}\n[/block]\n#  <a name=\"rpcs.json\"></a>rpcs.json\n\nThis file contains the RPC information, which can be used to rectify the image. This is a mathematical mapping from object space coordinates to image space coordinates.\n\nThe values in the rpcs.json are the same as the DigitalGlobe RPC00B file.  Please refer to the [DigitalGlobe Imagery Support Data Documentation](http://global.digitalglobe.com/sites/default/files/ISD_External.pdf) for details .\n\n### Example rpcs.json file\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"spatialReferenceSystem\\\": \\\"EPSG:4326\\\",\\n    \\\"upperLeftCorner\\\": {\\n        \\\"x\\\": 58.71332241,\\n        \\\"y\\\": 25.66113728\\n    },\\n    \\\"upperRightCorner\\\": {\\n        \\\"x\\\": 58.91368505,\\n        \\\"y\\\": 25.63821421\\n    },\\n    \\\"lowerRightCorner\\\": {\\n        \\\"x\\\": 58.91276839,\\n        \\\"y\\\": 25.50867659\\n    },\\n    \\\"lowerLeftCorner\\\": {\\n        \\\"x\\\": 58.71402146,\\n        \\\"y\\\": 25.52907957\\n    },\\n    \\\"gsd\\\": 2.002335609054977E-5,\\n    \\\"lineOffset\\\": 3386.0,\\n    \\\"sampleOffset\\\": 4409.0,\\n    \\\"latOffset\\\": 25.5849,\\n    \\\"lonOffset\\\": 58.8134,\\n    \\\"heightOffset\\\": 11.0,\\n    \\\"lineScale\\\": 3386.0,\\n    \\\"sampleScale\\\": 4410.0,\\n    \\\"latScale\\\": 0.0778,\\n    \\\"lonScale\\\": 0.1023,\\n    \\\"heightScale\\\": 501.0,\\n    \\\"lineNumCoefs\\\": [-0.01247868, -0.1699803, -1.193688, -0.01892405, -0.002366152, -1.213828E-4, -2.886388E-4, -7.654795E-4, 0.009362892, 5.499658E-6, 3.702268E-5, 1.141359E-4, 9.568873E-4, 1.545527E-4, 8.740161E-4, 0.003490795, 0.001083495, 1.617478E-5, 9.24004E-5, 1.716484E-5],\\n    \\\"lineDenCoefs\\\": [1.0, -0.005079786, -0.003750422, -6.034228E-4, 0.001396144, 1.490369E-7, 1.645065E-4, -5.660189E-4, 0.003022191, -9.087502E-4, -1.39079E-5, 3.636066E-6, -5.448129E-4, 7.65754E-6, -6.239931E-5, -0.001555249, -2.609868E-6, 8.087889E-8, -5.860598E-5, 9.089406E-7],\\n    \\\"sampleNumCoefs\\\": [-0.006631238, 1.025698, 4.836109E-5, -0.02188833, -0.002148, 1.639059E-4, 9.741724E-5, 0.005816214, -3.656549E-5, -3.09791E-6, -2.092807E-6, 1.607785E-5, -4.504992E-5, -5.230266E-6, -4.981685E-5, 1.146771E-4, 2.640311E-7, 1.915519E-6, 6.6408E-6, 1.156241E-7],\\n    \\\"sampleDenCoefs\\\": [1.0, 8.39283E-4, 0.00220421, -3.132964E-4, 3.887315E-5, -1.358456E-6, 1.434978E-6, 6.141316E-6, 4.193624E-5, -5.176659E-6, 1.161258E-7, 6.575535E-8, -1.242692E-6, 2.477381E-8, 7.813111E-7, -9.281618E-6, -1.879341E-8, 0.0, -1.391419E-7, 0.0],\\n    \\\"postScaleFactorX\\\": 1.0,\\n    \\\"postScaleFactorY\\\": 1.0\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n\n#  <a name=\"native_warp_spec.json\"></a>native_warp_spec.json\n\nThe native_warp_spec.json file contains the warp grid specification for the IDAHO image. The warp grid can be used to orthorectify the IDAHO image.\n\n### Example native_warp_spec.json file\n[block:code]\n{\n  \"codes\": [\n    {\n      \"code\": \"{\\n    \\\"numXCells\\\": 201,\\n    \\\"numYCells\\\": 153,\\n    \\\"targetGeoTransform\\\": {\\n        \\\"scaleX\\\": 2.00234e-05,\\n        \\\"scaleY\\\": -2.00234e-05,\\n        \\\"shearX\\\": 0,\\n        \\\"shearY\\\": 0,\\n        \\\"spatialReferenceSystemCode\\\": \\\"EPSG:4326\\\",\\n        \\\"translateX\\\": 58.7133,\\n        \\\"translateY\\\": 25.6611\\n    },\\n    \\\"warpPositions\\\": [-4.91524, -3.30698, 38.9481, -8.94853, 82.0331, -15.1185, 125.709, -20.8939, 169.194 (this example list is truncated due to length)\\n    \\\"xStart\\\": 0,\\n    \\\"xStep\\\": 50,\\n    \\\"yStart\\\": 0,\\n    \\\"yStep\\\": 50\\n}\",\n      \"language\": \"json\"\n    }\n  ]\n}\n[/block]\n### Contents of  native_warp_spec.json file\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Value\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"numXCells\",\n    \"0-1\": \"number\",\n    \"0-2\": \"number of cells (2D points) in the X direction\",\n    \"1-0\": \"numYCells\",\n    \"1-1\": \"number\",\n    \"1-2\": \"number of cells (2D points) in the Y direction\",\n    \"2-0\": \"targetGeoTransform (values below indicated by \\\"*\\\")\",\n    \"2-2\": \"Target output affine in the given spatialReferenceSystemCode\",\n    \"3-0\": \"* spatialReferenceSystemCode\",\n    \"3-1\": \"string\",\n    \"3-2\": \"the system:value that specifies the spatial reference system\",\n    \"4-0\": \"* scaleX\",\n    \"4-1\": \"number\",\n    \"4-2\": \"specifies the scale factor along the x axis\",\n    \"5-0\": \"* scaleY\",\n    \"5-1\": \"number\",\n    \"5-2\": \"specifies the scale factor along the x axis\",\n    \"6-0\": \"* translateX\",\n    \"6-1\": \"number\",\n    \"6-2\": \"specifies the displacement along the x axis\",\n    \"7-0\": \"* translateY\",\n    \"7-1\": \"number\",\n    \"7-2\": \"specifies the displacement along the y axis\",\n    \"8-0\": \"* shearX\",\n    \"8-1\": \"number\",\n    \"8-2\": \"specifies the shear factor along the x axis\",\n    \"9-0\": \"* shearY\",\n    \"9-1\": \"number\",\n    \"9-2\": \"specifies the shear factor along the y axis\",\n    \"10-0\": \"xStart\",\n    \"10-1\": \"number\",\n    \"10-2\": \"the X postion of the upper left corner of the warp grid\",\n    \"11-0\": \"yStart\",\n    \"11-1\": \"number\",\n    \"11-2\": \"the Y postion of the upper left corner of the warp grid\",\n    \"12-0\": \"xStep\",\n    \"12-1\": \"number\",\n    \"12-2\": \"the X spacing in output pixels between the cells of the warp grid\",\n    \"13-0\": \"yStep\",\n    \"13-1\": \"number\",\n    \"13-2\": \"the Y spacing in output pixels between the cells of the warp grid\",\n    \"14-0\": \"warpPositions\",\n    \"14-1\": \"list\",\n    \"14-2\": \"list, a list of cells given in x1,y1,x2,y2,x3,y3,... order. The values represent input pixel row/col.\"\n  },\n  \"cols\": 3,\n  \"rows\": 15\n}\n[/block]\n#  <a name=\"histogram.json\"></a>histogram.json\n\nThis file contains the histogram for the IDAHO image.\n\nNote: Due to the length of each list in the histogram, an image of an example is being used here instead of real file contents.\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/y3oppP7ITVyQWHzz0bzB_histogram%20snippet.PNG\",\n        \"histogram snippet.PNG\",\n        \"870\",\n        \"307\",\n        \"#445a83\",\n        \"\"\n      ]\n    }\n  ]\n}\n[/block]\n## Contents of histogram.json file\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Value\",\n    \"h-1\": \"Type\",\n    \"h-2\": \"Description\",\n    \"0-0\": \"histograms (list values starred below)\",\n    \"0-1\": \"list\",\n    \"0-2\": \"list of name/value pairs\",\n    \"1-0\": \"* name\",\n    \"1-1\": \"string\",\n    \"1-2\": \"the name of the band\",\n    \"4-0\": \"numBands\",\n    \"4-1\": \"number\",\n    \"4-2\": \"number of bands in the histogram\",\n    \"3-0\": \"numBins\",\n    \"3-1\": \"list\",\n    \"3-2\": \"list of number of bins, there will be one value for each band\",\n    \"2-0\": \"* histogram\",\n    \"2-1\": \"list\",\n    \"2-2\": \"a list of counts, one for each bin\"\n  },\n  \"cols\": 3,\n  \"rows\": 5\n}\n[/block]","excerpt":"IDAHO metadata files and contents","slug":"idaho-reference","type":"basic","title":"IDAHO Metadata Files"}

Getting Started

GBDX Operations

GBDX Stories

Data Sets on GBDX

Raster Data Access (RDA) Guide

GBDX Notebooks

Authentication Guide

Ordering Guide

Catalog V2 API Guide

Algorithms

Tasks and Workflows Guide

S3 Storage Service Guide

Web Application (Deprecated)

Thumbnail Service Guide (Deprecated)

AnswerFactory Application

Read & Query Vector Services Guide

Aggregations & Facets Vector Services Guide

Write & Ingest Vector Services Guide

IDAHO Guide

Helpful Links

IDAHO Metadata Files

IDAHO metadata files and contents
# IDAHO Image Metadata Files Overview These are the metadata files associated with IDAHO images. Not all metadata files are available for all IDAHO images. The metadata files available for an IDAHO image depends on the data source of the image. See "profile" information below. This is the list of metadata files for an image. Click the name to see an example and metadata descriptions. [block:parameters] { "data": { "h-0": "filename", "h-1": "description", "h-2": "example", "0-0": "[image.json](#image.json)", "0-1": "core image metadata files", "1-0": "[rrds.json](#rrds.json)", "1-1": "A listing of Reduced Resolution Datasets available for the IDAHO image", "2-0": "[georeferencing.json](#georeferencing.json)", "2-1": "Georeferencing information for the IDAHO Image", "3-0": "[rpcs.json](#rpcs.json)", "3-1": "DigitalGlobe RPC sensor model parameters", "4-0": "[native_warp_spec.json](#native_warp_spec.json)", "4-1": "Wrap grid for orthorectifying the IDAHO image.", "5-0": "[histogram.json](#histogram.json)", "5-1": "Histogram for the IDAHO image" }, "cols": 2, "rows": 6 } [/block] ## Profiles IDAHO images fit into one of the profiles listed here. The profile indicates which types of metadata are available for that image. [block:parameters] { "data": { "h-0": "Profile Name (profileName)", "h-1": "Source Image", "0-0": "dg_1b", "0-1": "DigitalGlobe level 1B image.", "h-2": "Metadata types", "0-2": "image.json\nrpcs.json file\nnative_warp_spec.json file\n histogram.json file\n 5 rrd levels\nDG product metadata (.IMD, .XML, etc)", "1-0": "georectified_image", "1-1": "geoferenced image (as opposed to a raw or otherwise unrectified image)", "1-2": "image.json\ngeoreferencing.json" }, "cols": 3, "rows": 2 } [/block] ## vendor Dataset Identifier For DigitalGlobe images the vendorDatasetIdentifier is formatted; "{PRODUCT_LEVEL}:{PRODUCT_ORDER_ID}:{CAT_ID}:{PRODUCT_CAT_ID}". This identifier is useful as a means to reference back to other vendor-supplied catalogs. Example vendorDatasetIdentifier: "LV1B:053864309030_01_P001:1030010037A14B00:2020010129405000" # <a name="image.json"></a>image.json This file contains the core image metadata, such as number of rows/cols, data types, and other common values used to select the image. The image.json file is required for all IDAHO images. ### Example image.json file [block:code] { "codes": [ { "code": "{\n \"imageId\": \"bde4b243-a647-4699-807b-6abe0d6fcd12\",\n \"version\": \"1.0\",\n \"profileName\": \"dg_1b\",\n \"tileBucketName\": \"idaho-demo-oregon\",\n \"tilePartition\": \"0000\",\n \"nativeTileFileFormat\": \"TIF\",\n \"tileXOffset\": 0,\n \"tileYOffset\": 0,\n \"numXTiles\": 35,\n \"numYTiles\": 27,\n \"tileXSize\": 256,\n \"tileYSize\": 256,\n \"numBands\": 8,\n \"dataType\": \"UNSIGNED_SHORT\",\n \"imageHeight\": 6773,\n \"imageWidth\": 8820,\n \"sensorPlatformName\": \"WV02\",\n \"sensorName\": \"8-band (Coastal, Blue, Green, Yellow, Red, Red-edge, NIR1, NIR2) Multispectral\",\n \"vendorName\": \"DigitalGlobe, Inc.\",\n \"vendorDatasetIdentifier\": \"LV1B:053864309030_01_P001:1030010037A14B00:2020010129405000\",\n \"acquisitionDate\": \"2014-09-09T06:50:26.467Z\",\n \"colorInterpretation\": \"WORLDVIEW_8_BAND\",\n \"imageBoundsWGS84\": \"POLYGON ((58.71332241 25.66113728, 58.91368505 25.63821421, 58.91276839 25.50867659, 58.71402146 25.52907957, 58.71332241 25.66113728))\",\n \"groundSampleDistanceMeters\": 2.229\n}", "language": "json" } ] } [/block] ### Contents of image.json file [block:parameters] { "data": { "0-0": "imageId", "h-0": "Element", "h-1": "Type", "1-0": "version", "2-0": "profileName", "3-0": "tileBucketName", "4-0": "tilePartition", "5-0": "nativeTileFileFormat", "6-0": "tileXOffset", "7-0": "tileYOffset", "8-0": "numXTiles", "9-0": "numYTiles", "10-0": "tileXSize", "11-0": "tileYSize", "12-0": "numBands", "13-0": "dataType", "14-0": "imageHeight", "15-0": "imageWidth", "16-0": "sensorPlatformName", "17-0": "sensorName", "18-0": "vendorName", "19-0": "vendorDatasetIdentifier", "20-0": "acquisitionDate", "21-0": "colorInterpretation", "22-0": "imageBoundsWGS84", "23-0": "groundSampleDistanceMeters", "h-2": "Description", "0-1": "string", "0-2": "The IDAHO ID", "1-1": "string", "1-2": "the IDAHO specification version", "2-1": "string", "2-2": "the profile that this IDAHO image conforms to. This can be used to know what files will exist for the image.", "3-1": "string", "3-2": "the bucket where the IDAHO images' tiles exist.", "4-1": "string", "4-2": "he partition where the IDAHO images' tiles exist. This value is used in deriving each tile's hash prefix", "5-1": "string", "5-2": "the image file format for the IDAHO images' tiles. Can be \"PNG\" or \"TIF\"", "6-1": "number", "6-2": "the X offset for the first upper left pixel of the IDAHO image", "7-1": "number", "7-2": "the Y offset for the first upper left pixel of the IDAHO image", "8-1": "number", "8-2": "the number of tiles across the X direction of the IDAHO image", "9-1": "number", "9-2": "the number of tiles in the Y direction of the IDAHO image", "10-1": "number", "10-2": "the number of pixels across the X direction in the IDAHO image tiles", "11-1": "number", "11-2": "the number of pixels in the Y direction in the IDAHO image tiles", "12-1": "number", "12-2": "the number of image bands in the IDAHO image tiles", "13-1": "string", "13-2": "the data type of the pixeles in the IDAHO image tiles", "14-1": "number", "14-2": "The number of pixels in the Y dimension of the IDAHO imag", "15-1": "number", "15-2": "The number of pixels in the X dimension of the IDAHO image", "16-1": "string", "16-2": "the name of the sensor platform (satellite) that captured the image", "17-1": "string", "17-2": "the name of the sensor that captured the image", "18-1": "string", "18-2": "the name of the company that produced the image", "19-1": "string", "19-2": "the vendor specific ID of the image", "20-1": "string", "20-2": "The date time when the image was captured", "21-1": "string", "21-2": "the name that indicates the band order of the image", "22-1": "string", "22-2": "the WKT geographical bounds of the image", "23-1": "number", "23-2": "the approximate size in meters of one pixel" }, "cols": 3, "rows": 24 } [/block] # <a name="rrds.json"></a>rrds.json This file contains a list of Reduced Resolution Datasets (RRDs) of the IDAHO image. RRDs have lower spatial resolution and therefore are smaller and quicker to load then the full dataset. They are used for quickly browsing over the imagery. [block:callout] { "type": "info", "title": "RRDs are each IDAHO images themselves and will contain their own metadata files." } [/block] ### Example rrds.json file [block:code] { "codes": [ { "code": "{\n \"reducedResolutionDataset\": [{\n \"sourceImage\": \"bde4b243-a647-4699-807b-6abe0d6fcd12\",\n \"targetImage\": \"f53538cc-58c0-4b4d-bb09-150f4ae4567d\",\n \"inverseScaleFactor\": 2.0\n }, {\n \"sourceImage\": \"f53538cc-58c0-4b4d-bb09-150f4ae4567d\",\n \"targetImage\": \"a35a0e9f-a07e-4df8-a72d-3c0e9bc9a315\",\n \"inverseScaleFactor\": 2.0\n }, {\n \"sourceImage\": \"a35a0e9f-a07e-4df8-a72d-3c0e9bc9a315\",\n \"targetImage\": \"7a315eb5-e9b5-4f89-bb0b-5abcbf43aec1\",\n \"inverseScaleFactor\": 2.0\n }, {\n \"sourceImage\": \"7a315eb5-e9b5-4f89-bb0b-5abcbf43aec1\",\n \"targetImage\": \"5df79860-90d3-4810-ade3-79ad0b063769\",\n \"inverseScaleFactor\": 2.0\n }, {\n \"sourceImage\": \"5df79860-90d3-4810-ade3-79ad0b063769\",\n \"targetImage\": \"d4adebe2-ee6b-401b-9d33-d2b9dfdbeaa2\",\n \"inverseScaleFactor\": 2.0\n }]\n}", "language": "json" } ] } [/block] ### Contents of rrds.json file The rrds.json file contains a reducedResolutionDataset. Each rrd listed in the dataset consists of the following values: [block:parameters] { "data": { "h-0": "Value", "h-1": "Type", "h-2": "Description", "0-0": "sourceImage", "0-1": "string", "0-2": "the IDAHO ID of the RRDs' source image", "1-0": "targetImage", "1-1": "string", "1-2": "the IDAHO ID of the RRD image", "2-0": "inverseScaleFactor", "2-1": "number", "2-2": "the scale factor used to produce the RRD" }, "cols": 3, "rows": 3 } [/block] ### Location RRDs will be located in the same S3 bucket as the source image. # <a name="georeferencing.json"></a>georeferencing.json This file contains the geographical referencing for the IDAHO image. The georeferencing metadata contains the parameters to build the affine transformation needed to georeference the image. IDAHO images with a profile of "georectified_image" will include the georeferencing.json file. ### Example georeferencing.json [block:code] { "codes": [ { "code": "{\n \"spatialReferenceSystemCode\": \"EPSG:4326\",\n \"scaleX\": 4.48787913602941E-6,\n \"scaleY\": -4.48787913602941E-6,\n \"translateX\": -108.63281025606044,\n \"translateY\": 46.66991963106043,\n \"shearX\": 0.0,\n \"shearY\": 0.0\n}", "language": "json" } ] } [/block] ### Contents georeferencing.json [block:parameters] { "data": { "h-0": "Value", "h-1": "Type", "h-2": "Description", "0-0": "spatialReferenceSystemCode", "0-1": "string", "0-2": "the system:value that specifies the spatial reference system", "1-0": "scaleX", "1-1": "number", "1-2": "specifies the scale factor along the x axis", "2-0": "scaleY", "2-1": "number", "2-2": "specifies the scale factor along the x axis", "3-0": "translateX", "3-1": "number", "3-2": "specifies the displacement along the x axi", "4-0": "translateY", "4-2": "specifies the displacement along the y axis", "4-1": "number", "5-0": "shearX", "5-1": "number", "5-2": "specifies the shear factor along the x axis", "6-0": "shearY", "6-1": "number", "6-2": "specifies the shear factor along the y axis" }, "cols": 3, "rows": 7 } [/block] # <a name="rpcs.json"></a>rpcs.json This file contains the RPC information, which can be used to rectify the image. This is a mathematical mapping from object space coordinates to image space coordinates. The values in the rpcs.json are the same as the DigitalGlobe RPC00B file. Please refer to the [DigitalGlobe Imagery Support Data Documentation](http://global.digitalglobe.com/sites/default/files/ISD_External.pdf) for details . ### Example rpcs.json file [block:code] { "codes": [ { "code": "{\n \"spatialReferenceSystem\": \"EPSG:4326\",\n \"upperLeftCorner\": {\n \"x\": 58.71332241,\n \"y\": 25.66113728\n },\n \"upperRightCorner\": {\n \"x\": 58.91368505,\n \"y\": 25.63821421\n },\n \"lowerRightCorner\": {\n \"x\": 58.91276839,\n \"y\": 25.50867659\n },\n \"lowerLeftCorner\": {\n \"x\": 58.71402146,\n \"y\": 25.52907957\n },\n \"gsd\": 2.002335609054977E-5,\n \"lineOffset\": 3386.0,\n \"sampleOffset\": 4409.0,\n \"latOffset\": 25.5849,\n \"lonOffset\": 58.8134,\n \"heightOffset\": 11.0,\n \"lineScale\": 3386.0,\n \"sampleScale\": 4410.0,\n \"latScale\": 0.0778,\n \"lonScale\": 0.1023,\n \"heightScale\": 501.0,\n \"lineNumCoefs\": [-0.01247868, -0.1699803, -1.193688, -0.01892405, -0.002366152, -1.213828E-4, -2.886388E-4, -7.654795E-4, 0.009362892, 5.499658E-6, 3.702268E-5, 1.141359E-4, 9.568873E-4, 1.545527E-4, 8.740161E-4, 0.003490795, 0.001083495, 1.617478E-5, 9.24004E-5, 1.716484E-5],\n \"lineDenCoefs\": [1.0, -0.005079786, -0.003750422, -6.034228E-4, 0.001396144, 1.490369E-7, 1.645065E-4, -5.660189E-4, 0.003022191, -9.087502E-4, -1.39079E-5, 3.636066E-6, -5.448129E-4, 7.65754E-6, -6.239931E-5, -0.001555249, -2.609868E-6, 8.087889E-8, -5.860598E-5, 9.089406E-7],\n \"sampleNumCoefs\": [-0.006631238, 1.025698, 4.836109E-5, -0.02188833, -0.002148, 1.639059E-4, 9.741724E-5, 0.005816214, -3.656549E-5, -3.09791E-6, -2.092807E-6, 1.607785E-5, -4.504992E-5, -5.230266E-6, -4.981685E-5, 1.146771E-4, 2.640311E-7, 1.915519E-6, 6.6408E-6, 1.156241E-7],\n \"sampleDenCoefs\": [1.0, 8.39283E-4, 0.00220421, -3.132964E-4, 3.887315E-5, -1.358456E-6, 1.434978E-6, 6.141316E-6, 4.193624E-5, -5.176659E-6, 1.161258E-7, 6.575535E-8, -1.242692E-6, 2.477381E-8, 7.813111E-7, -9.281618E-6, -1.879341E-8, 0.0, -1.391419E-7, 0.0],\n \"postScaleFactorX\": 1.0,\n \"postScaleFactorY\": 1.0\n}", "language": "json" } ] } [/block] # <a name="native_warp_spec.json"></a>native_warp_spec.json The native_warp_spec.json file contains the warp grid specification for the IDAHO image. The warp grid can be used to orthorectify the IDAHO image. ### Example native_warp_spec.json file [block:code] { "codes": [ { "code": "{\n \"numXCells\": 201,\n \"numYCells\": 153,\n \"targetGeoTransform\": {\n \"scaleX\": 2.00234e-05,\n \"scaleY\": -2.00234e-05,\n \"shearX\": 0,\n \"shearY\": 0,\n \"spatialReferenceSystemCode\": \"EPSG:4326\",\n \"translateX\": 58.7133,\n \"translateY\": 25.6611\n },\n \"warpPositions\": [-4.91524, -3.30698, 38.9481, -8.94853, 82.0331, -15.1185, 125.709, -20.8939, 169.194 (this example list is truncated due to length)\n \"xStart\": 0,\n \"xStep\": 50,\n \"yStart\": 0,\n \"yStep\": 50\n}", "language": "json" } ] } [/block] ### Contents of native_warp_spec.json file [block:parameters] { "data": { "h-0": "Value", "h-1": "Type", "h-2": "Description", "0-0": "numXCells", "0-1": "number", "0-2": "number of cells (2D points) in the X direction", "1-0": "numYCells", "1-1": "number", "1-2": "number of cells (2D points) in the Y direction", "2-0": "targetGeoTransform (values below indicated by \"*\")", "2-2": "Target output affine in the given spatialReferenceSystemCode", "3-0": "* spatialReferenceSystemCode", "3-1": "string", "3-2": "the system:value that specifies the spatial reference system", "4-0": "* scaleX", "4-1": "number", "4-2": "specifies the scale factor along the x axis", "5-0": "* scaleY", "5-1": "number", "5-2": "specifies the scale factor along the x axis", "6-0": "* translateX", "6-1": "number", "6-2": "specifies the displacement along the x axis", "7-0": "* translateY", "7-1": "number", "7-2": "specifies the displacement along the y axis", "8-0": "* shearX", "8-1": "number", "8-2": "specifies the shear factor along the x axis", "9-0": "* shearY", "9-1": "number", "9-2": "specifies the shear factor along the y axis", "10-0": "xStart", "10-1": "number", "10-2": "the X postion of the upper left corner of the warp grid", "11-0": "yStart", "11-1": "number", "11-2": "the Y postion of the upper left corner of the warp grid", "12-0": "xStep", "12-1": "number", "12-2": "the X spacing in output pixels between the cells of the warp grid", "13-0": "yStep", "13-1": "number", "13-2": "the Y spacing in output pixels between the cells of the warp grid", "14-0": "warpPositions", "14-1": "list", "14-2": "list, a list of cells given in x1,y1,x2,y2,x3,y3,... order. The values represent input pixel row/col." }, "cols": 3, "rows": 15 } [/block] # <a name="histogram.json"></a>histogram.json This file contains the histogram for the IDAHO image. Note: Due to the length of each list in the histogram, an image of an example is being used here instead of real file contents. [block:image] { "images": [ { "image": [ "https://files.readme.io/y3oppP7ITVyQWHzz0bzB_histogram%20snippet.PNG", "histogram snippet.PNG", "870", "307", "#445a83", "" ] } ] } [/block] ## Contents of histogram.json file [block:parameters] { "data": { "h-0": "Value", "h-1": "Type", "h-2": "Description", "0-0": "histograms (list values starred below)", "0-1": "list", "0-2": "list of name/value pairs", "1-0": "* name", "1-1": "string", "1-2": "the name of the band", "4-0": "numBands", "4-1": "number", "4-2": "number of bands in the histogram", "3-0": "numBins", "3-1": "list", "3-2": "list of number of bins, there will be one value for each band", "2-0": "* histogram", "2-1": "list", "2-2": "a list of counts, one for each bin" }, "cols": 3, "rows": 5 } [/block]