Add a new API remap_rr_node_switch_indices() to RRGraphBuilder

[m-hariszafar]

Description
This PR focuses on updating routing resource graph builder functions, where we use the refactored data structure RRGraphBuilder to shadow the discrete data structure rr_graph_storage.
This PR aims to fully refactored/deprecate the direct use of the legacy API remap_rr_node_switch_indices() from the rr_node data structure.

After this PR, the remap_rr_node_switch_indices() from the refactored data structure RRGraphBuilder is the only way to use it.

Checklist:

• Removed the legacy API remap_rr_node_switch_indices() from rr_node.cpp and rr_node.h (if present)
• Added new API remap_rr_node_switch_indices() to data structures RRGraphBuilder, whose comments are Doxygen compatible
• Replaced all the use of remap_rr_node_switch_indices() in respective functions

Related Issue
This pull request is a follow-up PR on the routing resource graph refactoring effort #1805, #1868

Motivation and Context
This PR is a continuation of the refactoring effort with a focus on shadowing the rr_graph_storage APIs in the RRGraphBuilder data structure.
This PR refactored the remap_rr_node_switch_indices() API among the other APIs in #1847, #1868

How Has This Been Tested?

• All vtr basic and strong tests are passing.

Types of changes

• Bug fix (change which fixes an issue)
• New feature (change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

• My change requires a change to the documentation
• I have updated the documentation accordingly
• I have added tests to cover my changes
• All new and existing tests passed

[m-hariszafar]

QoR tests are completed and a quick summary is given below. QoR comparison files are also attached.

titan_quick_qor test:
flow run time 5.69% on average.
critical path delays 0% on average.
Peak memory usage -0.14% on average

vtr_reg_qor_chain_depop test:
Flow run time 20.56% on average.
critical path delay 0% on average.
Peak memory usage is -14.65% on average.

Here are the attached files
titan_quick_qor.xlsx
vtr_chain_depop.xlsx

[tangxifan]

LGTM

[tangxifan]

@vaughnbetz The doc build issue is expected to be fixed at #1898

[tangxifan]

@hariszafar-lm Please merge the master into this branch. This should clear the red flag.