IntoRdf 2.0.0

.NET 8.0

dotnet add package IntoRdf --version 2.0.0

NuGet\Install-Package IntoRdf -Version 2.0.0

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="IntoRdf" Version="2.0.0" />

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

paket add IntoRdf --version 2.0.0

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

#r "nuget: IntoRdf, 2.0.0"

#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 IntoRdf as a Cake Addin
#addin nuget:?package=IntoRdf&version=2.0.0

// Install IntoRdf as a Cake Tool
#tool nuget:?package=IntoRdf&version=2.0.0

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

IntoRdf

IntoRdf is a NuGet package for transforming Excel (XLSX) files into RDF (Resource Description Framework) format. This package helps developers easily convert spreadsheet data into RDF triples using a simple and convenient API.

Features

Transform Excel (XLSX) files into Turtle or JSON-LD RDF formats. Easily define custom namespaces and predicates for RDF individuals. Supports various spreadsheet configurations, such as different sheet names, header rows, and data rows/columns.

Installation

Install the IntoRdf NuGet package using the following command:

dotnet install IntoRdf

Usage

To use IntoRdf, import the following namespaces:

using IntoRdf;
using IntoRdf.Models;

Create an instance of ITransformerService to transform spreadsheets into RDF:

ITransformerService transformerService = new TransformerService();

Then, create SpreadsheetDetails and TransformationDetails objects to define the input spreadsheet structure and the desired RDF output:

var spreadsheetDetails = new SpreadsheetDetails(sheetName: "Sheet1", headerRow: 1, dataStartRow: 2, startColumn: 1);

var transformationDetails = new TransformationDetails(
    baseUri: new Uri("http://example.com/"),
    predicateBaseUri: new Uri("http://example.com/predicates/"),
    IdentifierSegment: new TargetPathSegment("id", "identifier"),
    targetPathSegments: new List<TargetPathSegment> { new TargetPathSegment("name", "name") },
    outputFormat: RdfFormat.Turtle
);

Finally, call the TransformSpreadsheet method to perform the transformation:

using var stream = new MemoryStream(Encoding.UTF8.GetBytes(spreadsheetContent));
string rdfOutput = transformerService.TransformSpreadsheet(spreadsheetDetails, transformationDetails, stream);

API Reference

ITransformerService

TransformSpreadsheet(SpreadsheetDetails spreadsheetDetails, TransformationDetails transformationDetails, Stream content)

Transforms the input spreadsheet into RDF format based on the provided transformation details.

SpreadsheetDetails

SpreadsheetDetails(string sheetName, int headerRow, int dataStartRow, int startColumn)

Constructor to create a new SpreadsheetDetails object.

sheetName: The name of the sheet containing the data in the input spreadsheet.
headerRow: The row number containing the column headers in the input spreadsheet (1-based index).
dataStartRow: The row number where the data starts in the input spreadsheet (1-based index).
startColumn: The column number where the data starts in the input spreadsheet (1-based index).

TransformationDetails

TransformationDetails(Uri baseUri, Uri predicateBaseUri, TargetPathSegment? IdentifierSegment, List<TargetPathSegment> targetPathSegments, RdfFormat outputFormat)

Constructor to create a new TransformationDetails object.

baseUri: The base URI for creating RDF individuals.
predicateBaseUri: The base URI for creating RDF predicates.
IdentifierSegment: An optional TargetPathSegment for the identifier of RDF individuals. If specified, the subjects for the resulting RDF triples will be created using baseUri + segment + value in the cell gotten from the column matching target. If not specified, the subjects will be created using baseUri + a GUID.
targetPathSegments: A list of TargetPathSegment objects to define the RDF individuals' properties.
outputFormat: The desired RDF format for the output (Turtle, Trig, or JSON-LD).

TargetPathSegment

TargetPathSegment(string target, string segment)

Constructor to create a new TargetPathSegment object.

target: The property name of the literal to turn into an RDF individual. When transforming a spreadsheet, this will refer to a column name.
segment: The URI segment to append to the base URI, enabling the creation of specific namespaces for different individuals.

RdfFormat

Enum with the following values: Turtle, Trig, Jsonld

Changelog

For a detailed list of changes in each version, please refer to the CHANGELOG file.

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. 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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- DocumentFormat.OpenXml (>= 3.0.2)
- dotnetRDF (>= 3.1.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.1)

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
2.0.0	1,083	4/30/2024
1.1.4	379	4/15/2024
1.1.4-prerelease	83	4/15/2024
1.1.3	427	4/3/2024
1.1.2	518	3/18/2024
1.1.1	98	3/15/2024
1.1.0	1,576	1/18/2024
1.0.0	1,064	11/23/2023
0.3.6	101	10/11/2023
0.3.4	4,379	6/26/2023
0.3.3	129	5/11/2023
0.3.2	116	5/8/2023
0.3.1	1,436	5/2/2023
0.3.0	145	4/14/2023
0.2.1	149	4/12/2023
0.2.0	740	3/30/2023
0.1.0	188	3/29/2023
0.0.1	181	3/23/2023

Total 12.8K

Current version 1.1K

Per day average 29