AdSec API Release Notes

Version 2.0.2

New features

• Licensing mechanism for external users to use the AdSec API has been overhauled. Users can now activate and deactivate the API license from within the Command Line Interface or directly within the script. Network floating license for the API for external users has been enabled. [ADSEC-1618, ADSEC-1619, ADSEC-1687, ADSEC-2024, ADSEC-2055, ADSEC-2056]
• AdSec API now supports Python version 3.11 [ADSEC-1612]
• The capacity curves for all versions of the AASHTO codes will now have the cap of minimum eccentricities included. [ADSEC- 1977]
• The capacity curves for all ACI 318 codes will now have a cap on the axial forces to account for the effect of minimum eccentricities as per Fig. R10.4.2.1 of the code. [ADSEC-1713]
• The modified axial capacity for circular and related cross sections having spiral link reinforcements as per table 22.4.2.1 has been implemented for all versions of ACI-318. [ADSEC-1149, ADSEC-1796, ADSEC-1808, ADSEC-1870]
• The strength reduction factor calculations have been updated for ACI 318-14. [ADSEC-1798]
• The result volume size occupied by analysis tasks in AdSec has been reduced, leading to lesser memory usage. [ADSEC-1618]
• AdSec API calculates the crack widths even when section is in uncracked state (same as the behaviour from AdSec UI application) [ADSEC-1321]

Fixes

• Alpha factor will now be correctly calculated for AASHTO codes. [ADSEC-1495]
• AdSec will no longer crash if the file name contains non-ASCII characters. [ADSEC-1498]
• Moment stiffness charts will no longer update unexpected up on any interaction with the user interface. [ADSEC-1623]
• AdSec will now use the correct k factors from the German national annex for cracking calculations. [ADSEC-1785]
• The modulus of rupture calculations for concrete grades in ACI 318-14 have been corrected. [ADSEC-1794]
• The value of beta factor used in stress-strain curve of concrete grades in ACI-318M-14 have been corrected. [ADSEC-1795]
• The default failure strain of concrete for grades lesser than M60 are now in accordance with IRC-112-2011. [ADSEC-1438]
• The standard material grades as per Indian standard codes in AdSec are now consistent with those in AdSec 8.4. The relevant changes can be seen by comparing the material curves across the versions. [ADSEC-1466, ADSEC-1752]
• The design strain values for rebars used in AdSec are now exactly as per IRC-112-2011.[ADSEC-1706]
• The previously missing Hong Kong code material grades have now been added to the AdSec API. [ADSEC - 1301]
• AdSec API will now be able to open .ads files which have the design code set to any ACI code. [ADSEC-1714]
• Example code snippets in the AdSec API documentation have now been corrected. [ADSEC-1801]

Version 2.0.0

Breaking changes

• API now depends on OasysUnits package instead of UnitsNet package. This implies a namespace change is required from UnitsNet and Oasys.Units to OasysUnits [1574,1552]
  • For C# users:
    • using UnitsNet must be replaced by using OasysUnits
    • using UnitsNet.Units must be replaced by using OasysUnits.Units
    • using Oasys.Units must be replaced by using OasysUnits
  • For Python users:
    • from UnitsNet import * must be replaced by from OasysUnits import *
    • from UnitsNet.Units import * must be replaced by from OasysUnits.Units import *
    • from Oasys.Units import * must be replaced by from OasysUnits import *

Version 1.1.0

New features

• API section with standard materials can now be exported to .ads file [1245]
• Sections from .ads file can now be imported to API sections. [1246]
• Geometric properties like area, elastic modulus, radius of gyration etc can now be extracted from section profiles [1430]
• API now uses PythonNet from released version as a dependent package. i.e. users not required to download the development version of PythonNet to work with API [1281]
• AdSec API and GSA .NET API can now be used in the same session [1433]

Documentation improvements

• The documentation has been updated to include code samples and example snippets on .ads interoperability feature [1424, 1422]
• Python stubs now include missing information related to remarks [1435]
• The documentation has been updated to include code samples and example snippets on export section to image feature [1434]
• The documentation site search results have been improved [1431]

Bug fixes

• API no longer reports different load utilization values before and after flattening a section [1283]
• The issue of reinforcement single bars not being generated beyond certain bar count has now been fixed [1206]
• Updates have been made to the solver to fix moment capacity underestimation [1259, 1129]
• AdSec no longer experiences problems when trying to create sections that contain sub-components with Catalogue profiles [1272]
• Updates have been made to fix moment capacity calculations to the Australian Code for circular sections with perimeter reinforcement layout [1366]

Known issues

• API section with non-standard materials are not supported to export as .ads file. [1323]
• Section with Recto-Ellipse profiles are not supported for .ads import or export. [1450]

Version 1.0.2

New features

• OAA-244 AdSec can save an image of a section (svg, which can be converted to other format e.g. png)
• OAA-340 Concrete sections can now contain template reinforcement (top, bottom, side and perimeter bars) and links
• OAA-337 Concrete sections can now define the cover to reinforcement (uniform for all faces) defined
• OAA-390 Deformations can now return the resulting longitudinal strain at a given position
• OAA-246 The documentation website now splits class properties and methods into separate pages
• OAA-251 AdSec can flatten a section definition into its canonical form
• OAA-325 Installation instructions for users without administrator privilege are now documented
• OAA-341 Python Stubs now include documentation of exceptions
• OAA-369 The documentation now includes an example of creating a compound section

Bug fixes

• OAA-388 UnitsNet marshalling behaviour is now properly documented
• OAA-387 Oasys Units not returning abbreviations
• OAA-392 IPopovic material curves returns NaN when trying to get stress at strain = 0

Version 1.0.1

New features

• OAA-262 Tooltips for Python users now include help for properties.
• OAA-273 The API now supports .NET Framework 4.7.2 or later.

Breaking changes

• OAA-277 The RecordTime property on AdSec.IWarning has changed from a string to a System.DateType object

Performance improvements

• OAA-302 Section analysis is now only performed when required (making it much faster if only carrying out strength analysis).
• OAA-305 Sections defined with perimeter profiles now analyse faster.

Bug fixes

• OAA-294 Exception cases are not documented.
• OAA-311 Crack width calculations not possible when using a custom concrete material.
• OAA-316 Unhandled error occurs if null is used where an object reference is expected.
• OAA-331 If the same solver object is used to analyse more than one section, it always returns solution for the first section.
• OAA-343 Serviceabilty check fails for the section with PD6687 concrete material.

Known issues

• OAA-259 Python tooltips: ‘See’ and ‘SeeAlso’ references are not handled well.
• OAA-342 Python tooltips: Some docstring includes SVGs

Version 1.0.0

New Features

This first release of the AdSec API allows users to:

• Define structural cross-sections
  • Custom and pre-defined standard materials (steel, concrete, FRP and reinforcement bars/tendons)
  • Standard, geometric and catalogue profile shapes
  • Reinforcement (for concrete sections)
    • Single bars, line, arc and circular bar groups
    • Preload (force, stress or strain)
• Configure AdSec to use one of a selection of international design codes
• Carry out strength (ULS) and serviceability (SLS) analysis of sections, including
  • Check response to an applied load (axial force and biaxial bending)
  • Check response to an applied deformation (axial strain and biaxial curvature)
  • Calculate crack widths (reinforced concrete sections)
  • Extract chart data (force-moment and moment-moment interaction diagrams)

We have published a comprehensive documentation website and a selection of sample projects that use the API in both C# and Python.

The API is available on Nuget (for .NET development) and PyPi (for Python development) as self-contained packages.

Known issues

• OAA-294 Exception cases are not documented.
• OAA-311 Crack width calculations not possible when using a custom concrete material.
• OAA-316 Unhandled error occurs if null is used where an object reference is expected.
• OAA-331 If the same solver object is used to analyse more than one section, it always returns solution for the first section.