{
"cells": [
{
"cell_type": "markdown",
"id": "38d33391",
"metadata": {},
"source": [
"# `stroke` aesthetic\n",
"\n",
"Affects the thickness of the point boundaries (in case the given shape has a boundary).\n",
"\n",
"Available for the following geometries: `geomPoint()`, `geomJitter()`, `geomQQ()`, `geomQQ2()`, `geomPointRange()`, `geomDotplot()`, `geomYDotplot()`."
]
},
{
"cell_type": "code",
"execution_count": 1,
"id": "2414e10d",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:53.734661Z",
"iopub.status.busy": "2025-12-03T15:56:53.733193Z",
"iopub.status.idle": "2025-12-03T15:56:55.638548Z",
"shell.execute_reply": "2025-12-03T15:56:55.638350Z"
}
},
"outputs": [
{
"data": {
"text/html": [
" \n",
" "
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"text/html": [
" \n",
" "
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"%useLatestDescriptors\n",
"%use lets-plot"
]
},
{
"cell_type": "code",
"execution_count": 2,
"id": "49a95a58",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:55.641019Z",
"iopub.status.busy": "2025-12-03T15:56:55.640490Z",
"iopub.status.idle": "2025-12-03T15:56:55.676627Z",
"shell.execute_reply": "2025-12-03T15:56:55.676043Z"
}
},
"outputs": [
{
"data": {
"text/plain": [
"Lets-Plot Kotlin API v.4.12.0. Frontend: Notebook with dynamically loaded JS. Lets-Plot JS v.4.8.1.\n",
"Outputs: Web (HTML+JS), Kotlin Notebook (Swing), Static SVG (hidden)"
]
},
"execution_count": 2,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"LetsPlot.getInfo()"
]
},
{
"cell_type": "code",
"execution_count": 3,
"id": "7795fa94",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:55.678731Z",
"iopub.status.busy": "2025-12-03T15:56:55.678236Z",
"iopub.status.idle": "2025-12-03T15:56:55.892169Z",
"shell.execute_reply": "2025-12-03T15:56:55.891814Z"
}
},
"outputs": [],
"source": [
"val n = 26\n",
"val data1 = mapOf(\n",
" \"x\" to List(4) { (0..6) }.flatten().take(n),\n",
" \"y\" to (3 downTo 0).flatMap { y -> List(7) { y } }.take(n),\n",
" \"shape\" to (0 until n).toList()\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 4,
"id": "1b7975fc",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:55.894185Z",
"iopub.status.busy": "2025-12-03T15:56:55.893655Z",
"iopub.status.idle": "2025-12-03T15:56:55.986350Z",
"shell.execute_reply": "2025-12-03T15:56:55.986092Z"
}
},
"outputs": [],
"source": [
"val p1 = letsPlot(data1) { x = \"x\"; y = \"y\" } + \n",
" scaleShapeIdentity() + \n",
" lims(x = -1 to 7, y = -1 to 4) +\n",
" theme().legendPositionNone()"
]
},
{
"cell_type": "markdown",
"id": "788ed3dd",
"metadata": {},
"source": [
"#### 1. Default Stroke"
]
},
{
"cell_type": "code",
"execution_count": 5,
"id": "fbbf5d7f",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:55.988512Z",
"iopub.status.busy": "2025-12-03T15:56:55.987947Z",
"iopub.status.idle": "2025-12-03T15:56:56.208561Z",
"shell.execute_reply": "2025-12-03T15:56:56.208688Z"
}
},
"outputs": [
{
"data": {
"text/html": [
" \n",
" "
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"application/plot+json": {
"apply_color_scheme": true,
"output": {
"data": {
"shape": [
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
7.0,
8.0,
9.0,
10.0,
11.0,
12.0,
13.0,
14.0,
15.0,
16.0,
17.0,
18.0,
19.0,
20.0,
21.0,
22.0,
23.0,
24.0,
25.0
],
"x": [
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
0.0,
1.0,
2.0,
3.0,
4.0
],
"y": [
3.0,
3.0,
3.0,
3.0,
3.0,
3.0,
3.0,
2.0,
2.0,
2.0,
2.0,
2.0,
2.0,
2.0,
1.0,
1.0,
1.0,
1.0,
1.0,
1.0,
1.0,
0.0,
0.0,
0.0,
0.0,
0.0
]
},
"data_meta": {
"series_annotations": [
{
"column": "x",
"type": "int"
},
{
"column": "y",
"type": "int"
},
{
"column": "shape",
"type": "int"
}
]
},
"kind": "plot",
"layers": [
{
"color": "#54278f",
"fill": "#dd1c77",
"geom": "point",
"mapping": {
"shape": "shape"
},
"position": "identity",
"size": 12.0,
"stat": "identity"
}
],
"mapping": {
"x": "x",
"y": "y"
},
"scales": [
{
"aesthetic": "shape",
"discrete": true,
"guide": "none",
"scale_mapper_kind": "identity"
},
{
"aesthetic": "x",
"limits": [
-1.0,
7.0
]
},
{
"aesthetic": "y",
"limits": [
-1.0,
4.0
]
}
],
"theme": {
"legend_position": "none"
}
},
"output_type": "lets_plot_spec",
"swing_enabled": true
},
"text/html": [
" \n",
" \n",
" "
]
},
"execution_count": 5,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"p1 + geomPoint(size=12, color=\"#54278f\", fill=\"#dd1c77\") { shape = \"shape\" }"
]
},
{
"cell_type": "markdown",
"id": "ec91cc9b",
"metadata": {},
"source": [
"#### 2. Increased Stroke"
]
},
{
"cell_type": "code",
"execution_count": 6,
"id": "57c5e75c",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:56.210093Z",
"iopub.status.busy": "2025-12-03T15:56:56.209845Z",
"iopub.status.idle": "2025-12-03T15:56:56.256483Z",
"shell.execute_reply": "2025-12-03T15:56:56.256620Z"
}
},
"outputs": [
{
"data": {
"application/plot+json": {
"apply_color_scheme": true,
"output": {
"data": {
"shape": [
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
7.0,
8.0,
9.0,
10.0,
11.0,
12.0,
13.0,
14.0,
15.0,
16.0,
17.0,
18.0,
19.0,
20.0,
21.0,
22.0,
23.0,
24.0,
25.0
],
"x": [
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
0.0,
1.0,
2.0,
3.0,
4.0,
5.0,
6.0,
0.0,
1.0,
2.0,
3.0,
4.0
],
"y": [
3.0,
3.0,
3.0,
3.0,
3.0,
3.0,
3.0,
2.0,
2.0,
2.0,
2.0,
2.0,
2.0,
2.0,
1.0,
1.0,
1.0,
1.0,
1.0,
1.0,
1.0,
0.0,
0.0,
0.0,
0.0,
0.0
]
},
"data_meta": {
"series_annotations": [
{
"column": "x",
"type": "int"
},
{
"column": "y",
"type": "int"
},
{
"column": "shape",
"type": "int"
}
]
},
"kind": "plot",
"layers": [
{
"color": "#54278f",
"fill": "#dd1c77",
"geom": "point",
"mapping": {
"shape": "shape"
},
"position": "identity",
"size": 12.0,
"stat": "identity",
"stroke": 8.0
}
],
"mapping": {
"x": "x",
"y": "y"
},
"scales": [
{
"aesthetic": "shape",
"discrete": true,
"guide": "none",
"scale_mapper_kind": "identity"
},
{
"aesthetic": "x",
"limits": [
-1.0,
7.0
]
},
{
"aesthetic": "y",
"limits": [
-1.0,
4.0
]
}
],
"theme": {
"legend_position": "none"
}
},
"output_type": "lets_plot_spec",
"swing_enabled": true
},
"text/html": [
" \n",
" \n",
" "
]
},
"execution_count": 6,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"p1 + geomPoint(size=12, stroke=8, color=\"#54278f\", fill=\"#dd1c77\") { shape = \"shape\" }"
]
},
{
"cell_type": "markdown",
"id": "a80e77a8",
"metadata": {},
"source": [
"#### 3. Stroke Scales"
]
},
{
"cell_type": "code",
"execution_count": 7,
"id": "cd516883",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:56.259010Z",
"iopub.status.busy": "2025-12-03T15:56:56.258707Z",
"iopub.status.idle": "2025-12-03T15:56:56.307032Z",
"shell.execute_reply": "2025-12-03T15:56:56.306833Z"
}
},
"outputs": [],
"source": [
"val data2 = mapOf(\n",
" \"x\" to listOf(0, 1, 2),\n",
" \"y\" to listOf(0, 0, 0),\n",
" \"stroke\" to listOf(4, 16, 8)\n",
")"
]
},
{
"cell_type": "code",
"execution_count": 8,
"id": "65ac3c1e",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:56.308908Z",
"iopub.status.busy": "2025-12-03T15:56:56.308547Z",
"iopub.status.idle": "2025-12-03T15:56:56.345012Z",
"shell.execute_reply": "2025-12-03T15:56:56.344779Z"
}
},
"outputs": [],
"source": [
"val p2 = letsPlot(data2) { x = \"x\"; y = \"y\" } +\n",
" geomPoint(size = 12, shape = 21, color = \"#54278f\", fill = \"#dd1c77\") { stroke = \"stroke\" }"
]
},
{
"cell_type": "code",
"execution_count": 9,
"id": "86c86e91",
"metadata": {
"execution": {
"iopub.execute_input": "2025-12-03T15:56:56.346623Z",
"iopub.status.busy": "2025-12-03T15:56:56.346264Z",
"iopub.status.idle": "2025-12-03T15:56:56.429370Z",
"shell.execute_reply": "2025-12-03T15:56:56.429498Z"
}
},
"outputs": [
{
"data": {
"application/plot+json": {
"apply_color_scheme": true,
"output": {
"figures": [
{
"data": {
"stroke": [
4.0,
16.0,
8.0
],
"x": [
0.0,
1.0,
2.0
],
"y": [
0.0,
0.0,
0.0
]
},
"data_meta": {
"series_annotations": [
{
"column": "x",
"type": "int"
},
{
"column": "y",
"type": "int"
},
{
"column": "stroke",
"type": "int"
}
]
},
"ggtitle": {
"text": "Default scale"
},
"kind": "plot",
"layers": [
{
"color": "#54278f",
"fill": "#dd1c77",
"geom": "point",
"mapping": {
"stroke": "stroke"
},
"position": "identity",
"shape": 21.0,
"size": 12.0,
"stat": "identity"
}
],
"mapping": {
"x": "x",
"y": "y"
},
"scales": []
},
{
"data": {
"stroke": [
4.0,
16.0,
8.0
],
"x": [
0.0,
1.0,
2.0
],
"y": [
0.0,
0.0,
0.0
]
},
"data_meta": {
"series_annotations": [
{
"column": "x",
"type": "int"
},
{
"column": "y",
"type": "int"
},
{
"column": "stroke",
"type": "int"
}
]
},
"ggtitle": {
"text": "scaleStroke()"
},
"kind": "plot",
"layers": [
{
"color": "#54278f",
"fill": "#dd1c77",
"geom": "point",
"mapping": {
"stroke": "stroke"
},
"position": "identity",
"shape": 21.0,
"size": 12.0,
"stat": "identity"
}
],
"mapping": {
"x": "x",
"y": "y"
},
"scales": [
{
"aesthetic": "stroke",
"range": [
2.0,
4.0
]
}
]
},
{
"data": {
"stroke": [
4.0,
16.0,
8.0
],
"x": [
0.0,
1.0,
2.0
],
"y": [
0.0,
0.0,
0.0
]
},
"data_meta": {
"series_annotations": [
{
"column": "x",
"type": "int"
},
{
"column": "y",
"type": "int"
},
{
"column": "stroke",
"type": "int"
}
]
},
"ggtitle": {
"text": "scaleStrokeIdentity()"
},
"kind": "plot",
"layers": [
{
"color": "#54278f",
"fill": "#dd1c77",
"geom": "point",
"mapping": {
"stroke": "stroke"
},
"position": "identity",
"shape": 21.0,
"size": 12.0,
"stat": "identity"
}
],
"mapping": {
"x": "x",
"y": "y"
},
"scales": [
{
"aesthetic": "stroke",
"guide": "none",
"scale_mapper_kind": "identity"
}
]
},
null
],
"kind": "subplots",
"layout": {
"align": false,
"fit": true,
"name": "grid",
"ncol": 2,
"nrow": 2
}
},
"output_type": "lets_plot_spec",
"swing_enabled": true
},
"text/html": [
" \n",
" \n",
" "
]
},
"execution_count": 9,
"metadata": {},
"output_type": "execute_result"
}
],
"source": [
"gggrid(\n",
" listOf(\n",
" p2 + ggtitle(\"Default scale\"),\n",
" p2 + scaleStroke(range = 2 to 4) + ggtitle(\"scaleStroke()\"),\n",
" p2 + scaleStrokeIdentity() + ggtitle(\"scaleStrokeIdentity()\"),\n",
" ),\n",
" ncol = 2\n",
")"
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Kotlin",
"language": "kotlin",
"name": "kotlin"
},
"language_info": {
"codemirror_mode": "text/x-kotlin",
"file_extension": ".kt",
"mimetype": "text/x-kotlin",
"name": "kotlin",
"nbconvert_exporter": "",
"pygments_lexer": "kotlin",
"version": "2.2.20-Beta2"
}
},
"nbformat": 4,
"nbformat_minor": 5
}