StructuralAnalysisFormat 1.7.2

dotnet add package StructuralAnalysisFormat --version 1.7.2
NuGet\Install-Package StructuralAnalysisFormat -Version 1.7.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="StructuralAnalysisFormat" Version="1.7.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add StructuralAnalysisFormat --version 1.7.2
#r "nuget: StructuralAnalysisFormat, 1.7.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 StructuralAnalysisFormat as a Cake Addin
#addin nuget:?package=StructuralAnalysisFormat&version=1.7.2

// Install StructuralAnalysisFormat as a Cake Tool
#tool nuget:?package=StructuralAnalysisFormat&version=1.7.2


This package implements the Structural Analysis Format in C#

The aim of this SDK is to allow anyone to rapidly get started implementing the SAF specification in their own software.


  • Straight forward API (One import and one export service)
  • Validation
  • Compatibility support between versions
  • Effortlessly switch between metric & imperial values


  • Uses EPPlus ( for handling excel files
  • Uses FluentValidation for validation
  • Uses UnitsNet for unit operations

What do you need to do?

In order to use this SDK, it is sufficient for you to provide a mapping between the data objects in your software and the data objects defined in the SDK Once you have that, you only need to call the import or export service and the rest is taken care of by the SDK.


Due to how this SDK is defined, with most of the actual implementation details being internal, you should also use one of our bootstrapping packages:

  • StructuralAnalysisFormat.Bootstrappers.SimpleInjector4
    If you wish to use SimpleInjector v4
  • StructuralAnalysisFormat.Bootstrappers.SimpleInjector5
    If you wish to use SimpleInjector v5

If you are only required to work with the data model of the SDK, then this package is sufficient.


using System;
using System.Linq;
using SAF.Infrastructure.Bootstrapping;
using SAF.Bootstrappers.SimpleInjector4;
using SAF.Infrastructure.Events;
using SAF.Infrastructure.Extensions;
using SAF.DataAccess.Contracts;
using SAF.DataAccess.Models;
using SAF.DataAccess.Models.Enums;
using SAF.DataAccess.Models.Infrastructure;

class Program
    static void Main(string[] args)
        IBootstrapper bootstrapper = new SimpleInjectorBootstrapper();

        IServiceProvider scope = bootstrapper.CreateScope();
        IEventService eventService = scope.GetService<IEventService>();

        using (IEventSubscription subscription = eventService.Subscribe<LogEvent>(OnLog))
            ExcelModel result = Read("some_saf_file.xlsx", scope);

            if (result == null)
                Console.WriteLine("Failed to read excel");

            Console.WriteLine("Successfully read excel, it contains the following objects:");

            var grouped = result.Objects.GroupBy(x => x.GetType());

            foreach (var group in grouped)
                Console.WriteLine($"{group.Key.Name}: {group.Count()}");

            Console.WriteLine("Press any key to continue.");

            Write("export.xlsx", result, scope);

    private static void OnLog(LogEvent obj)
        Console.WriteLine($"[{obj.Severity.ToString().ToUpper()}] {obj.Message}");

    private static ExcelModel Read(string file, IServiceProvider scope)
        IExcelImportService reader = scope.GetService<IExcelImportService>();
        ExcelModel result = null;

        using (var stream = File.OpenRead(file))
            result = reader.Import(stream);

        return result;

    private static void Write(string file, ExcelModel source, IServiceProvider scope)
        var writer = scope.GetService<IExcelExportService>();

        using (var stream = File.Create(file))
            writer.Export(stream, source);
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 netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  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)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (4)

Showing the top 4 NuGet packages that depend on StructuralAnalysisFormat:

Package Downloads

The tool for converting SAF model to IOM


This package contains functionality to bootstrap SAF using SimpleInjector 4


This package contains functionality to bootstrap SAF using SimpleInjector 5


This package contains objects and feature useful when creating tests

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.7.2 83 2/20/2024
1.7.1 1,283 2/14/2023
1.7.0 578 2/10/2023
1.6.1 554 2/7/2023
1.6.0 632 1/30/2023
1.5.6 856 11/21/2022
1.5.5 1,133 10/10/2022
1.5.4 1,187 9/22/2022
1.5.3 1,189 9/20/2022
1.5.2 1,093 9/16/2022
1.5.1 1,184 9/7/2022
1.5.0 1,133 8/26/2022
1.4.0 1,186 7/29/2022
1.3.2 6,364 6/10/2022