[vpr][route][crr] add comments for crr sw block mng

Author: amin1377

vpr/src/route/rr_graph_generation/tileable_rr_graph/crr_generator/crr_pattern_matcher.h

@@ -6,7 +6,12 @@
 
 namespace crrgenerator {
 
-class PatternMatcher {
+/**
+ * @brief Helper class used by the CRR Generator to determine which switch block pattern
+ * should be applied to each tile. It does so by finding the first matching pattern
+ * for each location.
+ */
+class CRRPatternMatcher {
   private:
     // Helper function to parse range [start:end:step] or comma-separated values [7,20]
     static bool matches_range(int value, const std::string& range_str) {

vpr/src/route/rr_graph_generation/tileable_rr_graph/crr_generator/crr_switch_block_manager.cpp

@@ -15,11 +15,9 @@ namespace crrgenerator {
 SwitchBlockManager::SwitchBlockManager() = default;
 
 void SwitchBlockManager::initialize(const std::string& sb_maps_file,
-                                    const std::string& sb_annotated_dir) {
+                                    const std::string& sb_templates_dir) {
     VTR_LOG("Initializing SwitchBlockManager with maps file: %s\n", sb_maps_file.c_str());
 
-    annotated_dir_ = sb_annotated_dir;
-
     // Load YAML configuration
     try {
         YAML::Node config = YAML::LoadFile(sb_maps_file);
@@ -42,7 +40,7 @@ void SwitchBlockManager::initialize(const std::string& sb_maps_file,
                 sw_template_file = "";
             }
 
-            std::string full_path = std::filesystem::path(annotated_dir_) / sw_template_file;
+            std::string full_path = std::filesystem::path(sb_templates_dir) / sw_template_file;
             if (sw_template_file.empty()) {
                 full_path = "";
             }

vpr/src/route/rr_graph_generation/tileable_rr_graph/crr_generator/crr_switch_block_manager.h

@@ -22,11 +22,10 @@ class SwitchBlockManager {
     /**
      * @brief Initialize the manager with configuration file
      * @param sb_maps_file Path to the YAML configuration file
-     * @param sb_annotated_dir Directory containing switch template files
-     * @param is_annotated Whether the switches are annotated in switch template files
+     * @param sb_templates_dir Directory containing switch template files
      */
     void initialize(const std::string& sb_maps_file,
-                    const std::string& sb_annotated_dir);
+                    const std::string& sb_templates_dir);
 
     /**
      * @brief Get the switch template file name for a given pattern
@@ -81,12 +80,26 @@ class SwitchBlockManager {
      * YAML file, the pattern defined earliest in the list will be used.
      */
     std::vector<std::string> ordered_switch_block_patterns_;
+
+    /**
+     * @brief Maps switch block patterns to their corresponding full file paths.
+     */
     std::unordered_map<std::string, std::string> switch_block_to_file_;
+
+    /**
+     * @brief Maps switch block patterns to their corresponding dataframes.
+     */
     std::unordered_map<std::string, DataFrame*> dataframes_;
+
+    /**
+     * @brief Maps full file paths to their corresponding dataframes.
+     */
     std::unordered_map<std::string, DataFrame> file_cache_;
 
+    /**
+     * @brief Processor for reading and processing switch block template files.
+     */
     DataFrameProcessor processor_;
-    std::string annotated_dir_;
 
     // Validation
     void validate_yaml_structure(const YAML::Node& root);