# ARRAYPOLAR in AutoCAD

> How AutoCAD's ARRAYPOLAR works, prompt by prompt: the centre, the items, the angle between or filled, rotated items. Try it free in your browser.

ARRAYPOLAR copies a selection round a centre point, as one array object. It asks for the objects, says the type and whether the array is associative, asks for the centre point and shows the array at once: 6 items over a full turn, each turned as it goes round. Then one prompt edits it live until Enter makes it, through its options or the preview's grips, as in AutoCAD. The objects selected become its first item.

- **Command:** `ARRAYPOLAR`
- **Panel:** [Modify](https://mellowcad.com/docs/commands.md#modify)
- **Try it:** [Open the editor](/draw), type `ARRAYPOLAR` and press Enter.

## At the command line

The engine draws it and writes its history as you would type it: the prompts in AutoCAD 2027's order, with the same option letters.

A hole on a flange arrayed round the flange's centre: 8 items over a full turn.

```text
Command: ARRAYPOLAR
Select objects: 1 found
Select objects:
Type = Polar  Associative = Yes
Specify center point of array: 0,0
Select grip to edit array or [ASsociative/Items/Angle between/Fill angle/ROTate items/eXit]<eXit>: I
Enter number of items in array <6>: 8
Select grip to edit array or [ASsociative/Items/Angle between/Fill angle/ROTate items/eXit]<eXit>: X
```

## Options

### `ASsociative` (`AS`)

`Yes`, the default, makes one array object, which its grips and the Properties palette change later; `No` makes separate copies beside the objects selected. The answer is kept for the session, by ARRAYRECT and ARRAYPATH too.

### `Items` (`I`)

The number of items, from 1 to 32767; the angle they fill is kept.

### `Angle between` (`A`)

The angle from one item to the next. The angle filled becomes that many steps, the direction kept, and a full turn once they reach 360°.

### `Fill angle` (`F`)

The angle the items fill, positive counter-clockwise and negative clockwise; the number of items is kept. Over a full turn the items are a turn divided by their number apart; over less, the last one lands at the end of the angle.

### `ROTate items` (`ROT`)

`Yes`, the default, turns each item as it goes round the centre; `No` only moves it, so every item stands as the first does.

### `eXit` (`X`)

Makes the array and ends the command, as Enter does.

## What it does not do yet

Base point; Axis of rotation, for an array round an axis in space; ROWs and Levels, for rings of items and copies stacked in Z; Expression, which ties a value to the drawing's parameters. The menus of the array's grips (Stretch Radius, Item Count, Fill Angle…) and Ctrl to cycle them.

[What it does and still lacks, in detail (in English)](https://github.com/ovelilla/mellowcad/blob/main/docs/coverage/modify.md#arraypolar--es-matrizpolar--pt-br-matrizpolar)

## Questions

### How do I make a polar array?

Type `ARRAYPOLAR`, select the objects, press Enter and pick the centre point; or type `AR` for [`ARRAY`](https://mellowcad.com/docs/commands/array.md) and choose `POlar` after the objects. Then choose `Items` to set how many, and press Enter to make it.

### How do I array objects round part of a circle?

Choose `Fill` and type the angle: 180 lays the items over half a circle counter-clockwise, -180 clockwise. The number of items is kept, the first and the last at each end of the angle.

### How do I keep the items from rotating?

Choose `ROTate` and answer `No`: each item is moved round the centre without turning.

### How do I change the radius of a polar array?

Select the array and drag its square grip at the base point towards or away from the centre: the distance to the centre is the new radius. Or retype Radius in the Properties palette.

## Related commands

- [ARRAY in AutoCAD](https://mellowcad.com/docs/commands/array.md)
- [ARRAYRECT in AutoCAD](https://mellowcad.com/docs/commands/arrayrect.md)
- [ARRAYPATH in AutoCAD](https://mellowcad.com/docs/commands/arraypath.md)
- [ROTATE in AutoCAD](https://mellowcad.com/docs/commands/rotate.md)