Adding --collection-period feature in rocprofv3 to match v1/v2 parity (#9)

* Adding Trace Period feature to rocprofv3

* Adding feature documentation

* Update source/bin/rocprofv3.py

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* Fixing format

* Moving to Collection Period and changing the input params

* Format Fixes

* Fixing rebasing issues

* Removing atomic include from the tool

* Adding more options for units, optimizing the code

* Fixing rocprofv3.py

* Fixing time conv & adding time controlled app

* Fixing format

* Changing to shared memory testing methodology

* use of shmem use

* Fix include headers for transpose-time-controlled.cpp

* Format upload-image-to-github.py

* Removing shmem and using only env var to dump timestamps from the tool

* Tool Fixes + Test Config

* Adding Tests

* Fixing Review comments

* Update trace period implementation

* Update trace period tests

* check between start and stop timestamps

* Merge Fix

* Update validate.py

* Improve safety of rocprofiler_stop_context after finalization

* Pass context id to collection_period_cntrl by value

* Adding 20 us error margin

* Ensure log level for collection-period test is not more than warning

---------

Co-authored-by: Ammar ELWazir <aelwazir@amd.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Jonathan R. Madsen <jonathanrmadsen@gmail.com>

source/lib/rocprofiler-sdk-tool/config.cpp

@@ -211,6 +211,18 @@ config::config()
     if(pc_sampling_method_value == ROCPROFILER_PC_SAMPLING_METHOD_HOST_TRAP)
         pc_sampling_host_trap = true;
     pc_sampling_unit_value = pc_sampling_unit_map.at(pc_sampling_unit);
+
+    if(auto _collection_period = get_env("ROCPROF_COLLECTION_PERIOD", "");
+       !_collection_period.empty())
+    {
+        for(const auto& _config : sdk::parse::tokenize(_collection_period, ";"))
+        {
+            auto _config_params = sdk::parse::tokenize(_config, ":");
+            collection_periods.emplace(CollectionPeriod{std::stoull(_config_params.at(0)),
+                                                        std::stoull(_config_params.at(1)),
+                                                        std::stoull(_config_params.at(2))});
+        }
+    }
 }
 
 std::string