Dev4Agriculture.ISO11783.ISOXML 0.19.5.2

.NET Standard 2.1

dotnet add package Dev4Agriculture.ISO11783.ISOXML --version 0.19.5.2

NuGet\Install-Package Dev4Agriculture.ISO11783.ISOXML -Version 0.19.5.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Dev4Agriculture.ISO11783.ISOXML" Version="0.19.5.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Dev4Agriculture.ISO11783.ISOXML --version 0.19.5.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Dev4Agriculture.ISO11783.ISOXML, 0.19.5.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install Dev4Agriculture.ISO11783.ISOXML as a Cake Addin
#addin nuget:?package=Dev4Agriculture.ISO11783.ISOXML&version=0.19.5.2

// Install Dev4Agriculture.ISO11783.ISOXML as a Cake Tool
#tool nuget:?package=Dev4Agriculture.ISO11783.ISOXML&version=0.19.5.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Abstract

ISOXML is an agricultural data format to create Task Descriptions and record machine data in agricultural machines. ISOXML is standardized in ISO11783-10.

Developers and Maintainers

Dev4Agriculture is specialized in agricultural data analysis. We love to make farming software work.

What are all the sub projects

This repository consists of multiple sub-projects. They all belong to isoxml.net but onliy Dev4Agriculture.ISO11783.ISOXML is the one that represents the library itself

Dev4Agriculture.ISO11783.ISOXML.Generation

This subproject is used to autogenerate the classes from XSD Schema Files. Those are adjusted versions of https://isobus.net (adjusted to fit V3 and V4 in parallel)

Dev4Agriculture.ISO11783.ISOXML.Test

Guess what, those are the tests for the ISOXML.net library. You may find interesting examples and also a few test data here.

Dev4Agriculture.ISO11783.ISOXML.Examples

Another sub project that provides Examples

Dev4Agriculture.ISO11783.ISOXML

This is the library itself that will be described in the following chapters

The Library

Nuget Package

isoxml.net is published as a nuget package here: https://www.nuget.org/packages/Dev4Agriculture.ISO11783.ISOXML

Classes

DataStructures in the ISOXML.net Library

ISOXML

The Datastructures in the ISOXML reflect an ISOXML TaskDataSet that was loaded or created:

Messages: A list of Warnings and errors that accoured during loading
Data: The TaskData Structure including Tasks, Devices, etc.
Grids: The List of Grids (Prescription maps) used in the TaskSet
TimeLogs: The List of MachineData-Packages provided with the TaskSet
IdTable: The IdTable collects all IDs from within the TaskSet (e.g. CTR1, TSK-1, etc.)
LinkList: In case of a Version 4 TaskSet, this is the List of Links between TaskData-Internal Ids (e.g. CTR1) and IDs from the FMIS (e.g. UUIDs).

This is the main Class. It consists of functions to create, load and save ISOXML.

static Load or LoadAsync

The static Load-Functions are used to Load a TaskDataSet from a storage folder. Its result consists of a Type ISOXML.

static Create

Creates an Empty TaskDataSet

Save or SaveAsync

Stores the ISOXML to the given FolderPath

ISO11783_TaskDataFile

This is the RootElement of any TaskData. It includes all the Coding Data Elements of ISOXML such as Customers, Farmers, Partfields etc.

All these subElements have names beginning with ISO. E.g. ISOPartfield, ISOCustomer, ISOTask

The Tasks include links to TimeLogs as well as a grid if those data are available in the TaskSet.

ISOGridFile

This is an Application, Seeding or Prescription Map

Remark: Each Grid can be of Type1 or Type2

Type1: Type 1 is an array of bytes; each value in the grid redirects to the corresponding TreatmentZone and its proposed Value

Type2: Type 2 is an array of 32bit integers. It directly includes values rather than a link to the treatmentZone.

Important: Both Grids should be acessed through the Functions GetValue/SetValue only!

ClientName

An analysis class to Analyse WorkingSetMasterNames/ClientNames

The WorkingSetMasterName, also known as ClientName is the Unique Identifier for a machine in the ISOXML world.(Actually it's "nearly unique" only 😕)

It can be decoded to read things like

Type of machine
Name of Manufacturer (via the ID; see https://www.isobus.net/isobus/manufacturerCode)

ToString()

This outputs the Hex-encoded name.

ToArray()

This is used to export a WorkingSetMasterName to an ISOTaskDataFile.

License note on Logos

Please be aware that the logo assigned to this project is only covered under Apache2 when used with this project. You may not use this logo for any other purpose whatsoever without consent by https://www.dev4Agriculture.de

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.
.NET Core	netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.1 is compatible.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETStandard 2.1
- Newtonsoft.Json (>= 13.0.2)
- System.ComponentModel.Annotations (>= 5.0.0)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
0.19.5.2	614	8/22/2023
0.19.5.1	119	8/20/2023
0.19.5	168	7/29/2023
0.19.4.1	120	7/25/2023
0.19.4	140	7/25/2023
0.19.3.5	131	7/21/2023
0.19.3.4	125	7/3/2023
0.19.3.3	125	6/29/2023
0.19.3.2	116	6/28/2023
0.19.3.1	146	6/23/2023
0.19.3	130	6/22/2023
0.19.2	118	6/22/2023
0.19.1	128	6/21/2023
0.19.0	113	6/20/2023
0.18.0	114	6/20/2023
0.17.3	1,843	6/3/2023
0.17.2.1	105	5/31/2023
0.17.2	101	5/26/2023
0.17.1	148	5/20/2023
0.17.0	129	5/12/2023
0.16.3	118	5/2/2023
0.16.2.2	102	5/2/2023
0.16.1	170	4/17/2023
0.15.2.1	139	4/16/2023
0.15.2	140	4/12/2023
0.14.2.1	414	3/11/2023
0.13.3	235	2/23/2023
0.13.2	200	2/22/2023
0.13.1.1	290	2/8/2023
0.13.1	205	2/7/2023
0.12.0.1	267	1/16/2023
0.12.0	256	1/15/2023
0.11.0	275	1/10/2023
0.10.0	265	1/8/2023
0.9.1.2	279	1/3/2023
0.9.1.1	257	12/30/2022
0.9.0.2	267	12/17/2022
0.9.0.1	669	12/8/2022
0.9.0	273	12/5/2022
0.8.0	409	11/24/2022
0.7.4.4	326	11/22/2022
0.7.4.2	330	11/22/2022
0.7.4.1	304	11/20/2022
0.7.3.1	317	11/17/2022
0.7.2.1	952	11/1/2022
0.7.1.1	437	10/24/2022
0.6.0.2	358	10/3/2022
0.6.0	591	9/16/2022
0.5.0.1	427	8/24/2022
0.4.0.1	410	8/15/2022
0.4.0	373	8/15/2022
0.0.0.2	264	12/29/2022

v0.19.5.2
- FIX: In case the DataTransferOrign was MICS, the generated IDs were still positive as the TransferOrign was not handed on to the IDList

v0.19.5.1
- FIX: In case 2 polygons were compared of which one was closed and one was not, the overlap algorithm might in some cases not recognize the equality of both polygons
v0.19.5
+ ADD: Function to check if a field is within bounds.

v0.19.4.1
-FIX: If a TaskData inside a Zip folder was hidden in multiple subfolders, this lead to loading issues

v0.19.4
=OPT: This is an optimization Release to better read invalid ISOXML Files and get the maximum out of the data.

v0.19.3.5
-FIX: The edge case that a TLG is linked twice in a TaskData.XML now doesn't cause a crash but an error in the messages List

v0.19.3.4
-FIX: Not all elements were read to the IDList; Polygon or LinesTring IDs could have been duplicated
-FIX: When reading the ISOXML from a string,

v0.19.3.3
-FIX: Grid-Export to CSV had invalid filename

v0.19.3.3
-FIX: Grid-Export to CSV had invalid filename

v0.19.3.2
-FIX: Ensure the path for SaveTLG and SaveGrid is valid.

v0.19.3.1
+FIX: improved Function to get intersected area

v0.19.3
+ADD: Function to get intersected area

v0.19.2
+ADD: Several functions to improve the capabilities of the LinkList Functionalities
-FIX: The IDs of BaseStation, ProductGroup and ColourLegend were not initialized.

v0.19.1
+ADD: Get the StopTime for an ASP or TIM, no matter if it exists or needs to be calculated from the Duration.

v0.19.0
-FIX: Make sure to remove LineStringId in V3 TaskSets
-FIX: Make sure to limit amount of digits to 9 for GuidancePattern Linestrings.

v0.18.0
-FIX: The ProductAllocation was the only element in a Task having an ASP instead of AllocationStamp in parameter. Fixed in XSD and therefore also in Lib
-FIX: The LinkList-File doesn't export any NameSpace headers anymore
-FIX: Several Points and Positions may only have up to 9 digits.

v0.17.3
=OPT: Optimize algorithm to find CulturalPractice in a Task
+ADD: Functions to read durations

v0.17.2.1

+FIX: add check if no elements with DDI179

v0.17.2

+ADD: GetTaskCulturalPractice in ISOTaskAnalysis

v0.17.1

+ADD: Specific Exception for missing TaskData.xml.

v0.17.0

+ADD: Adjust CodeGeneration from Schema files to remove Parenthesis-Text
+FIX: ISOPartField area calculation

v0.16.3

+ADD: Convert any ISOXML Element to an XML String

v0.16.2.2

-FIX: When reading an invalid XML, the Load-Function threw an exception

v0.16.2.1

-FIX: Found a DataSet with AFE-Elements as XFRs. Those are not officially supported but we shouldn't crash when we find them
-FIX: The resolution of the DDIs was wrong

v0.16.2

-ADD: Functions to get IsoField area

v0.16.1

-FIX: GridFile values were unsigned and GetSetpointValue was problematic

v0.15.2.1

-FIX: MixUp in the Enum of Trigger Methods lead to mixUp between Thresholds and OnChange.

v0.15.2

+ADD: Take TIM-Elements into account when totals could not be found in TimeLog Files

v0.15.1

+ADD: Functions to calculate the totals list of a given TimeLogs List
-FIX: Change variable for DeviceElementId to int
-FIX: Change variables for DDI to ushort

v0.14.2.1

-FIX: MultiLayer Grids were broken

v0.14.2

+ADD: Some functions to read the GridValue at a specific Geoposition, find out if a point is within a field and get the bounds of this field
+ADD: Functions to Generate TimeLogs

v014.1

+ADD: Add an autogenerated DDIList from the isobus.net Export

v0.13.3

+ADD: Analysis to find DeviceElements Relevant for specific DDIs in a Task

v0.13.1.1

-FIX: LinkList was not marked as a file to be preserved and returned to FMIS

v0.13.1

+ADD: Store LinkList seperately, used e.g. in case of exporting a V3 TaskSet

v0.13.0.1

+ADD: Load LinkList from .XML file separately, Save LinkLink into a separate LinkList file if needed. (for v3 or lower)
+FIX: Resolve inconsistensies between TaskFile and LinkList VersionMajor values

v0.13.0.0

+ADD: Save TimeLogXMLs
-FIX: Wrong BitEncoding when storing in V3

v0.12.0.1

-FIX: Zip-Archives were always unpacked to same TEMP-Folder, which avoids parallel processes

v0.12.0

+ADD: Add support to export ISOXML V3

v0.11.0.0

+ADD: Analysis of LocalizationLabel
+ADD: Extend WSM capabilities
=CHG: Rename WSM to ClientName

v0.10.0.0

+ADD: Add DetailsField and CodeField to ResultMessages

v0.9.1.2

-FIX: Did not properly read files from subfolders when reading zipfile stream
-FIX: Wrong casing of LINKLIST.xml. Must be LINKLIST.XML

v0.9.1.1

OUTDATED, do not use

v0.9.1.0

ADD: Function to ReadTaskData from Zipfile Stream

v0.9.0.2

FIX: Loading of Layers for GridType 2 was invalid

v0.9.0.1

FIX: Added missing Elements to the IDListTable; e.g. CodedCommentListValue could not be assigned with an ID.

v0.9.0.0

FIX: WorkingSetMasterName WSM required reversing of the ByteArray when reading Data from the ISODevice.WorkingSetMasterName

v0.8.0.0

Fix unsigned Machine Data Value to be actually signed

v0.7.4.4

Editorial only: Update the LogoURL in the Readme so that it's displayed in nuget.org

v0.7.4.3

Fix Reading of TimeLogs when TimeLogs include NumberOfSatellites

v0.7.4.2

HasDDIValue supported unsigned DET numbers only, making it impossible to check it for DeviceElements that were created in the MICS

v0.7.4.1

Add functionality to read an XML String to an ISOXML Object, no matter if it's a fully qualified ISO11783_TaskDataFile or a Coding Data Element.

v0.7.3.1

Add Functionality to get TimeLog Extracts for Positions where a specific value was not recorded. Relevant and important e.g. for values recorded "onChange"

v0.7.2.1

Add DeviceElement to IDList Table

v0.7.1.1

Add DefaultDataLogTrigger-Function for Tasks

v0.7.0.1

Add TimeLog Reading Functionalities

v0.6.0.1

Add functions to set the Core Root Information of an ISOXML and its LinkList in parallel

V0.5.0.1

WSM can now handle upper and lower case
Adjusted Namings and Values of the DeviceClass enum to fit the definition in https://isobus.net/