Report

The Object Report plugin shows the properties of the selected objects in a tree. It lists the object type, the name, the dimensions, the units, the options, and the apertures, tools, drills or slots of the object. Use it to check a board size, the copper area or the drill count before you run a job.

Where to find it

• Menu: Options > Object Report.
• Shortcut: P. Press it with the canvas in focus.

Quick start

1. Select 1 or more objects in the Project tab.
2. Press P to open the report.
3. Read the TYPE and NAME groups at the top of the tree.
4. Open the Dimensions group to see the Length, Width, Box Area, Convex_Hull Area and Copper Area.
5. Open the Apertures, Tools, Drills or Slots groups to see the details of the object.

Screenshot placeholder: images/Report-1.png — The Object Report tree for a Gerber object, with the Dimensions group and the Apertures group open.

Parameters

The Object Report has no input fields. It only shows values. The tree has 2 columns: the name and the value.

Groups that every report shows

Group	Row	Description
TYPE	Object Type	The kind of object: GERBER, EXCELLON, GEOMETRY or CNCJOB.
TYPE	Geo Type	Geometry objects only: Single-Geo or Multi-Geo.
NAME	Object name	The name of the object.
Dimensions	Length	The size of the object along X, in the app units.
Dimensions	Width	The size of the object along Y, in the app units.
Dimensions	Box Area	The area of the bounding box: cm² in mm projects, in² in inch projects.
Dimensions	Convex_Hull Area	The area of the convex hull of the geometry, in the same units as Box Area. CNCJob objects do not show it.
Dimensions	Copper Area	Gerber objects only. The total area of the copper polygons. See the known issue below.
Units	FlatCAM units	The app units: Metric or Inch.
Units	Object units	The units of the object file.
Options	1 row for each option	The saved options of the object, for example the plot setting.

Groups for each object type

Object type	Group	Rows
Gerber	Apertures	1 sub-group for each aperture: the aperture data, Solid_Geo (number of polygons), Follow_Geo (number of lines) and Clear_Geo (number of polygons).
Excellon	Tools	1 sub-group for each tool: Diameter, Drills number and Slots number.
Excellon	Drills	Drills total number.
Excellon	Slots	Slots total number.
Geometry	Tools	1 sub-group for each tool: the tool data, the number of solid geometry items and the Data sub-group.
CNCJob	Tools	1 sub-group for each tool. A Geometry CNCJob shows Solid Geometry, GCode Text, GCode Geometry and Tool Data. An Excellon CNCJob shows Diameter, Drills number, Slots number, Depth of Cut, Clearance Height, Feedrate and Tool Data.
CNCJob	Others	Routing time and Travelled distance.

Advanced

• Selection. The report shows all the selected objects, 1 after the other. If no object is selected, it shows "No object is selected."
• Convex hull. The hull is the smallest convex shape that holds all the geometry of the object.
• Routing time. The report shows minutes if the time is more than 1 minute. Else it shows seconds.
• Depth of Cut. For an Excellon CNCJob, this is the cut Z minus the tool offset.
• Refresh. The plugin makes the report when you open it. Press P again after you change an object.
• Known issue. The code divides the copper area by 100 in all projects. In mm projects the value is correct in cm². In inch projects the value is 1/100 of the real area in in².
• Tcl. No Tcl command opens this report. Use the bounds and get_names commands, see Tcl Command Reference.

See also

• Object Operations
• Gerber Object · Excellon Object · Geometry Object · CNCJob Object
• Optimal — the minimum distance between copper features.
• Preferences: General — the app units.