auto_partition_design (::quartus::incremental_compilation)

The following table displays information for the auto_partition_design Tcl command:

Tcl Package and Version

Belongs to ::quartus::incremental_compilation 1.1

Syntax auto_partition_design [-h | -help] [-long_help] [-logic_max <param> ] [-logic_min <param> ] [-max_partitions <param> ] [-percent_to_partition <param> ] [-top_level <param> ]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-logic_max <param> Maximum logic (LEs/Comb ALUTs + Registers) in new partitions.
-logic_min <param> Minimum logic (LEs/Comb ALUTs + Registers) in new partitions.
-max_partitions <param> Maximum number of new partitions to create.
-percent_to_partition <param> Target % of design to add to partitions
-top_level <param> Top-level for partitioning. Top-level and decendents are partitioned
Description
Invokes the Quartus Prime Auto-Partitioner to automatically create design 
partitions for incremental compilation.  

The Quartus Prime Auto-Partitioner searches through an existing design
hierarchy to extract modules that make good candidates for
partitioning.  The partitioner uses previous compilation results,
either after Analysis &Synthesis and Partition Merge, or after the
Fitter, to make partitioning decisions.

By default, the Quartus Prime Auto-Partitioner will consider making new 
partitions involving the designs top-level module and any of its 
corresponding descendant modules which are not already contained in 
another design partition.  

Use the -top_level <name> option to specify a particular design module
to begin partitioning exploration from. Only those design modules
which are decendents of top_level in the hierarchy are considered
for partitioning.

Use the -max_partitions <number> option to specify the maximum number
of new design partitions to create on this partitioning iteration.

Use the -percent_to_partition <PCT> option to set a target on how much 
design logic should be added to partitions as a percentage of overall 
design size.  

Use the -logic_min <number> and -logic_max <number> options to specify
ranges for the amount of logic that can be contained in any identified
partitions.  For the purpose of this option, logic is computed as:
Logic = (LEs or Combinational ALUTS) + (Dedicated Logic Registers)

ADDITIONAL NOTES: 

The Quartus Prime Auto-Partitioner does not remove or modify any existing 
design partitions defined prior to auto-partitioning.  

Device resource utilization changes after making design partitions.  
Device utilization thresholds used to drive partitioning decisions are 
based on previous compilation results. 

The Quartus Prime Auto-Partitioner is meant to serve as a guide for 
quickly creating an initial design partitioning scheme.  The ability of 
this feature to provide high-quality partitioning solutions depends 
heavily on the suitability of the design HDL for use with incremental 
compilation.  

For more information on best practices for creating partitions for use 
with Quartus Prime Incremental compilation, please refer to the Quartus 
II Handbook.
Example Usage
## Partition the design using default settings.
auto_partition_design

## Partition the design with limits on partition size
auto_partition_design -logic_min 3000 -logic_min 20000

## Partition approximately 65% of the design using up to 20 partitions
auto_partition_design -percent_to_partition 65 -max_partitions 20
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_OK 0 INFO: Quartus Prime Auto-partitioner is retrieving timing data. This may take a few minutes.
TCL_ERROR 1 ERROR: Running Quartus Prime Auto-Partitioner requires that Analysis &Synthesis and Partition Merge be performed first.
TCL_ERROR 1 ERROR: Quartus Prime Auto-partitioner could not locate module <string>. Please specify another module with the -top_level=<MODULE> option.
TCL_ERROR 1 ERROR: Quartus Prime Auto-Partitioner was unable to import timing data.
TCL_ERROR 1 ERROR: Quartus Prime Auto-partitioner cannot run. The last compiled device does not support Incremental Compilation.
TCL_ERROR 1 ERROR: Can't find active revision. Make sure there is an open, active revision name. Use the -revision option of project_open, project_new, or use set_current_revision.
TCL_ERROR 1 ERROR: No project is currently open. Open an existing project or create a new project.
TCL_ERROR 1 ERROR: No project is currently open. Open an existing project or create a new project.
TCL_ERROR 1 ERROR: Partition does not exist. Specify a valid partition name in the design.
TCL_ERROR 1 ERROR: Unable to change assignment. Quartus Prime Settings File is read-only.