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

While working on the mass abstraction in the partial legalizer of the
globlal placer, found that I needed a lot more information on the device
to be able to debug the mass calculations.

Added a command-line option which will generate a mass report if
requested. This mass report contains useful information on the device,
the netlist, and the mass / capacities computed in the mass calculator.

Author: AlexandreSinger

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();