Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 40 additions & 8 deletions .github/workflows/Release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,43 @@ on:

jobs:
build:
uses: HydrologicEngineeringCenter/dotnet-workflows/.github/workflows/release.yml@main
with:
dotnet-version: '10.0.x'
project-names: 'Numerics'
run-tests: true
nuget-source: 'https://www.hec.usace.army.mil/nexus/repository/consequences-nuget-public/'
secrets:
NUGET_API_KEY: ${{ secrets.NEXUS_NUGET_APIKEY }}
runs-on: windows-latest
timeout-minutes: 90

steps:
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0

- name: Setup .NET SDKs
uses: actions/setup-dotnet@v4
with:
dotnet-version: |
8.0.x
9.0.x
10.0.x

- name: Create version number
shell: pwsh
run: |
$TAG = $env:GITHUB_REF -replace 'refs/tags/', ''
$VERSION = $TAG -replace '^v', ''
echo "VERSION=$VERSION" >> $env:GITHUB_ENV

- name: Build
shell: pwsh
run: dotnet build Numerics/Numerics.csproj -c Release /p:Version=$env:VERSION

- name: Test
env:
VSTEST_CONNECTION_TIMEOUT: '600'
run: dotnet test -c Release

- name: Pack
shell: pwsh
run: dotnet pack Numerics/Numerics.csproj --configuration Release /p:Version=$env:VERSION --no-build -o ./packages

- name: Publish
shell: pwsh
run: dotnet nuget push "**/*.nupkg" --api-key ${{ secrets.NEXUS_NUGET_APIKEY }} --source "https://www.hec.usace.army.mil/nexus/repository/consequences-nuget-public/" --skip-duplicate
3 changes: 2 additions & 1 deletion .github/workflows/Snapshot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,8 @@ jobs:
with:
dotnet-version: '10.0.x'
project-names: 'Numerics'
version: '2.0.0'
# Snapshot workflow appends .<run_number>-dev, so this tracks the next development patch after v2.1.1.
version: '2.1.2'
# PR integration already runs the full multi-target test suite.
run-tests: false
nuget-source: 'https://www.hec.usace.army.mil/nexus/repository/consequences-nuget-public/'
Expand Down
19 changes: 9 additions & 10 deletions CITATION.cff
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
cff-version: 1.2.0
message: "If you use this software, please cite it as below."
type: software
title: "Numerics"
version: "2.0.0"
date-released: "2026-03-08"
title: "Numerics: A .NET Library for Numerical Computing, Statistical Analysis, and Risk Assessment"
version: "2.1.1"
date-released: "2026-06-17"
license: 0BSD
doi: "10.5281/zenodo.19444369"
repository-code: "https://github.com/USACE-RMC/Numerics"
url: "https://github.com/USACE-RMC/Numerics"
abstract: >-
Expand All @@ -27,25 +26,25 @@ authors:
- family-names: "Smith"
given-names: "C. Haden"
email: "cole.h.smith@usace.army.mil"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
orcid: "https://orcid.org/0000-0002-4651-9890"
- family-names: "Fields"
given-names: "Woodrow L."
affiliation: "U.S. Army Corps of Engineers, Risk Management Center"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
orcid: "https://orcid.org/0009-0008-7454-5552"
- family-names: "Gonzalez"
given-names: "Julian"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
orcid: "https://orcid.org/0009-0009-9058-7653"
- family-names: "Niblett"
given-names: "Sadie"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center"
affiliation: "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
orcid: "https://orcid.org/0009-0008-8588-4816"
- family-names: "Beam"
given-names: "Brennan"
affiliation: "U.S. Army Corps of Engineers, Hydrologic Engineering Center"
affiliation: "U.S. Army Corps of Engineers, Hydrologic Engineering Center, Davis, California, USA"
orcid: "https://orcid.org/0009-0003-0515-3727"
- family-names: "Skahill"
given-names: "Brian"
affiliation: "Fariborz Maseeh Department of Mathematics and Statistics, Portland State University"
affiliation: "Fariborz Maseeh Department of Mathematics and Statistics, Portland State University, Portland, Oregon, USA"
orcid: "https://orcid.org/0000-0002-2164-0301"
11 changes: 6 additions & 5 deletions Numerics/Numerics.csproj
Original file line number Diff line number Diff line change
Expand Up @@ -7,15 +7,16 @@
<EmbedUntrackedSources>true</EmbedUntrackedSources>
<DebugType>embedded</DebugType>

<Description>Numerics is a free and open-source library for .NET developed by USACE-RMC, providing a comprehensive set of methods and algorithms for numerical computations and statistical analysis.</Description>
<Description>Numerics is a free and open-source .NET library developed by USACE-RMC, providing numerical methods, probability distributions, statistical analysis, optimization, machine learning, and Bayesian inference tools for quantitative risk assessment in water resources engineering.</Description>
<Authors>C. Haden Smith; Woodrow L. Fields; Julian Gonzalez; Sadie Niblett; Brennan Beam; Brian Skahill</Authors>
<PackageProjectUrl>https://github.com/USACE-RMC/Numerics</PackageProjectUrl>
<RepositoryUrl>https://github.com/USACE-RMC/Numerics</RepositoryUrl>
<RepositoryType>git</RepositoryType>
<Title>Numerics</Title>
<GeneratePackageOnBuild>False</GeneratePackageOnBuild>
<Company>USACE-RMC</Company>
<PackageReadmeFile>README.md</PackageReadmeFile>
<PackageTags>interpolation; regression; statistics; machine learning; probability distributions; bootstrap analysis; distribution fitting; Bayesian MCMC sampling; optimization;</PackageTags>
<PackageTags>numerical methods;statistics;probability distributions;hydrology;flood frequency analysis;copulas;L-moments;optimization;machine learning;Bayesian inference;MCMC;risk assessment</PackageTags>
<PackageLicenseExpression>0BSD</PackageLicenseExpression>
<PackageRequireLicenseAcceptance>False</PackageRequireLicenseAcceptance>
<PackageId>RMC.Numerics</PackageId>
Expand All @@ -29,9 +30,9 @@
<PropertyGroup>
<!-- 1587 is an xml comment not placed on a valid member (in our case, mostly license text at top of files) -->
<NoWarn>CS1587</NoWarn>
<Version>2.0.0</Version>
<PackageReleaseNotes>This major update delivers broad improvements across the entire Numerics library, with substantial enhancements to data analysis, statistical modeling, numerical methods, distributions, optimization, machine learning utilities, and overall performance and reliability. The update reflects over a year of incremental development, code modernization, and refinement.</PackageReleaseNotes>
<AssemblyVersion>2.0.0.0</AssemblyVersion>
<Version>2.1.1</Version>
<PackageReleaseNotes>Version 2.1.1 is a metadata and release-process update for the JOSS publication. It refreshes citation, CodeMeta, README, and NuGet package metadata; increases the VSTest connection timeout in the release workflow; and does not change the public API.</PackageReleaseNotes>
<AssemblyVersion>2.1.1.0</AssemblyVersion>
</PropertyGroup>

<PropertyGroup>
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@

[![CI](https://github.com/USACE-RMC/Numerics/actions/workflows/Integration.yml/badge.svg)](https://github.com/USACE-RMC/Numerics/actions/workflows/Integration.yml)
[![NuGet](https://img.shields.io/nuget/v/RMC.Numerics)](https://www.nuget.org/packages/RMC.Numerics/)
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.19444369.svg)](https://doi.org/10.5281/zenodo.19444369)
[![DOI](https://zenodo.org/badge/697446868.svg)](https://zenodo.org/badge/latestdoi/697446868)
[![License: 0BSD](https://img.shields.io/badge/License-0BSD-blue.svg)](LICENSE)

***Numerics*** is a free and open-source numerical computing library for .NET developed by the U.S. Army Corps of Engineers Risk Management Center (USACE-RMC). It provides methods and algorithms for probability distributions, statistical analysis, numerical methods, optimization, machine learning, and Bayesian MCMC sampling with a focus on hydrological and risk assessment applications.
***Numerics*** is a free and open-source numerical computing library for .NET developed by the U.S. Army Corps of Engineers Risk Management Center (USACE-RMC). It provides methods and algorithms for probability distributions, statistical analysis, numerical methods, optimization, machine learning, and Bayesian MCMC sampling - with a focus on hydrological and risk assessment applications.

## Supported Frameworks

Expand All @@ -22,7 +22,7 @@ Or search for [RMC.Numerics](https://www.nuget.org/packages/RMC.Numerics/) in th

## Documentation

**[User Guide and API Documentation](docs/index.md)** Comprehensive documentation with code examples and mathematical explanations.
**[User Guide and API Documentation](docs/index.md)** - Comprehensive documentation with code examples and mathematical explanations.

| Section | Topics |
|---------|--------|
Expand Down
23 changes: 14 additions & 9 deletions codemeta.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,12 @@
{
"@context": "https://doi.org/10.5063/schema/codemeta-2.0",
"@type": "SoftwareSourceCode",
"name": "Numerics",
"name": "Numerics: A .NET Library for Numerical Computing, Statistical Analysis, and Risk Assessment",
"alternateName": "Numerics",
"description": "A free and open-source .NET library providing numerical methods, probability distributions, statistical analysis, and Bayesian inference tools for quantitative risk assessment in water resources engineering.",
"version": "2.0.0",
"version": "2.1.1",
"dateCreated": "2023-09-28",
"dateModified": "2026-03-08",
"dateModified": "2026-06-17",
"license": "https://spdx.org/licenses/0BSD",
"codeRepository": "https://github.com/USACE-RMC/Numerics",
"issueTracker": "https://github.com/USACE-RMC/Numerics/issues",
Expand Down Expand Up @@ -40,43 +41,47 @@
"@id": "https://orcid.org/0000-0002-4651-9890",
"affiliation": {
"@type": "Organization",
"name": "U.S. Army Corps of Engineers, Risk Management Center"
"name": "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
}
},
{
"@type": "Person",
"givenName": "Woodrow L.",
"familyName": "Fields",
"@id": "https://orcid.org/0009-0008-7454-5552",
"affiliation": {
"@type": "Organization",
"name": "U.S. Army Corps of Engineers, Risk Management Center"
"name": "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
}
},
{
"@type": "Person",
"givenName": "Julian",
"familyName": "Gonzalez",
"@id": "https://orcid.org/0009-0009-9058-7653",
"affiliation": {
"@type": "Organization",
"name": "U.S. Army Corps of Engineers, Risk Management Center"
"name": "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
}
},
{
"@type": "Person",
"givenName": "Sadie",
"familyName": "Niblett",
"@id": "https://orcid.org/0009-0008-8588-4816",
"affiliation": {
"@type": "Organization",
"name": "U.S. Army Corps of Engineers, Risk Management Center"
"name": "U.S. Army Corps of Engineers, Risk Management Center, Lakewood, Colorado, USA"
}
},
{
"@type": "Person",
"givenName": "Brennan",
"familyName": "Beam",
"@id": "https://orcid.org/0009-0003-0515-3727",
"affiliation": {
"@type": "Organization",
"name": "U.S. Army Corps of Engineers, Hydrologic Engineering Center"
"name": "U.S. Army Corps of Engineers, Hydrologic Engineering Center, Davis, California, USA"
}
},
{
Expand All @@ -86,7 +91,7 @@
"@id": "https://orcid.org/0000-0002-2164-0301",
"affiliation": {
"@type": "Organization",
"name": "Fariborz Maseeh Department of Mathematics and Statistics, Portland State University"
"name": "Fariborz Maseeh Department of Mathematics and Statistics, Portland State University, Portland, Oregon, USA"
}
}
],
Expand Down
Loading