NEWS | R Documentation |
A new set of functions has been created to easily export figures that should fit in a document.
The five functions are pdf_fit
, png_fit
, jpeg_fit
, tiff_fit
and bmp_fit
.
First, if needed, you set the geometry of your document with setFplot_page
. Defaults to US-letter and *normal* margins => this is used to deduce the size the figures will take in the document.
When using pdf_fit
, instead of providing the height and width of the figure in absolute terms, you provide the fraction of the text-width the figure should take, and the target font-size at which the plotting text should be rendered. The size of the plotting text, once the figure is in the final document, is guaranteed.
Use fit.off
instead of dev.off
to close the device and you will get the exported graph displayed in the viewer pane! No need to open your file to see whether the export is proper, you have it automatically done!
plot_distr
New function setFplot_distr
to set most default values of the function plot_distr
.
plot_distr
MAJOR CHANGE NOT RETRO COMPATIBLE: complete overhaul of the formula. Now the main argument 'fml' is of the form weights ~ var | moderator
(before it was var ~ moderator | weights
). Allows to use one-sided formulas.
Argument tick_5
becomes at_5
and can take three values: FALSE, "roman" or "line". It is used to inform on the index of the bars by adding a small Roman number under every 5 bars (at_5 = "roman"
), or drawing a thick axis line every 5 bars (at_5 = "line"
). The default depends on the types of the data.
When fractions are displayed on top of the bars, very low numbers are now trucated (avoids having to display too small numbers).
The name of the moderator is now displayed in the yaxis when appropriate for within distributions.
Legend titles are now always displayed by default.
You can display the distribution for several weights at the same time.
Argument mod.method
has been revamped. It's meaning has been split: mod.method
takes values in "side", "split" or "stack" and two new arguments within
and total
have been created to define whether the distribution should be within each moderator or over the total distribution.
The argument trunc.method
now takes the values "auto", "right" and "mid" (instead of "auto", "trimRight" and "trimMid").
The size of the bottom and left margins are now automatically adjusted so the text always fit.
Argument mod.select
now supports regular expressions.
New argument mod.NA
which display the distribution of missing values.
plot_lines
You can display the trend for several variables at the same time => they will be treated as moderators.
One sided formulas are accepted.
Argument mod.select
now supports regular expressions.
New argument mod.NA
which display the distribution of missing values.
plot_box
You can display several variables at once (long overdue!).
Better error-handling with dreamerr's functions.
[plot_lines] Bug when plotting frequencies with moderators.
[plot_box] Bug regarding the display of the outliers when the cases are of type factor.
[plot_distr] Bug when the variable was of type logical.
[fplot] Bug when the moderator was loigical.
max_line => line.max
tick_5 => at_5 (and is much better implemented)
maxFirst => sorted
onTop => top
addOther => other
maxBins => nbins
toLog => log
Better adjustment of the legend height.
[plot_distr] Bug when the weight contained NAs. Now fixed.
Package fixest
is removed from help files and called conditionnaly in the vignette.
plot_distr: A new method for displaying moderators: mod.method = "stack".
plot_distr: A new argument "cumul" to represent cumulative distributions.
mod.method = "splitXX"
is now supported with logarithmic data
mod.method = "splitXX"
+ toLog=TRUE
: now supports the "other" column.
labels.tilted=TRUE
now possible with logarithmic data.
when onTop != "none", very small numbers are not displayed any more (could lead to cluttering).
when onTop can also be equal to FALSE.
Now discrete ticks appear when plotting categorical data. They appear every 5/10 bins, in order to help counting the bins.
better labeling of the y-axis when yaxis.num = TRUE
.
better automatic finding of the number of bins when argument bin was not missing.
better algorithm to find the default bin.size.
when bin.size is given, toLog's default is automatically set off.
Argument mod.select introduced to easily select moderator cases.
When smoothing_window > 1, supplemental years are removed.
Data on US publications in biology is removed.
Data on US publications in economics is added (much lighter than biology publications).
yaxis.num = TRUE
in the presence of moderators could cause problems in special cases.
Display problem when mod.method = "splitxx"
and factor variables.
Display problem when mod.method = "sidexx"
and with the other columns (problem in the bar cutting).
plot_distr: with moderators and mod.method = "sideWithin": rare bug corrected (identical values could be considered different).
Argument bin
becomes bin.size
.
in argument mod.method
, the value within
and total
become sideWithin
and sideTotal
.
This package is an effort to provide a simple class of plotting functions which: i) perform common operations in exploratory analyses, ii) have a compact syntax thanks to formulas, allowing aggregate/conditional/weighted graphs with minimum effort, iii) provide automatic options setting to best fit the data, iv) have a nice looking layout, and v) always take advantage of the full plotting region (without changing the graphical parameters) to export beautiful graphs with no/minimum tweak.