vpr: Add fix_clusters option to allow users to lock down any block to an x, y, subtile location

Author: sfkhalid

libs/EXTERNAL/libargparse/argparse_test.cpp

@@ -51,6 +51,7 @@ struct Args {
     ArgValue<float> exit_t;
     ArgValue<float> alpha_t;
     ArgValue<std::string> fix_pins;
+    ArgValue<std::string> fix_clusters;
     ArgValue<std::string> place_algorithm;
     ArgValue<size_t> place_chan_width;
 
@@ -302,6 +303,13 @@ int main(
                   " or a file specifying the pad locations.")
             .default_value("off")
             .show_in(argparse::ShowIn::HELP_ONLY);
+    place_grp.add_argument(args.fix_clusters, "--fix_clusters")
+            .help("Fixes block locations during placement."
+                  " Can be 'random' for a random initial assignment,"
+                  " 'off' to allow the place to optimize block locations,"
+                  " or a file specifying the block locations.")
+            .default_value("off")
+            .show_in(argparse::ShowIn::HELP_ONLY);
     place_grp.add_argument(args.place_algorithm, "--place_algorithm")
             .help("Controls which placement algorithm is used")
             .default_value("path_timing_driven")

vpr/src/base/read_options.cpp

@@ -1528,11 +1528,20 @@ argparse::ArgumentParser create_arg_parser(std::string prog_name, t_options& arg
         .help(
             "Fixes I/O pad locations during placement. Valid options:\n"
             " * 'free' allows placement to optimize pad locations\n"
-            " * 'random' fixes pad locations to arbitraray locations\n"
+            " * 'random' fixes pad locations to arbitrary locations\n"
             " * path to a file specifying pad locations (.place format with only pads specified).")
         .default_value("free")
         .show_in(argparse::ShowIn::HELP_ONLY);
 
+    place_grp.add_argument(args.pad_loc_file, "--fix_clusters")
+		.help(
+			"Fixes block locations during placement. Valid options:\n"
+			" * 'free' allows placement to optimize block locations\n"
+			" * 'random' fixes block locations to arbitrary locations\n"
+			" * path to a file specifying block locations (.place format with only pads specified).")
+		.default_value("free")
+		.show_in(argparse::ShowIn::HELP_ONLY);
+
     place_grp.add_argument<e_place_algorithm, ParsePlaceAlgorithm>(args.PlaceAlgorithm, "--place_algorithm")
         .help("Controls which placement algorithm is used")
         .default_value("path_timing_driven")