[AP][Legalizer] Added Ability to Generate a Mass Report

doc/src/vpr/command_line_usage.rst

@@ -1336,6 +1336,15 @@ Analytical Placement is generally split into three stages:
 
     **Default:** ``1``
 
+.. option:: --ap_generate_mass_report {on | off}
+
+    Controls whether to generate a report on how the partial legalizer
+    within the AP flow calculates the mass of primitives and the
+    capacity of tiles on the device. This report is useful when
+    debugging the partial legalizer.
+
+    **Default:** ``off``
+
 
 .. _router_options:
 

vpr/src/analytical_place/analytical_placement_flow.cpp

@@ -144,6 +144,7 @@ static PartialPlacement run_global_placer(const t_ap_opts& ap_opts,
                                                                          device_ctx.physical_tile_types,
                                                                          pre_cluster_timing_manager,
                                                                          ap_opts.ap_timing_tradeoff,
+                                                                         ap_opts.generate_mass_report,
                                                                          ap_opts.num_threads,
                                                                          ap_opts.log_verbosity);
         return global_placer->place();