Entity relations and description
- 1 Structure entities
- 1.1 Common transactional properties
- 1.2 Farmer
- 1.3 Establishment
- 1.4 Plot
- 1.5 Campaign
- 1.6 Master Campaign
- 1.7 Master Campaign Cycle
- 1.8 Cultivation
- 1.9 Planting time
- 1.10 Formulated
- 2 Scouting entities
- 2.1 Scouting
- 2.2 Scouting Protocol Result
- 2.3 Scouting Sample Alert
- 2.4 Scouting Sample Value
- 2.5 Scouting Adversity
- 2.6 Scouting Measure
- 2.7 Scouting Protocol
- 2.8 Scouting Category
- 2.9 Scouting Adversity Kind
- 2.10 Scouting Protocol Measure
- 2.11 Scouting Protocol Adversities
- 2.12 Phenological state
- 2.13 Measure threshold
- 3 Order entities
- 3.1 Application Order (Work order)
- 3.2 application_campaign
- 3.3 application_formulated
- 3.4 application_confirmation
- 3.5 tagAssocs
- 3.6 tag
- 3.7 waypoint
- 3.8 applicator
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
name | String | Establishment name |
farmer | Int | Farmer ID |
Plot
tRANSACTIONAL DATA
Represents a single field
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
name | String | Name of planting time |
Formulated
master DATA
Inputs. They represent crop’s varieties or hybrids, insesticides, herbicides, etc
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
a0 (unit) | String | Unit of measure |
a1 (controlType) | String | The type of UI control presented to the user.
|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
a0 (name) | String | Name of kind |
Scouting Protocol Measure
master DATA
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 If If |
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 |
---|---|---|
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:
|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |
---|---|---|
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 |