Area.g.cs

// Copyright (c) ktsu.dev
// All rights reserved.
// Licensed under the MIT license.
// <auto-generated />

namespace ktsu.Semantics.Quantities;

using System.Numerics;

/// <summary>
/// Magnitude (Vector0) quantity for the Area dimension.
/// </summary>
/// <typeparam name="T">The numeric storage type.</typeparam>
public record Area<T> : PhysicalQuantity<Area<T>, T>, IVector0<Area<T>, T>
	where T : struct, INumber<T>
{
	/// <summary>Gets a quantity with value zero.</summary>
	public static Area<T> Zero => Create(T.Zero);

	/// <summary>
	/// Creates a new <see cref="Area{T}"/> from a value in SquareMeter.
	/// </summary>
	/// <param name="value">The value in SquareMeter.</param>
	/// <returns>A new <see cref="Area{T}"/> instance.</returns>
	/// <exception cref="System.ArgumentException">Thrown when the resulting magnitude would be negative.</exception>
	public static Area<T> FromSquareMeters(T value) => Create(Vector0Guards.EnsureNonNegative(value, nameof(value)));
/// <summary>
	/// Creates a new <see cref="Area{T}"/> from a value in SquareFoot.
	/// </summary>
	/// <param name="value">The value in SquareFoot.</param>
	/// <returns>A new <see cref="Area{T}"/> instance.</returns>
	/// <exception cref="System.ArgumentException">Thrown when the resulting magnitude would be negative.</exception>
	public static Area<T> FromSquareFeet(T value) => Create(Vector0Guards.EnsureNonNegative((value * T.CreateChecked(Units.ConversionConstants.SquareFootToSquareMeters)), nameof(value)));
/// <summary>
	/// Creates a new <see cref="Area{T}"/> from a value in SquareInch.
	/// </summary>
	/// <param name="value">The value in SquareInch.</param>
	/// <returns>A new <see cref="Area{T}"/> instance.</returns>
	/// <exception cref="System.ArgumentException">Thrown when the resulting magnitude would be negative.</exception>
	public static Area<T> FromSquareInches(T value) => Create(Vector0Guards.EnsureNonNegative((value * T.CreateChecked(Units.ConversionConstants.SquareInchToSquareMeters)), nameof(value)));
/// <summary>
	/// Subtracts two Area values, returning the absolute difference as a non-negative Area.
	/// Magnitude subtraction stays a magnitude (per the unified-vector model).
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static Area<T> operator -(Area<T> left, Area<T> right) => Create(T.Abs(left.Quantity - right.Quantity));
/// <summary>
	/// Divides Area by Length to produce Length.
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static Length<T> operator /(Area<T> left, Length<T> right) => Divide<Length<T>>(left, right);
/// <summary>
	/// Multiplies Area by Length to produce Volume.
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static Volume<T> operator *(Area<T> left, Length<T> right) => Multiply<Volume<T>>(left, right);
/// <summary>
	/// Multiplies Area by Pressure to produce ForceMagnitude.
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static ForceMagnitude<T> operator *(Area<T> left, Pressure<T> right) => Multiply<ForceMagnitude<T>>(left, right);
/// <summary>
	/// Multiplies Area by Illuminance to produce LuminousFlux.
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static LuminousFlux<T> operator *(Area<T> left, Illuminance<T> right) => Multiply<LuminousFlux<T>>(left, right);
/// <summary>
	/// Multiplies Area by MagneticFluxDensityMagnitude to produce MagneticFlux.
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static MagneticFlux<T> operator *(Area<T> left, MagneticFluxDensityMagnitude<T> right) => Multiply<MagneticFlux<T>>(left, right);
/// <summary>
	/// Multiplies Area by Irradiance to produce Power.
	/// </summary>
	[System.Diagnostics.CodeAnalysis.SuppressMessage("Usage", "CA2225:Operator overloads have named alternates", Justification = "Physics quantity operator")] public static Power<T> operator *(Area<T> left, Irradiance<T> right) => Multiply<Power<T>>(left, right);
};