nasa / trickhla

TrickHLA: An IEEE 1516 High Level Architecture (HLA) Simulation Interoperability Standard Implementation for Trick Base Simulations

Hi 👋, welcome to the NASA org on github.com!

Github.com/nasa has one of the largest collections of NASA open-source code repositories. Members of the NASA org can find instructions for github.com/nasa in http://nasa.github.io/.

🔭 Additional open-source code repositories resides in a variety of locations other than github.com/nasa. To discover code across all of these locations, we suggest you use code.nasa.gov & software.nasa.gov. These are two different sites holding metadata that describe code projects. Any code released through the NASA Software Release Authority process should be cataloged on those sites.

Code.nasa.gov —

Is a page with short descriptions of all of NASA's open-source code. Code.nasa.gov feeds into code.gov, which covers open-source and government-source code from many different U.S. governmental agencies. To assist in discovery, code projects described on code.nasa.gov have both human and A.I.-generated tags. These can be useful for finding related code projects.

software.nasa.gov —

Contains metadata descriptions for all code projects in code.nasa.gov as well as government-source code projects only sharable with other government agencies. It is part of the large https://technology.nasa.gov/ that also includes patents and spinoffs. To help discoverability, software.nasa.gov puts each code project into one fo the following categories: Business Systems and Project Management, System Testing, Operations, Design and Integration Tools, Vehicle Management (Space/Air/Ground), Data Servers Processing and Handling, Propulsion, Structures and Mechanisms, Crew and Life Support, Data and Image Processing, Materials and Processes, Electronics and Electrical Power, Environmental Science (Earth, Air, Space, Exoplanet), Autonomous Systems, and Aeronautics.

NOTE - PROFILE READMES CURRENTLY DON'T WORK FOR ORG PROFILES ONLY USER PROFILES :(

https://github.community/t/readme-for-organization-front-page/2920

trickhla's Issues

Remove unused code.

Add pragma to ignore deprecated API's in IEEE 1516 code.

Refactor spin-lock wait code into its own class.

Inadvertent use of c++11 API for ifstream::open()

Update python code to not use execfile() since python3 does not support.

Indent after the hash for preprocessor directives.

To make the code easier to read, indent after the hash for preprocessor directives.

Update time class API's and microsecond calculations

1. Update the Int64Time and Int64Interval classes to use the same coding style used by TrickHLA for function names.
2. Make sure the Int64Interval::to_microseconds() function is used for converting from floating point seconds to a 64 bit integer representing microseconds. Otherwise, there may be a 1 microsecond difference in the conversion as a result of floating point truncation.

The ExecutionControl classes need to call ExecutionControlBase::initialize() of parent class.

Make cppcheck suppressions inline instead of in a file.

Moving the cppcheck suppressions to inline in the code will alleviate the need to keep the suppressions file updated when line numbers change because a file is edited..

Clean up include files and trick link dependencies.

Review the includes files and trick link dependencies to make sure they are correct and all files needed are included.

Refactor dynamic exception specifications.

Dynamic exception specifications are deprecated in C++11 and removed in C++17, so refactor the code to remove them or use a pragma to silence the deprecation warnings for the IEEE 1516 API's.

Create a SIM_sine simulation for the IMSim initialization scheme.

Add static code analysis script for the flawfinder tool.

Fix .gitignore to allow the simulation Modified_data/trick directory.

Rename get_double_time() function to get_time_in_seconds().

The get_double_time() function name is obscure and does not indicate what the function returns as clearly as it could. Rename the function to get_time_in_seconds().

Links to Trick

Need to add links to the Trick GitHub repo associated with the Trick references in the README.md file.

Use the correct HLA library for newer versions of gcc on Linux.

Cleanup LaTeX build artifacts.

Remove LaTeX build artifact files from the repo.

Fix HLA acronym in TrickHLA top level documentation.

The applicable documents section in the TrickHLA top level document has the HLA acronym as HLS. Fix this to be HLA.

Refactor save and restore label types.

Migrate save and restore labels to a std::string type instead of char *.

Add simulation synchronization example

Add an example SpaceFOM based simulation showing different ways to achieve simulation synchronization among the federates.

Handle warnings for null strings.

We should not get a warning about a refattribute pointing to a null string.

Update the read elapsed time statistics to recommend a minimum sample count.

Move debug_level setting and DebugHandler to the Federate class.

Because of when the Manager gets initialized, some debug messages will not be printed. We need to move the debug_level and the DebugHander initialization to the Federate.

Data recording group comment change.

Fix command-line usage in the simulation input files.

Remove simulation-time passed to some of the Manager function calls.

Remove the simulation time passed to the some of the Manager API's:
Manger::eceive_cyclic_data( exec_get_sim_time() );
Manger::send_cyclic_data( exec_get_sim_time() );
Manager::send_requested_data( exec_get_sim_time() );

Refactor the DebugHandler to use static functions and variables.

Refactor the DebugHandler class to use static variables and functions so that only the DebugHandler::print() function is needed for the code base instead of having to pass around an instance and daisy chain them together, which is error prone.

Improve spin-lock performance.

For SpaceFOM, only send ExCO updates when exiting freeze and not for all objects.

Update the blocking-cyclic-read Object setting for blocking I/O

Make sure the models code gets processed by the format_code.py script.

Fix the time_management flag to work as expected.

When a federate is configured to be non-regulating and non-constrained the time_management flag would automatically be set to false. This would also disable the TAR/TAG API's and this is not what we want.

Fix usage and default input file values for the SpaceFOM example simulations.

The gcc version 8 compiler is removing inline THLABaseSimObject destructor.

The gcc version 8 compiler is removing the inline THLABaseSimObject destructor if optimization is used and fails at link time as a result.

Fix call to obsolete sleep() function.

The C sleep() function is obsolete and was flagged as a flawfinder hit and we need to use nanosleep() instead.

To avoid a conflict with SWIG/Python, rename DebugHandler::print() to show().

Fix verbose messages to include the correct package and class name.

Refactor mutex

The current use of mutex's does not properly handle unlocking a mutex in the case of an exception exception. Refactor to automatically release a mutex lock when a mutex-protection wrapper goes out of scope.

Fix ExecutionConfiguration not being initialized before being configured.

Fix shutdown issues.

Measure and log elapsed time between cyclic data reads

Refactor sleep timer to use wall-clock for timeout

Need to refactor the sleep timer used in spin-locks to use the wall-cock time to determine timeout to be more accurate than counting the number of times nanosleep() was called.

Indent case labels.

Combine Manager send_cyclic_data() and send_requested_data() functions into one.

For efficiency, combine the Manager send_cyclic_data() and send_requested_data() functions into one function.

Use a consistent coding style for function implementations in header files

Resolve issues/warnings found from using cppcheck version 2.1

The cppcheck static code analysis application has been updated to version 2.1. Run the new version of cppcheck against the TrickHLA code to see if any new issues are found.

Remove the unnecessary simulation time parameter passed to cyclic data function calls.

Misleading job cycle time given in error message

The error message output when look-ahead time is not less than data cycle time is misleading.

I had set the data cycle time to 0.05 seconds but forgot to set the look-ahead time, and the expected error message still says my data cycle time was 0.1 seconds. I verified that my data was actually cycling at 20 Hz, so it's just a misleading message. The misleading part is highlighted below:

Manager::determine_job_cycle_time():2117 ERROR: The cycle time for this job is less than the HLA lookahead time! The HLA Lookahead time (0.1 seconds) must be less than or equal to the job cycle time (0.1 seconds). Make sure 'lookahead_time' in your input or modified-data file is less than or equal to the 'THLA_DATA_CYCLE_TIME' time specified in the S_define file for the send_requested_data(), send_cyclic_data(), and receive_cyclic_data() jobs.

Add missing braces for python3 print statements.