Documentation for v4.12.0 (#293)

Author: ASmirnov-HORIS

Writerside/images/changelog/4.12.0/geom_pointdensity.png

@@ -4,12 +4,16 @@
 
 ![Point shapes](aesthetics_shape.png)
 
+See [example notebook](%nb-aesthetics-point_shapes%).
+
 ## Line Types
 
 ### Predefined Patterns
 
 ![Predefined line types](aesthetics_linetype.png)
 
+See [example notebook](%nb-aesthetics-line_types-predefined_patterns%).
+
 ### Custom Patterns
 
 Ways to specify the `linetype`:
@@ -20,6 +24,8 @@ Ways to specify the `linetype`:
 
 ![Custom line types](aesthetics_custom_linetype.png)
 
+See [example notebook](%nb-aesthetics-line_types-custom_patterns%).
+
 ## Text
 
 ### Font Family
@@ -32,12 +38,16 @@ The default font family is `'sans'`.
 
 You can also use the name of any other font installed on your system (e.g. `"Times New Roman"`).
 
+See [example notebook](%nb-aesthetics-text_style-font_family%).
+
 ### Font Face
 
 ![Font faces](aesthetics_font_face.png)
 
 The default font face is `'plain'`.
 
+See [example notebook](%nb-aesthetics-text_style-font_face%).
+
 ## Color and Fill
 
 Colors and fills of geometries can be specified in the following ways:
@@ -64,4 +74,6 @@ Colors and fills of geometries can be specified in the following ways:
       </li>
   </list>
 
-- An instance of the `java.awt.Color` class.
+- An instance of the `java.awt.Color` class.
+
+See [example notebook](%nb-aesthetics-system_colors%).

Writerside/images/changelog/4.12.0/gggrid_legend_collect.png

@@ -22,6 +22,14 @@ You can pass tidy data to *Lets-Plot* in form of a Kotlin `Map`.
 
 - <a href="aesthetics.md#text">Text</a>
 
+Cookbooks:
+
+- [Point shapes](%nb-aesthetics-point_shapes%)
+- [Line types](%nb-aesthetics-line_types%)
+- [System colors](%nb-aesthetics-system_colors%)
+- [Text](%nb-aesthetics-text_style%)
+- [Overriding default grouping with the group aesthetic](%nb-group_override_defaults%)
+
 ## Basic Building Blocks
 
 Points:
@@ -59,9 +67,9 @@ Text:
 [`label`](%api_geom%/geom-label/index.html),
 [`label repel`](%api_geom%/geom-label-repel/index.html)
 
-Examples:
+Cookbooks:
 
-- [Inset map of Kotlin island](%nb-spatialdataset_kotlin_isl%)
+- [Missing values: line, path, area, and ribbon](%nb-missing_values_line_path_area_ribbon%)
 - [Drawing graph edges](%nb-graph_edges%)
 - [Formatting labels on plots](%nb-formatting_axes_etc%)
 - [Text geoms](%nb-text_geoms%)
@@ -77,6 +85,10 @@ Examples:
 - [`stroke` aesthetic](%nb-aes_stroke%)
 - [Configuring nudge units in position adjustments](%nb-position_nudge_unit%)
 
+Demos:
+
+- [Inset map of Kotlin island](%nb-spatialdataset_kotlin_isl%)
+
 
 ## Discrete
 
@@ -89,7 +101,7 @@ Examples:
 Learn more:
 <a href="as_discrete.md">Working with Categorical Variables and the <format style="bold">asDiscrete()</format> Function</a>
 
-Examples:
+Cookbooks:
 
 - [Barchart](%nb-bar%)
 - [Pie-chart](%nb-geom_pie%)
@@ -109,7 +121,7 @@ Examples:
 [`contours`](%api_geom%/geom-contour/index.html),
 [`filled contours`](%api_geom%/geom-contour-filled/index.html)
 
-Examples:
+Cookbooks:
 
 - [Contours](%nb-contours%)
 
@@ -125,7 +137,7 @@ Examples:
 [`ridgeline`](%api_geom%/geom-area-ridges/index.html),
 [`frequency polygon`](%api_geom%/geom-freqpoly/index.html)
 
-Examples:
+Cookbooks:
 
 - [Distributions](%nb-distributions%)
 - [Dotplot geometry](%nb-geom_dotplot%)
@@ -143,7 +155,7 @@ Examples:
 [`statSummary()`](%api_stat%/stat-summary/index.html),
 [`statSummaryBin()`](%api_stat%/stat-summary-bin/index.html)
 
-Examples:
+Cookbooks:
 
 - [ECDF stat](%nb-stat_ecdf%)
 - [Summary stat](%nb-stat_summary%)
@@ -154,7 +166,7 @@ Examples:
 
 [`function`](%api_geom%/geom-function/index.html)
 
-Examples:
+Cookbooks:
 
 - [Function geometry](%nb-geom_function%)
 
@@ -166,7 +178,7 @@ Examples:
 [`linerange`](%api_geom%/geom-line-range/index.html),
 [`pointrange`](%api_geom%/geom-point-range/index.html)
 
-Examples:
+Cookbooks:
 
 - [Plotting means and error ranges](%nb-error_bars%)
 - [Geometries with dual orientation](%nb-horizontal_geoms%)
@@ -176,7 +188,7 @@ Examples:
 
 [`smoothing line`](%api_geom%/geom-smooth/index.html)
 
-Examples:
+Cookbooks:
 
 - [Smoothing](%nb-geom_smooth%)
 - [Draw a scatter plot](%nb-scatter_plot%)
@@ -187,12 +199,14 @@ Examples:
 [`2d bins`](%api_geom%/geom-bin2-d/index.html),
 [`2d hexagonal bins`](%api_geom%/geom-hex/index.html),
 [`2d density`](%api_geom%/geom-density2-d/index.html),
-[`filled 2d density`](%api_geom%/geom-density2-d-filled/index.html)
+[`filled 2d density`](%api_geom%/geom-density2-d-filled/index.html),
+[`pointdensity`](%api_geom%/geom-point-density/index.html)
 
-Examples:
+Cookbooks:
 
 - [2d density](%nb-density_2d%)
 - [Hexagonal heatmap](%nb-geom_hex%)
+- [Pointdensity geometry](%nb-geom_pointdensity%)
 - [Absolute unit specification for width and height aesthetics](%nb-param_width_unit%)
 
 
@@ -202,7 +216,7 @@ Examples:
 
 See also: [Joint Plot](bistro.md#joint-plot), [Residual Plot](bistro.md#residual-plot).
 
-Examples:
+Cookbooks:
 
 - [Marginal plots](%nb-marginal_layers%)
 
@@ -239,18 +253,21 @@ This is in contrast to R's ggplot2, which provides separate "date", "time", and
 
   - `Date`
 
-Examples:
+Cookbooks:
 
 - [Scale time](%nb-scale_time%)
 - [Plotting time series](%nb-time_date_datetime%)
+
+Demos:
+
 - [Bitcoin daily trend visualization](%nb-trading_chart%)
 
 
 ## Images
 
 [`geomImshow()`](%api_geom%/geom-imshow.html)
 
-Examples:
+Cookbooks:
 
 - [`geomImshow()`](%nb-image_101%)
 - [The `extent` parameter](%nb-image_extent%)
@@ -266,7 +283,7 @@ Examples:
 [`coordFlip()`](%api_coord%/coord-flip.html),
 [`coordMap()`](%api_coord%/coord-map.html)
 
-Examples:
+Cookbooks:
 
 - [Flipped coordinates](%nb-coord_flip%)
 - [Polar coordinate system](%nb-coord_polar%)
@@ -279,7 +296,7 @@ Examples:
 [`guides()`](%api_scale%/guides.html),
 [`layerKey()`](%api_scale%/layer-key.html)
 
-Examples:
+Cookbooks:
 
 - [Legend customization](%nb-legend%)
 - [Manual legend](%nb-manual_legend%)

Writerside/images/changelog/4.12.0/group_override_defaults.png

@@ -32,7 +32,7 @@ The *Lets-Plot* library recognizes the following three 2D-geometry types:
 
 These shapes can be plotted using various geometry layers that depend on the type of the shape:
 
-- Points : [`geomPoint`](%api_geom%/geom-point/index.html), [`geomText`](%api_geom%/geom-text/index.html), [`geomLabel`](%api_geom%/geom-label/index.html), [`geomPie`](%api_geom%/geom-pie/index.html)
+- Points : [`geomPoint`](%api_geom%/geom-point/index.html), [`geomText`](%api_geom%/geom-text/index.html), [`geomLabel`](%api_geom%/geom-label/index.html), [`geomPointDensity`](%api_geom%/geom-point-density/index.html), [`geomPie`](%api_geom%/geom-pie/index.html)
 - Lines : [`geomPath`](%api_geom%/geom-path/index.html)
 - Polygons : [`geomPolygon`](%api_geom%/geom-polygon/index.html), [`geomMap`](%api_geom%/geom-map/index.html). [`geomRect`](%api_geom%/geom-rect/index.html) when used with Polygon shapes displays corresponding bounding boxes.
 

Writerside/images/changelog/4.12.0/missing_values_ribbon.png

@@ -5,24 +5,28 @@
 - [`facetGrid()`](%api_facet%/facet-grid.html) - split data by one or two variables that vary in the X and/or Y direction.
 - [`facetWrap()`](%api_facet%/facet-wrap.html) - split data by one or more variables with extra flexibility.
 
-Examples:
+Cookbooks:
 
 - [Multipanel plots with facets](%nb-facets%)
 
 ## `ggbunch`
 
 - [`ggbunch`](%api_lets_plot%/ggbunch.html) - create a collection of plots that can have arbitrary location and size.
 
-Examples:
+Cookbooks:
 
-- [Inset map of Kotlin island](%nb-spatialdataset_kotlin_isl%)
 - [The `ggbunch()` function](%nb-ggbunch%)
 
+Demos:
+
+- [Inset map of Kotlin island](%nb-spatialdataset_kotlin_isl%) 
+
 ## `gggrid`
 
 - [`gggrid`](%api_lets_plot%/gggrid.html) - combines several plots on one figure, organized in a regular grid.
 
-Examples:
+Cookbooks:
 
 - [The `gggrid()` function](%nb-plot_grid%)
-- [Sharing X,Y-axis scale limits](%nb-gggrid_scale_share%)
+- [Sharing X,Y-axis scale limits](%nb-gggrid_scale_share%)
+- [Collecting guides in gggrid()](%nb-gggrid_legend_collect%)

Writerside/topics/aesthetics.md

@@ -12,7 +12,7 @@
 [`guideColorbar()`](%api_scale%/guide-colorbar.html),
 [`guides()`](%api_scale%/guides.html)
 
-### Examples
+### Cookbooks
 
 - [Themes overview](%nb-themes%)
 - [Default theme](%nb-default_theme%)
@@ -34,7 +34,7 @@
 
 [`minimal2`](%api_theme%/theme-minimal2.html),
 [`bw`](%api_theme%/theme-b-w.html),
-[`grey`](%api_theme%/theme-grey.html),
+[`grey`](%api_theme%/theme-grey.html) (or [`gray`](%api_theme%/theme-gray.html)),
 [`classic`](%api_theme%/theme-classic.html),
 [`light`](%api_theme%/theme-light.html),
 [`minimal`](%api_theme%/theme-minimal.html),
@@ -45,7 +45,7 @@
     <img alt="All predefined themes" src="complete_themes.png" style="block"/>
 </a>
 
-### Predefined Themes Examples
+### Predefined Themes Cookbooks
 
 - [Default theme](%nb-default_theme%)
 - [Themes overview](%nb-themes%)
@@ -62,13 +62,14 @@
 [`solarized light`](%api_theme%/flavor-solarized-light.html),
 [`solarized dark`](%api_theme%/flavor-solarized-dark.html),
 [`high contrast light`](%api_theme%/flavor-high-contrast-light.html),
-[`high contrast dark`](%api_theme%/flavor-high-contrast-dark.html)
+[`high contrast dark`](%api_theme%/flavor-high-contrast-dark.html),
+[`standard`](%api_theme%/flavor-standard.html)
 
 <a href="%nb-geom_theme_colors%">
     <img alt="Theme colors for geometries" src="flavors.png" style="block"/>
 </a>
 
-### Flavors Examples
+### Flavors Cookbooks
 
 - [Theme flavors](%nb-theme_flavors%)
 - [Themes overview](%nb-themes%)