using System.Diagnostics.CodeAnalysis; using System.Linq; using System.Runtime.CompilerServices; using Content.Server.Atmos.Reactions; using Content.Shared.Atmos; using Robust.Shared.Serialization; namespace Content.Server.Atmos { /// /// A general-purpose, variable volume gas mixture. /// [Serializable] [DataDefinition] public sealed partial class GasMixture : IEquatable, ISerializationHooks { public static GasMixture SpaceGas => new() {Volume = Atmospherics.CellVolume, Temperature = Atmospherics.TCMB, Immutable = true}; // This must always have a length that is a multiple of 4 for SIMD acceleration. [DataField("moles")] [ViewVariables(VVAccess.ReadWrite)] public float[] Moles = new float[Atmospherics.AdjustedNumberOfGases]; [DataField("temperature")] [ViewVariables(VVAccess.ReadWrite)] private float _temperature = Atmospherics.TCMB; [DataField("immutable")] public bool Immutable { get; private set; } [ViewVariables] public readonly Dictionary ReactionResults = new() { // We initialize the dictionary here. { GasReaction.Fire, 0f } }; [ViewVariables] public float TotalMoles { [MethodImpl(MethodImplOptions.AggressiveInlining)] get => NumericsHelpers.HorizontalAdd(Moles); } [ViewVariables] public float Pressure { get { if (Volume <= 0) return 0f; return TotalMoles * Atmospherics.R * Temperature / Volume; } } [ViewVariables] public float Temperature { get => _temperature; set { if (Immutable) return; _temperature = MathF.Max(value, Atmospherics.TCMB); } } [DataField("volume")] [ViewVariables(VVAccess.ReadWrite)] public float Volume { get; set; } public GasMixture() { } public GasMixture(float volume = 0f) { if (volume < 0) volume = 0; Volume = volume; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void MarkImmutable() { Immutable = true; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public float GetMoles(int gasId) { return Moles[gasId]; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public float GetMoles(Gas gas) { return GetMoles((int)gas); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void SetMoles(int gasId, float quantity) { if (!float.IsFinite(quantity) || float.IsNegative(quantity)) throw new ArgumentException($"Invalid quantity \"{quantity}\" specified!", nameof(quantity)); if (!Immutable) Moles[gasId] = quantity; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void SetMoles(Gas gas, float quantity) { SetMoles((int)gas, quantity); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void AdjustMoles(int gasId, float quantity) { if (!Immutable) { if (!float.IsFinite(quantity)) throw new ArgumentException($"Invalid quantity \"{quantity}\" specified!", nameof(quantity)); Moles[gasId] += quantity; var moles = Moles[gasId]; if (!float.IsFinite(moles) || float.IsNegative(moles)) throw new Exception($"Invalid mole quantity \"{moles}\" in gas Id {gasId} after adjusting moles with \"{quantity}\"!"); } } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void AdjustMoles(Gas gas, float moles) { AdjustMoles((int)gas, moles); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public GasMixture Remove(float amount) { return RemoveRatio(amount / TotalMoles); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public GasMixture RemoveRatio(float ratio) { switch (ratio) { case <= 0: return new GasMixture(Volume){Temperature = Temperature}; case > 1: ratio = 1; break; } var removed = new GasMixture(Volume) { Temperature = Temperature }; Moles.CopyTo(removed.Moles.AsSpan()); NumericsHelpers.Multiply(removed.Moles, ratio); if (!Immutable) NumericsHelpers.Sub(Moles, removed.Moles); for (var i = 0; i < Moles.Length; i++) { var moles = Moles[i]; var otherMoles = removed.Moles[i]; if (moles < Atmospherics.GasMinMoles || float.IsNaN(moles)) Moles[i] = 0; if (otherMoles < Atmospherics.GasMinMoles || float.IsNaN(otherMoles)) removed.Moles[i] = 0; } return removed; } public GasMixture RemoveVolume(float vol) { return RemoveRatio(vol / Volume); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void CopyFromMutable(GasMixture sample) { if (Immutable) return; sample.Moles.CopyTo(Moles, 0); Temperature = sample.Temperature; } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void Clear() { if (Immutable) return; Array.Clear(Moles, 0, Atmospherics.TotalNumberOfGases); } [MethodImpl(MethodImplOptions.AggressiveInlining)] public void Multiply(float multiplier) { if (Immutable) return; NumericsHelpers.Multiply(Moles, multiplier); } void ISerializationHooks.AfterDeserialization() { // The arrays MUST have a specific length. Array.Resize(ref Moles, Atmospherics.AdjustedNumberOfGases); } public GasMixtureStringRepresentation ToPrettyString() { var molesPerGas = new Dictionary(); for (int i = 0; i < Moles.Length; i++) { if (Moles[i] == 0) continue; molesPerGas.Add(((Gas) i).ToString(), Moles[i]); } return new GasMixtureStringRepresentation(TotalMoles, Temperature, Pressure, molesPerGas); } public override bool Equals(object? obj) { if (obj is GasMixture mix) return Equals(mix); return false; } public bool Equals(GasMixture? other) { if (ReferenceEquals(null, other)) return false; if (ReferenceEquals(this, other)) return true; return Moles.SequenceEqual(other.Moles) && _temperature.Equals(other._temperature) && ReactionResults.SequenceEqual(other.ReactionResults) && Immutable == other.Immutable && Volume.Equals(other.Volume); } [SuppressMessage("ReSharper", "NonReadonlyMemberInGetHashCode")] public override int GetHashCode() { var hashCode = new HashCode(); for (var i = 0; i < Atmospherics.TotalNumberOfGases; i++) { var moles = Moles[i]; hashCode.Add(moles); } hashCode.Add(_temperature); hashCode.Add(Immutable); hashCode.Add(Volume); return hashCode.ToHashCode(); } public GasMixture Clone() { var newMixture = new GasMixture() { Moles = (float[])Moles.Clone(), _temperature = _temperature, Immutable = Immutable, Volume = Volume, }; return newMixture; } } }