---
title: "revolve"
excerpt: "Rotate a sketch around some provided axis, creating a solid from its extent."
layout: manual
---

Rotate a sketch around some provided axis, creating a solid from its extent.

This, like extrude, is able to create a 3-dimensional solid from a 2-dimensional sketch. However, unlike extrude, this creates a solid by using the extent of the sketch as its revolved around an axis rather than using the extent of the sketch linearly translated through a third dimension.

Revolve occurs around a local sketch axis rather than a global axis.

```js
revolve(data: RevolveData, sketch: Sketch) -> Solid
```


### Arguments

| Name | Type | Description | Required |
|----------|------|-------------|----------|
| `data` | [`RevolveData`](/docs/kcl/types/RevolveData) | Data for revolution surfaces. | Yes |
| `sketch` | [`Sketch`](/docs/kcl/types/Sketch) | A sketch is a collection of paths. | Yes |

### Returns

[`Solid`](/docs/kcl/types/Solid) - An solid is a collection of extrude surfaces.


### Examples

```js
part001 = startSketchOn('XY')
  |> startProfileAt([4, 12], %)
  |> line(end = [2, 0])
  |> line(end = [0, -6])
  |> line(end = [4, -6])
  |> line(end = [0, -6])
  |> line(end = [-3.75, -4.5])
  |> line(end = [0, -5.5])
  |> line(end = [-2, 0])
  |> close()
  |> revolve({ axis = 'y' }, %) // default angle is 360
```

![Rendered example of revolve 0](data:image/png;base64,[encoded data, 134900 characters])

```js
// A donut shape.
sketch001 = startSketchOn('XY')
  |> circle({ center = [15, 0], radius = 5 }, %)
  |> revolve({ angle = 360, axis = 'y' }, %)
```

![Rendered example of revolve 1](data:image/png;base64,[encoded data, 206808 characters])

```js
part001 = startSketchOn('XY')
  |> startProfileAt([4, 12], %)
  |> line(end = [2, 0])
  |> line(end = [0, -6])
  |> line(end = [4, -6])
  |> line(end = [0, -6])
  |> line(end = [-3.75, -4.5])
  |> line(end = [0, -5.5])
  |> line(end = [-2, 0])
  |> close()
  |> revolve({ axis = 'y', angle = 180 }, %)
```

![Rendered example of revolve 2](data:image/png;base64,[encoded data, 102260 characters])

```js
part001 = startSketchOn('XY')
  |> startProfileAt([4, 12], %)
  |> line(end = [2, 0])
  |> line(end = [0, -6])
  |> line(end = [4, -6])
  |> line(end = [0, -6])
  |> line(end = [-3.75, -4.5])
  |> line(end = [0, -5.5])
  |> line(end = [-2, 0])
  |> close()
  |> revolve({ axis = 'y', angle = 180 }, %)
part002 = startSketchOn(part001, 'end')
  |> startProfileAt([4.5, -5], %)
  |> line(end = [0, 5])
  |> line(end = [5, 0])
  |> line(end = [0, -5])
  |> close()
  |> extrude(length = 5)
```

![Rendered example of revolve 3](data:image/png;base64,[encoded data, 97472 characters])

```js
box = startSketchOn('XY')
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 20])
  |> line(end = [20, 0])
  |> line(end = [0, -20])
  |> close()
  |> extrude(length = 20)

sketch001 = startSketchOn(box, "END")
  |> circle({ center = [10, 10], radius = 4 }, %)
  |> revolve({ angle = -90, axis = 'y' }, %)
```

![Rendered example of revolve 4](data:image/png;base64,[encoded data, 146596 characters])

```js
box = startSketchOn('XY')
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 20])
  |> line(end = [20, 0])
  |> line(end = [0, -20], tag = $revolveAxis)
  |> close()
  |> extrude(length = 20)

sketch001 = startSketchOn(box, "END")
  |> circle({ center = [10, 10], radius = 4 }, %)
  |> revolve({
       angle = 90,
       axis = getOppositeEdge(revolveAxis)
     }, %)
```

![Rendered example of revolve 5](data:image/png;base64,[encoded data, 147640 characters])

```js
box = startSketchOn('XY')
  |> startProfileAt([0, 0], %)
  |> line(end = [0, 20])
  |> line(end = [20, 0])
  |> line(end = [0, -20], tag = $revolveAxis)
  |> close()
  |> extrude(length = 20)

sketch001 = startSketchOn(box, "END")
  |> circle({ center = [10, 10], radius = 4 }, %)
  |> revolve({
       angle = 90,
       axis = getOppositeEdge(revolveAxis),
       tolerance = 0.0001
     }, %)
```

![Rendered example of revolve 6](data:image/png;base64,[encoded data, 147640 characters])

```js
sketch001 = startSketchOn('XY')
  |> startProfileAt([10, 0], %)
  |> line(end = [5, -5])
  |> line(end = [5, 5])
  |> line(endAbsolute = [profileStartX(%), profileStartY(%)])
  |> close()

part001 = revolve({
  axis = {
    custom = {
      axis = [0.0, 1.0],
      origin = [0.0, 0.0]
    }
  }
}, sketch001)
```

![Rendered example of revolve 7](data:image/png;base64,[encoded data, 169956 characters])


