Batch

Table of Contents

Images

Cutouts

Batches

blob_home and data_root - storage location information

batch_id - unique batch identifier

upload_datetime - when image were uploaded to “uploads” blob storage

image_list - list of images contained in a single batch folder

schema_version - version of data schema used for organizing metadata

Code Block

language	json

{
    "blob_home": "data",
    "data_root": "semifield-developed-images",
    "batch_id": "NC_2022-08-05",
    "upload_datetime": "2022-08-19_21:28:37",
    "image_list": [
        "images/NC_1659710908.jpg",
        "images/NC_1659711200.jpg",
        "images/NC_1659706234.jpg",
        ...
        "images/NC_1659709264.jpg",
        "images/NC_1659715086.jpg",
        "images/NC_1659706245.jpg"
        ],
    "schema_version": "1.0"
}

Images

Images - general

blob_home and data_root - storage location information

batch_id - unique batch identifier

image_id - unique image id comprised of state abbreviation and UNIX timestamp

image_path - Image filename with a single parent directory

plant_date - plant date for entire batch. Does not account for replantings.

growth_stage - estimated growth stage based on planting date

width and height - image height and width in pixels. May be downscaled as a result of autosfm; however, image in the “images”directory are full sized images. See fullres_width and fullres_height

exif_meta

camera_info

cutout_ids

bboxes

fullres_height

fullres_width

Code Block

language	json

{
    "blob_home": "data",
    "data_root": "semifield-developed-images",
    "batch_id": "NC_2022-07-27",
    "image_id": "NC_1658926241",
    "image_path": "images/NC_1658926241.jpg",
    "plant_date": "2022-06-09",
    "growth_stage": "vegetative",
    "width": 4780,
    "height": 3184,

"exif_meta": {

...

},

camera

fullres_

info

height":

{

6368,

...

},

   "fullres_width": 9560,

cutout

schema_

ids

version":

[ ... ], "bboxes": [ ... ], "fullres_height": 6368, "fullres_width": 9560, "schema_version": "1.0"

"1.0"
}

Images - Exif

Uses Exif-Py

pip install exifread

Technical tag information can be found here

Code Block

language	json

    "exif_meta": {
        "ImageWidth": 9560,
        "ImageLength": 6368,
        "BitsPerSample": 8,
        "Compression": 1,
        "PhotometricInterpretation": 2,
        "Make": "SONY",
        "Model": "ILCE-7RM4",
        "Orientation": 1,
        "SamplesPerPixel": 3,
        "XResolution": "300",
        "YResolution": "300",
        "PlanarConfiguration": 1,
        "ResolutionUnit": 2,
        "Software": "RawTherapee 5.8",
        "DateTime": "2022:07:27 08:49:15",
        "Rating": 0,
        "ExifOffset": 4449,
        "ExposureTime": "1/200",
        "FNumber": "10",
        "ExposureProgram": 1,
        "ISOSpeedRatings": 100,
        "RecommendedExposureIndex": 100,
        "ExifVersion": [
            48,
            50,
            51,
            49
        ],
        "DateTimeOriginal": "2022:07:27 08:49:15",
        "DateTimeDigitized": "2022:07:27 08:49:15",
        "BrightnessValue": "9207/1280",
        "ExposureBiasValue": "0",
        "MaxApertureValue": "217/128",
        "MeteringMode": 5,
        "LightSource": 0,
        "Flash": 16,
        "FocalLength": "55",
        "FileSource": 3,
        "SceneType": 1,
        "CustomRendered": 0,
        "ExposureMode": 1,
        "WhiteBalance": 0,
        "DigitalZoomRatio": "1",
        "FocalLengthIn35mmFilm": 55,
        "SceneCaptureType": 0,
        "Contrast": 0,
        "Saturation": 0,
        "Sharpness": 0,
        "LensSpecification": [
            "55",
            "55",
            "9/5",
            "9/5"
        ],
        "LensModel": "FE 55mm F1.8 ZA",
        "BodySerialNumber": null,
        "MakerNote": null,
        "ImageDescription": " ",
        "UserComment": null,
        "ApplicationNotes": null,
        "Tag": null,
        "SubIFDs": 4450
    }

Images -

Camera Info

camera info

camera_info

camera_location

pixel_width & pixel_height

yaw, pitch, roll

focal_length

fov

is_scaleable

Code Block

language	json

"camera_info": {
        "camera_location": [
              -0.1992725638544925,
              9.926811159768054,
              2.130928709515993
                            ],
        "pixel_width": 0.0075333198937023,
        "pixel_height": 0.0075333198937023,
        "yaw": 183.89777711639093,
        "pitch": -2.3366362127596525,
        "roll": 0.7135915032770658,
        "focal_length": 8747.80961719926,
        "fov": {
              "top_left": [
                    -0.8064812117393512,
                    10.27414293412319
              ],
              "top_right": [
                    0.3552128560424488,
                    10.353294011316107
              ],
              "bottom_left": [
                    -0.7537579837514339,
                    9.50032830822
              ],
              "bottom_right": [
                    0.4079360840303661,
                    9.579479385412917
              ],
              "is_scaleable": true
                }
              }

Images -

Cutouts

cutouts

cutout_ids

Code Block

language	json

"cutout_ids": ["cutout_ids": [
                "NC_1658926241_0",
                "NC_1658926241_01",
                "NC_1658926241_12",
                "NC_1658926241_2",3"
                 "NC_1658926241_3"
    ],

Images - Bounding Boxes

Images - bounding boxes

bbox_id

image_id

local_centroid

local_coordinates

is_scaleable

global_centroid

global_coordinates

Code Block

language	json

"bboxes": [
            {
              "bbox_id": "NC_1658926241_0",
              "image_id": "NC_1658926241",
              "local_centroid": [
                  0.7247684299945831,
                  0.782112181186676
              ],
              "local_coordinates": {
                  "top_left": [
                      4559.100573062897,
                      3592.980739593506
                  ],
                  "top_right": [
                      9298.47180843353,
                      3592.980739593506
                  ],,
                  "bottom_left": [
                      4559.100573062897,
                      6368.0
                  ],
                  "bottom_right": [
                      9298.47180843353,
                      6368.0
                  ],
                  "is_scaleable": true
            },
            "global_centroid": [
                -0.3805987383493097,                  10.21634506227248             ]},
              "global_coordinatescentroid": {
[
               "top_left": [  -0.3805987383493097,
                  -010.1245738268094071,21634506227248
              ],
     10.015139374543459               "global_coordinates": {
 ],                 "top_rightleft": [
                      -0.73039184682196741245738268094071,
                      10.11728321515172015139374543459
                  ],
                  "bottomtop_leftright": [
                      -0.078890302768243387303918468219674,
                      10.417550750001511728321515172
                  ],
                  "bottom_rightleft": [
                      -0.68230717393037607889030276824338,
                      10.4580620467576984175507500015
                  ],
                  "isbottom_scaleableright": true
[
           },           -0.682307173930376,
 "cls": {                 "scientific_name": "Amaranthus palmeri", 10.458062046757698
               "common_name": "Palmer amaranth"   ],
                  "USDAis_symbolscaleable": "AMPA",
 true
              "EPPO": "AMAPA",                 "authority": "Watson",     }
           "collection_location": "NC",  }
              "polygon_id": ""
]

Image - species

Code Block

language	json

"cls": {
        "scientific_name": "Amaranthus  },
   palmeri",
        "iscommon_primaryname": false,
   "Palmer amaranth",
        "overlappingUSDA_bbox_idssymbol": []
        }"AMPA",
        "EPPO": "AMAPA",
     {       "authority": "Watson",
     ...   "collection_location": "NC",
    }    "polygon_id": ""
        ],}

Cutouts

Cutouts - general

Code Block

language	json

{
    "blob_home": "data",
    "data_root": "semifield-cutouts",
    "batch_id": "NC_2022-08-05",
    "image_id": "NC_1659703400",
    "cutout_id": "NC_1659703400_0",
    "cutout_path": "NC_2022-08-05/NC_1659703400_0.png",
    "

cls

cutout_num":

{

0,
    "is_primary": false,
    "

scientific_name

datetime": "

Amaranthus palmeri

2022:08:05 08:41:41",
    "extends_border": true,
    "

common

cutout_

name

version": "

Palmer amaranth

1.0",
    "schema_version":

"USDA_symbol": "AMPA",

"1.0"
}

Cutouts - properties

Code Block

language	json

"cutout_props": {
        "EPPOarea": "AMAPA"28153.0,
        "authorityarea_bbox": "Watson"95480.0,
        "collectionarea_locationconvex": "NC"50539.0,
        "polygonaxis_major_idlength": ""248.60737102397786,
    },     "cutoutaxis_minor_numlength": 0212.34307812840584,
    "is_primary    "centroid0": false,156.52289276453664,
       "datetime": "2022:08:05 08:41:41"centroid1": 184.76936738535858,
    "cutout_props    "eccentricity": {0.5200591323747853,
        "areasolidity": 281530.05570549476641802,
        "area_bboxperimeter": 954801873.0559666716433,
        "areais_convexgreen": 50539.0true,
        "axis_major_length": 248.60737102397786,green_sum": 17637
    },

Cutouts - species

Code Block

language	json

"cls": {
        "axisscientific_minor_lengthname": 212.34307812840584 "Amaranthus palmeri",
        "centroid0common_name": 156.52289276453664"Palmer amaranth",
        "centroid1USDA_symbol": 184.76936738535858"AMPA",
        "eccentricityEPPO": 0.5200591323747853"AMAPA",
        "solidityauthority": 0.5570549476641802,
        "perimeter": 1873.559666716433"Watson",
        "iscollection_greenlocation": true"NC",
        "greenpolygon_sumid": 17637""
    },
    "extends_border": true,

Cutouts - contours

Code Block

language	json

"contours": {
     "cutout_version": "1.0",  
  "schema_version": "1.0" },

Versions Compared

Old Version 1

New Version Current

Key

Batches

Images

Images - general

Images - Exif

Images -

camera info

Images -

cutouts

Images - bounding boxes

Image - species

Cutouts

Cutouts - general

Cutouts - properties

Cutouts - species

Cutouts - contours

Page Comparison

Versions Compared

Old Version 1

New Version Current

Key

Batches

Images

Images - general

Images - Exif

Images -

camera info

Images -

cutouts

Images - bounding boxes

Image - species

Cutouts

Cutouts - general

Cutouts - properties

Cutouts - species

Cutouts - contours