SymmetryHelpers.h

Go to the documentation of this file.

/*
 * This file is a part of the Biology project by eons LLC.
 * Biology (aka Develop Biology) is a framework for approaching software
 * development from a natural sciences perspective.
 *
 * Copyright (C) 2025 Séon O'Shannon & eons LLC
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as
 * published by the Free Software Foundation, either version 3 of the
 * License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <https://www.gnu.org/licenses/>.
 */
 
#pragma once
 
#include "bio/chemical/symmetry/Symmetry.h"
#include "bio/chemical/common/Helpers.h"
#include "bio/common/Cast.h"
#include "bio/common/thread/SafelyAccess.h"
#include "bio/physical/wave/Wave.h"
#include "bio/chemical/relativity/PeriodicTable.h"
 
namespace bio {
namespace molecular {
namespace symmetry_helper {
 
inline Pointer< chemical::Symmetry > CloneSymmetry(Pointer< const physical::Symmetry > symmetry)
{
    BIO_SANITIZE(symmetry, , return NULL)
 
    Pointer< chemical::Symmetry > clone = new chemical::Symmetry(
        symmetry->GetName(),
        symmetry->GetType().GetId()
    );
    clone->SetValue(symmetry->GetValue());
 
    // Recurse into nested children only for chemical Symmetries. The proven
    // PeriodicTable-id resonance check (chemical::atom_detail) is used instead
    // of an inline GetPropertiesOf< chemical::Symmetry >() resonance, which
    // returns a non-resonating Property set under the fleet -fno-rtti build and
    // silently dropped all nested children (and, via IsChemicalSymmetry below,
    // the entire Solutes round-trip).
    if (chemical::atom_detail::IsChemicalSymmetry(symmetry))
    {
        Pointer< const chemical::Symmetry > chemical = Cast< Pointer< const chemical::Symmetry > >(symmetry);
        Pointer< const Container > children = chemical->GetAll< physical::Symmetry >();
        if (children)
        {
            for (
                SmartIterator child = children->Begin();
                !child.IsAfterEnd();
                ++child
            )
            {
                Pointer< const physical::Symmetry > childSym = child.As< Pointer< physical::Symmetry > >();
                Pointer< chemical::Symmetry > childClone = CloneSymmetry(childSym);
                if (childClone)
                {
                    clone->Add< physical::Symmetry >(childClone);
                }
            }
        }
    }
 
    return clone;
}
 
inline bool IsChemicalSymmetry(Pointer< const physical::Symmetry > symmetry)
{
    // Delegate to the proven PeriodicTable-id-keyed resonance check. The prior
    // inline GetPropertiesOf< chemical::Symmetry >() variant returned a
    // non-resonating Property set under the fleet -fno-rtti build, so this
    // guard wrongly reported every freshly-Spun chemical::Symmetry as
    // not-chemical — silently disabling Vesicle's entire Solutes Spin/Reify
    // round-trip (and any StemCell/derived Spin built on this guard).
    return chemical::atom_detail::IsChemicalSymmetry(symmetry);
}
 
} //symmetry_helper namespace
} //molecular namespace
} //bio namespace