Entity relations and description

Transactional data

Data created and managed by users. Example: plots, scoutings, application orders, etc

Master data

Data created and managed by SIMA staff. Example: cultivations, formulated, phenological states, etc.

Structure entities

These entities organize all user data both geographically and chronologically.

 

Source: https://app.diagrams.net/?libs=general;er#G1rpUaIvTA8G-vSfiX-1Jz0g7PkLjzovaO

Common transactional properties

These properties are shared by all transactional entites

Property

Type

Description

Property

Type

Description

id

Integer

Autogenerated, incremental. Not visible to user

createdBy

String

Email of user who created the entity

createdById

Int

Id of the user who created the entity

observations

String

Notes provided by the user

refNumber

String

Autogenerated identification number visible to user.

lat

Decimal

Latitude where this entity was created

lon

Decimal

Longitud where this entity was created

Farmer

tRANSACTIONAL DATA

Represent a farmer or grower. Can also be used to represent a group or zone.

Property

Type

Description

Property

Type

Description

society

Int

Id of society

name

String

Farmer name

lastname

String

Farmer lastname

Establishment

tRANSACTIONAL DATA

Represents a group of plots (fields)

Property

Type

Description

Property

Type

Description

name

String

Establishment name

farmer

Int

Farmer ID

Plot

tRANSACTIONAL DATA

Represents a single field

Property

Type

Description

Property

Type

Description

name

String

Plot name

number

Int

Plot number (deprecado)

geometry

String

GeoJson representing the plot boundaries

establishment

Int

Establishment ID

active

boolean

Flag this plot active or inactive

Campaign

tRANSACTIONAL DATA

Cronological representation of the crop and other characteristics that affected the plot in a particular cycle (season)

Property

Type

Description

Property

Type

Description

masterCampaign

Int

Master campaign ID

daysFromPlanting

Int

Number of days since planting

schedulePlantingDate

Date

Schedule date of planting

plantingDate

Date

Date of the actual planting

plantingDistance

Int

Distance between grooves in Cm

plantingObjectiveDensitySeedsMeter

Int

The objective (planned) density of seeds per meter.

plantingObjectiveDensityPlantsHa

Int

The objective (planned) density of plants per hectare.

plantingObjetiveGerminativePower

Int

 

plantingObjectiveAchievementCoefficient

Int

The objective (planned) density in Kg/Ha.

plantingObjectiveAreaHa

Int

The objective (planned) planting area

plantingObjectiveDensityKgHa

Int

 

objectiveYieldKgHa

Int

The objective (planned) yield in Kg/Ha

plantedArea

Int

The actual planted area

harvestFinished

Boolean

Flag indicating if harvest is complete

harvestFinalYield

Int

The actual yield obtained

plantingFinished

Boolean

Flag indicating if planting is complete

plot

Int

Plot ID

plantingSystem

Int

The planting system

formulated

Int

The variety or hybrid planted

active

Boolean

Flag this campaign active or inactive

Master Campaign

tRANSACTIONAL DATA

Groups three key aspects of campaigns: The cultivation (crop), cycle (season) and planting time. Master campaigns group a number of campaigns that share these attributes.

Property

Type

Description

Property

Type

Description

name

String

Name of the master campaign

cultivation

Int

Cultivation ID

plantingTime

Int

Planting time ID

cycle

Int

Cycle ID

Master Campaign Cycle

master DATA

Past and future seasons for the corresponding user’s country. Examples for Argentina: “2019/2020“, “2020/2021“, etc.

Property

Type

Description

Property

Type

Description

name

String

Name of cycle

dateFrom

Date

Beginning of season

dateTo

Date

End of season

 

Cultivation

master DATA

Crops. Examples Soy, wheat, corn, etc.

Property

Type

Description

Property

Type

Description

name

String

Name of crop

Planting time

master DATA

The moment of planting. Varies depending on the country. Examples for Argentina: “De primera“, “De segunda“, “Tardio“

Property

Type

Description

Property

Type

Description

name

String

Name of planting time

Formulated

master DATA

Inputs. They represent crop’s varieties or hybrids, insesticides, herbicides, etc

Property

Type

Description

Property

Type

Description

l1

String

Name line 1

l2

String

Name line 2

l3

String

Name line 3

unit_id

Int

Unit ID

ai_id

Int

Active Ingredient ID

cnt

String

Concentration

apt

String

Aptitude

use_id

Int

Formulated use ID. Used to clasify formulateds in, for example, herbicides or insesticed

tc

String

Toxicological class

Scouting entities

 

Scouting

tRANSACTIONAL DATA

Scoutings represents field visits where users can measure several aspects of the field. They can have several sampling stations and in each of them, the user may take some measures regarding the adversities present in that particular sample. An adversity may be, for example, a weed, insect or disease affecting the crop.

Property

Type

Description

Property

Type

Description

campaign

Int

Campaign ID

a0 (semaphore)

Int

Semaphore representing the state of this scouting. 1 = Green, 2 = Yellow, 3 = Red

a1 (samplesTaken)

Int

Number of samples taken in this scouting

a2 (knots)

Int

Number of knots

a3 (clothSize)

Decimal

Deprected

a4 (phenological state)

Int

Phenological state ID

a5 (HydricState)

Int

Hydric state ID

a6 (plot state)

Int

Plot state ID

a7 (estimatedYield)

Decimal

Estimated yield in Kg/Ha

a8 (plant height)

int

Height of the plant

spr

Collection

Collection of ScoutingProtocolResult.

ssa

Collection

Collection of ScoutingSampleAlert.

Scouting Protocol Result

tRANSACTIONAL DATA

The final aggregated result of a scouting measure given a scouting protocol and adversity

Property

Type

Description

Property

Type

Description

a0 (adversity)

Int

Adversity ID

a1 (scouting protocol)

Int

Scouting protocol ID

a2 (scouting measure)

Int

Scouting measure ID

a3 (value)

Decimal

The decimal value of the measure

a4 (semaphore)

Int

Semaphore representing the state of this result. 1 = Green, 2 = Yellow, 3 = Red

Scouting Sample Alert

tRANSACTIONAL DATA

The final aggregated result of a scouting measure given a scouting protocol and adversity

Property

Type

Description

Property

Type

Description

a0 (sample)

Int

Sample number

a1 (semaphore weeds)

Int

Semaphore for weeds

a2 (semaphore insects)

Int

Semaphore for insects

a3 (semaphore diseases)

Int

Semaphore for diseases

a4 (semaphore summary)

Int

Summary semaphore

a5 (lat)

Decimal

Latitude of sample station

a6 (lon)

Decimal

Longitude of sample station

Scouting Sample Value

tRANSACTIONAL DATA

Property

Type

Description

Property

Type

Description

a0 (sample)

Int

Sample number

a1 (value)

Decimal

Value

a2 (semaphore)

Int

Semaphore

a3 (protocol_id)

Int

Scouting protocol ID

a4 (adversity_id)

Int

Adversity ID

a5 (measure_id)

Int

Scouting measure ID

Scouting Adversity

master DATA

An adversity represents anything that may be present at the field or affecting the crop.

Property

Type

Description

Property

Type

Description

a0 (name)

String

Name of adversity

a1 (scientificName)

Int

Scientific name

a2 (description)

String

Description

a3 (isResistant)

Boolean

Flag indicating if the adversity is resistant.

a4 (symptoms)

String

Description of symptoms

a5 (predisposingConditions)

String

Describes the situations and conditions where this adversity may emerge.

a6 (handling)

String

Describes the procedure of how this adversity should be treated.

a8 (defaultPhotoId)

Int

Photo ID. Only available for SIMA mobile application.

a7 (category)

Int

Category ID

a9 (kind)

Int

Kind ID

Scouting Measure

master DATA

A measure represents any measurable value from an adversity. Example: Damage, growth, count of individuals, etc.

Property

Type

Description

Property

Type

Description

a0 (unit)

String

Unit of measure

a1 (controlType)

String

The type of UI control presented to the user.

  • counter: button

  • slider: seekbar or progress bar

  • checkbox: checkbox

  • decimalValue: a decimal value inputed by keyboard

a2 (kind)

Int

Kind ID

a3

 

deprecated

a4

 

deprecated

Scouting Protocol

master DATA

A protocol groups a number of measures. A protocol is later assigned to an adversity for a specific country and crop.

Property

Type

Description

Property

Type

Description

a0 (name)

String

Name of protocol

a1 (procedure)

String

The procedure or description of the protocol

a2

 

deprectated

a3 (kind)

Int

Kind ID

Scouting Category

master DATA

Adversities belong to a Category. Examples of categories for Argentina: “Defoliadoras“, “Chinches“, “Dicotiledoneas perennes“

Property

Type

Description

Property

Type

Description

a0 (name)

String

Name of category

a1 (description)

String

Description of category

a2 (kind)

Int

Kind ID

Scouting Adversity Kind

master DATA

Categories belong to a Kind. Examples of kinds for Argentina: “Malezas“, “Insectos“, “Enfermedades“

Property

Type

Description

Property

Type

Description

a0 (name)

String

Name of kind

Scouting Protocol Measure

master DATA

Property

Type

Description

Property

Type

Description

a0 (min)

Decimal

 

a1 (max)

Decimal

 

a2 (step)

String

 

a3 (scale_values)

Text

 

a4 (scale_legends)

Text

 

a5 (measure_id)

Int

 

a6 (protocol_id)

Int

 

a7 (scale_images)

Text

 

a8 (keep_sample_value)

Boolean

 

a9 (default_value)

Decimal

 

a10 (self_calculation_expression)

Text

 

Scouting Protocol Adversities

MASTER DATA

Property

Type

Description

Property

Type

Description

a0 (adversity_id)

Int

 

a1 (cultivation_id)

Int

 

a2 (protocol_id)

Int

 

a3 (society_id)

Int

 

a4 (show_protocol_name)

Boolean

 

a5 (exclude_equivalent)

Boolean

 

Phenological state

master DATA

Phenological state of the plant.

Property

Type

Description

Property

Type

Description

name

String

Name of phenological state

description

String

Description

cultivation

Int

Cultivation ID

Measure threshold

master DATA

List of thresholds that determines a semaphore (color) for a given cultivation, cultivation phenology, protocol, adversity, measure, and userValue (value inputted by the user)

Property

Type

Description

Property

Type

Description

a1 (cultivation)

Int

Cultivation ID

a2 (protocol)

Int

Protocol ID

a3 (measure)

Int

Measure ID

a4 (phenWeightFrom)

Int

Phenology weight (from)

a5 (phenWeightTo)

Int

Phenology weight (to)

a6 (active)

Int

Flag this threshold active or inactive

a7 (adversity)

Int

Adversity ID

g (green)

y (yellow)

r (red)

Decimal

If userValue is between green and yellow, then the semaphore es green.

If userValue is between yellow and red, then the semaphore es yellow.

If userValue is bigger than red, then the semaphore es red.

 

Order entities

Application Order (Work order)

tRANSACTIONAL DATA

An order indicates the inputs (formulateds) and campaigns where they should be applied. An order may have one or more inputs and one or more campaigns associated to it. Once a work order is executed (completed), confirmations can be specified with extact doses and the total applied in each campaign.

Property

Type

Description

Property

Type

Description

applicationName

String

Name defined by user

nozzles

Int

Nozzle ID

dateIssued

Date

The date this order was issued

dateConfirmed

Date

The date this order was executed (completed)

plantingDistance

Int

The recommended distances between grooves for this order.

objectiveDensitySeedM

Int

The objective (planned) seed density in meters

orderType

Int

Orders can be:

  • Application Order = orderType = 7

  • Planting Order = orderType = 17

  • Fertilization Order = orderType = 18

  • Harvest Order = orderType = 19

creation_system_id

Int

system where it was created: Ej 4 (android)

application_campaigns

Collection

Collection of application_campaign

application_formulated

Collection

Collection of application_formulated

application_confirmations

Collection

Collection of application_campaign

application_campaign

tRANSACTIONAL DATA

Represents a campaign associated to an order

Property

Type

Description

Property

Type

Description

applicationOrder

Int

Application Order ID

campaign

Int

Campaign ID

areaToApply

Decimal

Recommended area to apply

application_formulated

tRANSACTIONAL DATA

Represents an input (formulated) associated to an order

Property

Type

Description

Property

Type

Description

applicationOrder

Int

Application Order ID

formulated

Int

Formulated ID

unit

Int

Unit ID

doseToApply

Decimal

Recommended dose to apply

totalToApply

Decimal

Recommended total to apply

application_confirmation

tRANSACTIONAL DATA

Represents confirmed values of area and dose for a combination of campaign and formulated of an order.

Property

Type

Description

Property

Type

Description

applicationOrder

Int

Application Order ID

campaign

Int

Campaign ID

formulated

Int

Formulated ID

unit

Int

Unit ID

areaApplied

Decimal

Actual area applied

doseApplied

Decimal

Actual dose applied

tagAssocs

tRANSACTIONAL DATA

Represents a tag associated to an order

Property

Type

Description

Property

Type

Description

date

date

Date of creation

createdBy

String

Email of the user who created the entity

createdById

Int

Id of the user who created the entity

status

 

 

syncCheck

 

 

refNumber

String

Autogenerated identification number visible to user.

tableCode

 

 

tag

 

 

id

 

 

entityId

 

 

tag

tRANSACTIONAL DATA

Represents a tag

Property

Type

Description

Property

Type

Description

fullName

String

 

tableCode

 

 

createdBy

Int

Email of the user who created the entity

createdById

Int

Id of the user who created the entity

sync_check

 

 

status

 

 

id

Int

 

name

String

 

waypoint

tRANSACTIONAL DATA

Represents a waypoint

Property

Type

Description

Property

Type

Description

acurracy

 

 

adversity

 

 

createdBy

String

Email of the user who created the entity

createdById

Int

Id of the user who created the entity

date

date

Date of creation

fileName

Int

 

firebaseStorageUrl

 

 

id

Int

 

lat

 

 

lon

 

 

observations

String

 

parentId

Int

 

parentType

 

 

refNumber

String

Autogenerated identification number visible to user.

sampleNumber

 

 

status

 

 

syncCheck

 

 

thumbnailUrl

 

 

waypointKind

 

 

applicator

tRANSACTIONAL DATA

Represents an applicator

Property

Type

Description

Property

Type

Description

id

int

 

createdBy

String

Email of the user who created the entity

createdById

Int

Id of the user who created the entity

date

date

Date of creation

name

string

 

own

Int

 

refNumber

String

Autogenerated identification number visible to user.

status

 

 

syncCheck

 

 

active

bool

 

externalCode

String

 

address

string

 

machines

 

Array of machines