Files
Marc Schier 724757122b Add recycling simulator and plastics/rubber companion packages (#4772)
# Description

Add a generic, company-neutral recycling simulation sample and reusable
plastics/rubber companion-model packages. One durable causal coordinator
and ten separately launched OPC UA process views provide deterministic
material balances, finite buffers, genealogy, utilities, quality
holds/disposition, authenticated controls and crash recovery. Process
views consume committed state instead of running independent
simulations.

Real companion-model equipment instances use DI/Machinery/AMB discovery,
Machine Vision, Pumps/Scales, granulate drying, extrusion, filtration
and pelletizing. Vendor/process extensions remain sample-local.
Connectors and WoT conversion are out of scope. **External
source-contract parity and complete deployment qualification are not
claimed complete.**

The sample and managed tests target **.NET 8, 9 and 10**. The
consolidated [recycling guide](samples/Recycling/README.md) explains the
actual composition, simulation, observation paths and exposed data; the
application-directory README points to that guide.

Typed client member extensions are emitted at build time through the
default-false `ModelSourceGeneratorClientAccessorsOnly` opt-in.
Extrusion uses it for all twelve parts instead of checked-in generated
C# and a Python generator. The shared client runtime retains typed
values, quality, timestamps and streaming behavior.

### Package layout

Six packages contain fourteen models in two model-producing assemblies:

| Specifications | Model | Typed client | Server runtime |
| --- | --- | --- | --- |
| OPC 40083 and OPC 40082-6 | `Opc.Ua.PlasticsRubber` |
`Opc.Ua.PlasticsRubber.Client` | `Opc.Ua.PlasticsRubber.Server` |
| OPC 40084 parts 1–12 | `Opc.Ua.Extrusion` | `Opc.Ua.Extrusion.Client`
| `Opc.Ua.Extrusion.Server` |

NuGet IDs use the `OPCFoundation.NetStandard.` prefix. All six packages
are registered in `.azurepipelines/expected-packages.txt` and the
generated preview-pack solution. Granulate-drying code lives in
`GranulateDrying` folders in the PlasticsRubber projects; extrusion uses
per-part folders. There are no standalone granulate-drying or per-part
extrusion packages. Published model identities and CLR namespaces remain
distinct and unchanged.

The common 1.03 interface is independently authored on the explicitly
MIT-licensed 1.02 implementation basis; the official 1.03 XML is not
redistributed. The other imported models retain their individual MIT
notices. All 42 pinned model, identifier and basis files retain their
manifest-backed bytes, including their staged Git blobs. No formal
companion certification is claimed; the disputed Filter profile is not
advertised.

## Related Issues

No tracking issue is currently linked.

## Checklist

_Put an `x` in the boxes that apply. You can complete these step by step
after opening the PR._

- [ ] I have signed the
[CLA](https://opcfoundation.org/license/cla/ContributorLicenseAgreementv1.0.pdf)
and read the
[CONTRIBUTING](https://github.com/OPCFoundation/UA-.NETStandard/blob/master/CONTRIBUTING.md)
doc.
- [ ] I have added tests that prove my fix is effective or that my
feature works and increased code coverage.
- [x] I have added all necessary documentation.
- [x] I have verified that my changes do not introduce (new) build or
analyzer warnings.
- [ ] I ran **all** tests locally using the **UA.slnx** solution against
at least .net **framework** and .net **10**, and all passed.
- [ ] I fixed **all** failing and flaky tests in the CI pipelines and
**all** CodeQL warnings.
- [x] I have addressed **all** PR feedback received.

Current-head CI and coverage remain pending; the full local `UA.slnx`
test matrix is not claimed complete.
2026-10-15 07:00:58 +02:00

89 lines
3.9 KiB
C#

/* ========================================================================
* Copyright (c) 2005-2026 The OPC Foundation, Inc. All rights reserved.
*
* OPC Foundation MIT License 1.00
*
* Permission is hereby granted, free of charge, to any person
* obtaining a copy of this software and associated documentation
* files (the "Software"), to deal in the Software without
* restriction, including without limitation the rights to use,
* copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following
* conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*
* The complete license agreement can be found here:
* http://opcfoundation.org/License/MIT/1.00/
* ======================================================================*/
using System;
namespace Opc.Ua.Recycling
{
/// <summary>
/// Explicit sample-only equipment coefficients. These do not advance production and are not physical calibration.
/// All live selection and residence progress comes from the committed coordinator image.
/// </summary>
public sealed record RecyclingNativeProcessOptions
{
/// <summary>
/// Synthetic conditioned-bin and desiccant-bed temperature, degrees Celsius.
/// </summary>
public double DryingTemperatureC { get; init; } = 80;
/// <summary>
/// Synthetic powered dry-air supply, cubic metres per hour. Bed publication converts this to litres/second.
/// </summary>
public double DryingAirFlowM3Hr { get; init; } = 60;
/// <summary>
/// Synthetic conditioned-air dewpoint, degrees Celsius.
/// </summary>
public double DryDewPointC { get; init; } = -40;
/// <summary>
/// Synthetic unconditioned-air dewpoint, degrees Celsius.
/// </summary>
public double AmbientDewPointC { get; init; } = 10;
/// <summary>
/// Synthetic selected filter mesh specification, micrometres; not an inferred contamination measurement.
/// </summary>
public double FiltrationFinenessMicrometres { get; init; } = 100;
/// <summary>
/// Synthetic pelletizer shaft speed while material is actually executing, revolutions per minute.
/// This is independent of mass throughput and pellet size.
/// </summary>
public double PelletizerSpeedRpm { get; init; } = 300;
/// <summary>
/// Validates finite display coefficients and their declared ranges.
/// </summary>
public void Validate()
{
if (!double.IsFinite(DryingTemperatureC) || DryingTemperatureC is < 20 or > 200 ||
!double.IsFinite(DryingAirFlowM3Hr) || DryingAirFlowM3Hr is <= 0 or > 10000 ||
!double.IsFinite(DryDewPointC) || DryDewPointC is < -100 or > 20 ||
!double.IsFinite(AmbientDewPointC) || AmbientDewPointC < DryDewPointC || AmbientDewPointC > 50 ||
!double.IsFinite(FiltrationFinenessMicrometres) ||
FiltrationFinenessMicrometres is <= 0 or > 10000 ||
!double.IsFinite(PelletizerSpeedRpm) || PelletizerSpeedRpm is <= 0 or > 10000)
{
throw new ArgumentException("Invalid synthetic native-equipment coefficients.");
}
}
}
}