brapi_put_images_imageDbId: put /images/{imageDbId}

In mverouden/brapir: Client to Access BrAPI Compliant Plant Breeding Databases

put /images/{imageDbId}

Description

Update an image meta data

Usage

brapi_put_images_imageDbId(
  con = NULL,
  imageDbId = "",
  additionalInfo = list(),
  copyright = "",
  description = "",
  descriptiveOntologyTerms = "",
  imageFileName = "",
  imageFileSize = as.integer(NA),
  imageHeight = as.integer(NA),
  imageLocation = list(),
  imageName = "",
  imageTimeStamp = "",
  imageWidth = as.integer(NA),
  mimeType = "",
  observationDbIds = "",
  observationUnitDbId = ""
)

Arguments

con	list; required: TRUE; BrAPI connection object
imageDbId	character; required: TRUE; The unique identifier for a image
additionalInfo	list; required: FALSE;
copyright	character; required: FALSE; The copyright information of this image. Example 'Copyright 2018 Bob Robertson'; default: "".
description	character; required: FALSE; The human readable description of an image.; default: "".
descriptiveOntologyTerms	vector of type character; required: FALSE; A list of terms to formally describe the image. Each item could be a simple Tag, an Ontology reference Id, or a full ontology URL.; default: "", when using multiple values supply as c("value1", "value2").
imageFileName	character; required: FALSE; The name of the image file. Might be the same as 'imageName', but could be different.; default: "".
imageFileSize	integer; required: FALSE; The size of the image in Bytes.
imageHeight	integer; required: FALSE; The height of the image in Pixels.
imageLocation	list; required: FALSE; One geometry as defined by GeoJSON (RFC 7946). All coordinates are decimal values on the WGS84 geographic coordinate reference system.
imageName	character; required: FALSE; The human readable name of an image. Might be the same as 'imageFileName', but could be different.; default: "".
imageTimeStamp	character; required: FALSE; The date and time the image was taken and specified in the ISO 8601 standard, e.g. "2020-05-29T11:12:14.007Z"; default: "".
imageWidth	integer; required: FALSE; The width of the image in Pixels.
mimeType	character; required: FALSE; The file type of the image. Examples 'image/jpeg', 'image/png', 'image/svg', etc; default: "".
observationDbIds	vector of type character; required: FALSE; A list of observation Ids this image is associated with, if applicable.; default: "", when using multiple values supply as c("value1", "value2").
observationUnitDbId	character; required: FALSE; The related observation unit identifier, if relevant.; default: "".

Details

Update an image meta data object. This call should be paired with 'PUT /images/imageDbId/imagecontent' for full capability.

• The /images calls support a GeoJSON object structure for describing their location. The BrAPI spec for GeoJSON only supports two of the possible geometries: Points and Polygons. With most images, the Point geometry should be used, and it should indicate the longitude and latitude of the camera. For top down images (i.e. from drones, cranes, etc), the Point geometry may be used to indicate the longitude and latitude of the centroid of the image content, and the Polygon geometry may be used to indicate the border of the image content.

• imageLocation argument should be provided as a list. The easiest way in R to construct such a list is to use the geojsonR package. Below in the examples section examples are provided to create an imageLocation list object for a point and a polygon.

• descriptiveOntologyTerm can be thought of as Tags for the image. These could be simple descriptive words, or ontology references, or full ontology URI's.

Value

data.frame

Author(s)

brapir generator package

References

BrAPI SwaggerHub

See Also

Other brapi_1.3: brapi_get_allelematrices_search(), brapi_get_allelematrices(), brapi_get_attributes_categories(), brapi_get_attributes(), brapi_get_breedingmethods_breedingMethodDbId(), brapi_get_breedingmethods(), brapi_get_calls(), brapi_get_commoncropnames(), brapi_get_germplasm_germplasmDbId_attributes(), brapi_get_germplasm_germplasmDbId_markerprofiles(), brapi_get_germplasm_germplasmDbId_mcpd(), brapi_get_germplasm_germplasmDbId_pedigree(), brapi_get_germplasm_germplasmDbId_progeny(), brapi_get_germplasm_germplasmDbId(), brapi_get_germplasm(), brapi_get_images_imageDbId(), brapi_get_images(), brapi_get_lists_listDbId(), brapi_get_lists(), brapi_get_locations_locationDbId(), brapi_get_locations(), brapi_get_maps_mapDbId_positions_linkageGroupName(), brapi_get_maps_mapDbId_positions(), brapi_get_maps_mapDbId(), brapi_get_maps(), brapi_get_markerprofiles_markerProfileDbId(), brapi_get_markerprofiles(), brapi_get_markers_markerDbId(), brapi_get_markers(), brapi_get_methods_methodDbId(), brapi_get_methods(), brapi_get_observationlevels(), brapi_get_observationunits(), brapi_get_ontologies(), brapi_get_people_personDbId(), brapi_get_people(), brapi_get_programs(), brapi_get_samples_sampleDbId(), brapi_get_samples(), brapi_get_scales_scaleDbId(), brapi_get_scales(), brapi_get_search_germplasm_searchResultsDbId(), brapi_get_search_images_searchResultsDbId(), brapi_get_search_markers_searchResultsDbId(), brapi_get_search_observationtables_searchResultsDbId(), brapi_get_search_observationunits_searchResultsDbId(), brapi_get_search_programs_searchResultsDbId(), brapi_get_search_samples_searchResultsDbId(), brapi_get_search_studies_searchResultsDbId(), brapi_get_search_variables_searchResultsDbId(), brapi_get_seasons(), brapi_get_studies_studyDbId_germplasm(), brapi_get_studies_studyDbId_layouts(), brapi_get_studies_studyDbId_observations(), brapi_get_studies_studyDbId_observationunits(), brapi_get_studies_studyDbId_observationvariables(), brapi_get_studies_studyDbId_table(), brapi_get_studies_studyDbId(), brapi_get_studies(), brapi_get_studytypes(), brapi_get_traits_traitDbId(), brapi_get_traits(), brapi_get_trials_trialDbId(), brapi_get_trials(), brapi_get_variables_observationVariableDbId(), brapi_get_variables(), brapi_get_vendor_orders_orderId_plates(), brapi_get_vendor_orders_orderId_results(), brapi_get_vendor_orders_orderId_status(), brapi_get_vendor_orders(), brapi_get_vendor_plates_submissionId(), brapi_get_vendor_specifications(), brapi_post_allelematrices_search(), brapi_post_images(), brapi_post_lists_listDbId_items(), brapi_post_lists(), brapi_post_methods(), brapi_post_people(), brapi_post_phenotypes(), brapi_post_scales(), brapi_post_search_germplasm(), brapi_post_search_images(), brapi_post_search_markers(), brapi_post_search_observationtables(), brapi_post_search_observationunits(), brapi_post_search_programs(), brapi_post_search_samples(), brapi_post_search_studies(), brapi_post_search_variables(), brapi_post_studies_studyDbId_table(), brapi_post_traits(), brapi_post_vendor_orders(), brapi_post_vendor_plates(), brapi_put_images_imageDbId_imagecontent(), brapi_put_lists_listDbId(), brapi_put_methods_methodDbId(), brapi_put_people_personDbId(), brapi_put_samples(), brapi_put_scales_scaleDbId(), brapi_put_studies_studyDbId_layouts(), brapi_put_studies_studyDbId_observations(), brapi_put_studies_studyDbId_observationunits(), brapi_put_traits_traitDbId()

Other Images: brapi_get_images_imageDbId(), brapi_get_images(), brapi_get_search_images_searchResultsDbId(), brapi_post_images(), brapi_post_search_images(), brapi_put_images_imageDbId_imagecontent()

Examples

## Not run: 

# Create a connection object
con <- brapi_db()$testserver

library(geojsonR)
# Create an imageLocation example list object
# Point example for Wageningen University & Research
init <- TO_GeoJson$new()
imageLocation <- list()
pointData <- c(5.663038, 51.986648) # provide as c(longitude, latitude. altitude)
imageLocation[["geometry"]] <- init$Point(data = pointData, stringify = FALSE)
imageLocation[["type"]] <- "Feature"

# Polygon example with an exterior and interior ring
# The first list in polygonData creates the exterior ring, whereas
# following lists create interior rings.
init <- TO_GeoJson$new()
# Polygon data points are provided as c(longitude, latitude)
polygonData <- list(list(c(-76.476949, 42.447274), # exterior ring (rectangle)
                         c(-76.474429, 42.447258),
                         c(-76.474428, 42.446193),
                         c(-76.476961, 42.446211),
                         c(-76.476949, 42.447274)),
                    list(c(-76.476733, 42.446916), # interior ring (triangle)
                         c(-76.475810, 42.447154),
                         c(-76.476306, 42.446281),
                         c(-76.476733, 42.446916)))
imageLocation2 <- list()
imageLocation2[["geometry"]] <- init$Polygon(data = polygonData, stringify = FALSE)
imageLocation2[["type"]] <- "Feature"

# Make put /images/{imageDbId} call
# For the Point location example
output <- brapi_put_images_imageDbId(con = con,
                                     imageDbId = "img2",
                                     additionalInfo = list(
                                       additionalProp1 = "addProp1string",
                                       additionalProp2 = "addProp2string",
                                       additionalProp3 = "addProp3string"),
                                     copyright = "Copyright 2020",
                                     description = "BrAPI Logo 2020",
                                     descriptiveOntologyTerms = c(
                                       "brapi",
                                       "logo",
                                       "svg"),
                                     imageFileName = "brapi-logo.svg",
                                     imageFileSize = 3676,
                                     imageHeight = 56,
                                     imageLocation = imageLocation,
                                     imageName = "modified_brapiLogo",
                                     imageTimeStamp = "2020-05-29T11:30:12Z",
                                     imageWidth = 56,
                                     mimeType = "image/svg",
                                     observationDbIds = c("1", "2"),
                                     observationUnitDbId = "1")
# For the Polygon location example use `imageLocation = imageLocation2`

## End(Not run)

mverouden/brapir documentation built on April 10, 2022, 5:36 p.m.