Merge pull request #16 from SASPAC/dev

The BasePlus package [ver. 1.24.2]

README.md

@@ -48,7 +48,7 @@ libname NEW "%workPath()/new";
 ```
 and more.
 
-SHA256 digest for the latest version of `BasePlus`: F*B297440903337E1AE6F12A6001B80B8AB743079847D16D63DF1C649AE51AA411
+SHA256 digest for the latest version of `BasePlus`: F*2A4F3953EC56DB914024457F74286D565C23DCF220FF151040BDB704FD8DDB06
 
 [**Documentation for BasePlus**](./baseplus.md "Documentation for BasePlus")
 

baseplus.md

@@ -67,7 +67,7 @@
   
 ---
 
-# The BasePlus package [ver. 1.24.0] <a name="baseplus-package"></a> ###############################################
+# The BasePlus package [ver. 1.24.2] <a name="baseplus-package"></a> ###############################################
 
 The **BasePlus** package implements useful
 functions and functionalities I miss in the BASE SAS.
@@ -336,10 +336,10 @@ Package contains additional content, run:  %loadPackageAddCnt(BasePlus)  to load
 or look for the baseplus_AdditionalContent directory in the Packages fileref
 localization (only if additional content was deployed during the installation process).
 
-* SAS package generated by generatePackage, version 20230411 *
+* SAS package generated by generatePackage, version 20230520 *
 
 The SHA256 hash digest for package BasePlus: 
-`F*B297440903337E1AE6F12A6001B80B8AB743079847D16D63DF1C649AE51AA411` 
+`F*2A4F3953EC56DB914024457F74286D565C23DCF220FF151040BDB704FD8DDB06` 
 
 ---
 # Content description ############################################################################################
@@ -3112,13 +3112,17 @@ The basic syntax is the following, the `<...>` means optional parameters:
  <,xLabels=>
  <,catLabelPos=> 
  <,xLabelPos=>
+ <,catLabelAttrs=>
+ <,xLabelAttrs=>
  <,formated=>
  <,y2axis=>
  <,y2axisLevels=>
  <,y2axisValueAttrs=>
  <,xaxisValueAttrs=>
  <,xaxisTickstyle=>
-
+ <,sganno=>
+ <,odsGraphicsOptions=>
+ <,sgPlotOptions=>
 
  <,VSCALE=>
  <,KERNEL_K=>
@@ -3160,7 +3164,7 @@ The basic syntax is the following, the `<...>` means optional parameters:
                          granularity level, e.g. for data with value 
                          around `1e-8` should be decreased. 
 
-* `rainDropSiz`        - *Optional*, default value `5px`.
+* `rainDropSize`       - *Optional*, default value `5px`.
                          Size of data points in the "rain" plot.
 
 * `boxPlotSymbolSize`  - *Optional*, default value `8px`.
@@ -3203,11 +3207,19 @@ The basic syntax is the following, the `<...>` means optional parameters:
                          Indicates position of the label on data axix (horizontal).
                          Allowed values are `LEFT`, `CENTER`, `DATACENTER`, and `RIGHT`.
 
+* `catLabelAttrs`      - *Optional*, default value is empty. 
+                         List of attributes for group axix labels (vertical).
+                         For details see notes below.
+
+* `xLabelAttrs`        - *Optional*, default value is empty. 
+                         List of attributes for data variable axix labels (horizontal).
+                         For details see notes below.
+
 * `formated`           - *Optional*, default value `0`.
                          Indicates if values of the grouping variable should be formated.
 
 * `y2axis`             - *Optional*, default value `1`.
-                         Indicates if the righ vertical axix should be displayed.
+                         Indicates if the right vertical axix should be displayed.
 
 * `y2axisLevels`       - *Optional*, default value `4`.
                          Indicates if the number of expected levels of values printed 
@@ -3224,6 +3236,19 @@ The basic syntax is the following, the `<...>` means optional parameters:
                          Allowed values are `OUTSIDE`, `INSIDE`, `ACROSS`, and `INBETWEEN`. 
                          *For SAS previous to* **9.4M5** *set to missing!*
 
+* `sganno`             - *Optional*, default value is empty.
+                         keeps name of a data set for the `sganno=` option
+                         of the SGPLOT procedure.
+
+* `sgPlotOptions`      - *Optional*, default value is `noautolegend noborder`.
+                         List of additional options values for SGPLOT procedure.
+
+* `odsGraphicsOptions` - *Optional*, default value is empty.
+                         List of additional options values for `ODS Graphics` statement.
+                         By default only the: `width=`, `height=`, and `antialiasmax=`
+                         are modified.
+
+
 ***Stat related options***:
 
 * `VSCALE`             - *Optional*, default value `Proportion`.
@@ -3264,6 +3289,9 @@ The basic syntax is the following, the `<...>` means optional parameters:
 * The `catLabels` and `xLabels` should be quoted comma separated lists enclosed with brackets, 
   e.g. `catLabels=("Continent of Origin", "Car Type")`, see Example below.
 
+* The `catLabelAttrs` and `xLabelAttrs` should be space separated lists of `key=value` pairs,
+  e.g. `xLabelAttrs=size=12 color=Pink weight=bold`, see Example below.
+
 * Kernel density estimates and basic statistics are calculated with `PROC UNIVARIATE`.
 
 * Plot is generated by `PROC SGPLOT` with `BAND`, `SCATTE`, and `POLYGON` plots.
@@ -3345,6 +3373,7 @@ The output:
   , y2axisLevels=3
   , catLabels=("Continent of Origin", "Car Type")
   , xLabels="Invoice, [$]"
+  , xLabelAttrs=size=12 color=Pink weight=bold
   )
 
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -3354,6 +3383,60 @@ The output:
 ![Example 2b](./baseplus_RainCloudPlot_Ex2b.png)
 
 
+
+**EXAMPLE 3.** Rain Cloud plot with formatted groups
+               and annotations.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~sas
+
+  data annotation; 
+    function="text";
+    label="This graph is full(*ESC*){sup '2'} of annotations!";
+    drawspace="graphpercent";
+    rotate=30;
+    anchor="center";
+    textsize=32;
+    x1=50;
+    y1=50;
+    textcolor="red"; 
+    justify="center";
+    textweight="bold";
+    width=100;
+    widthunit="percent";
+  run; 
+
+  proc format;
+    value system
+    1="Windows"
+    2="MacOS"
+    3="Linux"
+    ;
+  run;
+
+  data test;
+    do system = 1 to 3;
+      do i = 1 to 50;
+        x = rannor(123)/system;
+        output;
+      end;
+    end;
+    format system system.;
+  run;
+
+
+  %RainCloudPlot(test, system, x
+  , colorslist=CX88CCEE CX44AA99 CX117733
+  , formated=1
+  , sganno=annotation
+  , sgPlotOptions=noborder
+  , WidthPX=1000
+  , HeightPX=320
+  )
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The output:
+![Example 3](./baseplus_RainCloudPlot_Ex3.png)
+
 ---
 
 ## >>> `%zipLibrary()` macro: <<< <a name="ziplibrary-macro"></a> #######################