Package index

Package Information

General Information about the package

loon-package loon: loon: A Toolkit for Interactive Data Visualization and Exploration

l_web(): Open a browser with loon's R documentation webpage

l_help(): Open a browser with loon's combined (TCL and R) documentation website

Data

data

UsAndThem: Data to re-create Hans Rosling's famous "Us and Them" animation

olive: Fatty Acid Composition of Italian Olive Oils

oliveAcids: Just the Fatty Acid Composition of Italian Olive Oils

oliveLocations: Geographic location of each Italian olive growing area named in the olive data.

minority: Canadian Visible Minority Data 2006

Options

Options used by many plots

l_userOptions(): Get the names of all loon display options that can be set by the user.

l_getOptionNames(): Get the names of all loon display options

l_userOptionDefault(): Get loon's system default value for the named display option.

l_getOption(): Get the value of a loon display option

l_setOption(): Set the value of a loon display option

l_setTitleFont(): Set the title font of all loon displays

Main Plotting Functions

These are the main functions needed to create plots

l_plot_arguments: Arguments common to l_plot functions

l_plot(): Create an interactive loon plot widget

scatterplots

l_plot(): Create an interactive loon plot widget

statistical specializations

l_plot(): Create an interactive loon plot widget

l_plot_ts(): Draw a decomposed time series loon plot

histograms and barplots

l_hist(): Create an interactive histogram

l_getBinData(): Get information on current bins from a histogram

l_getBinIds(): Gets the ids of the active points in each bin of a histogram

l_binCut(): Get labels for each observation according to bin cuts in the histogram.

l_breaks(): Gets the boundaries of the histogram bins containing active points.

facetting existing loon plots

many loon plots can be facetted

l_facet(): Layout Facets across multiple panels

l_plot_arguments: Arguments common to l_plot functions

multivariate plots

l_scale3D(): Scale for 3d plotting

l_plot3D(): Create an interactive loon 3d plot widget

l_pairs(): An interactive scatterplot matrix

l_serialaxes(): Create an interactive serialaxes (parallel axes or radial axes) plot

l_navgraph(): Explore a dataset with the canonical 2d navigation graph setting

l_ng_ranges(): 2d navigation graph setup with with dynamic node fitering using a slider

l_ng_plots(): 2d navigation graph setup with with dynamic node fitering using a scatterplot matrix

all l_plot methods

l_plot(): Create an interactive loon plot widget

l_plot3D(): Create an interactive loon 3d plot widget

l_plot_arguments: Arguments common to l_plot functions

l_plot_inspector(): Create a Scatterplot Inspector

l_plot_inspector_analysis(): Create a Scatterplot Analysis Inspector

l_plot_ts(): Draw a decomposed time series loon plot

Snapshots of loon plots

Loon -> Grid

plot(<loon>): Plot the current view of any loon plot in the current device.

plot(<loongraph>): Plot a loon graph object with base R graphics

loonGrob(): Create a grid grob from a loon widget handle

grid.loon(): Create and optionally draw a grid grob from a loon widget handle

condGrob(): Create a named grob or a template grob depending on a test

l_createCompoundGrob(): For the target compound loon plot, creates the final grob from the class of the `target` and the `arrangeGrob.args`

l_get_arrangeGrobArgs(): For the target (compound) loon plot, determines all arguments (i.e. including the grobs) to be passed to `gridExtra::arrangeGrob()` so as to determine the layout in `grid` graphics.

loonGlyphGrob(): Create a grob glyph from a loon widget

loonGrob_layoutType(): A generic function used to distinguish whether only the locations of plots will be used to arrange them in a grob, or whether all arguments to `gridExtra::arrangeGrob()` will be used.

l_updateGrob() l_instantiateGrob() l_setGrobPlotView(): Instantiate a Grob

as_grid_size(): Turn a loon size to a grid size

Exporting via tcl

Alternative export to pdf, etc. via tcl and “CTRL-p”

l_export(): Export a loon plot as an image

l_export_valid_formats(): Return a list of the available image formats when exporting a loon plot

Compound plot interaction

l_facet(): Layout Facets across multiple panels

l_plot_arguments: Arguments common to l_plot functions

l_getLocations(): For the target compound loon plot, determines location (only and excluding the grobs) arguments to pass to `gridExtra::arrangeGrob()`

l_getPlots(): For the target compound loon plot, determines all the loon plots in that compound plot.

facet_grid_layout(): Layout as a grid

facet_separate_layout(): layout separately

facet_wrap_layout(): Layout as a wrap

Querying and changing the plot programmatically

Accessing and modifying loon plots and their internal states

l_redraw(): Force a Content Redraw of a Plot

l_zoom(): Zoom from and towards the center

l_size(): Query Size of a Plot Display

`l_size<-`(): Resize Plot Widget

l_resize(): Resize Plot Widget

Accessing the loon plot

l_create_handle(): Create a loon object handle

l_getFromPath(): Create loon objects from path name

l_loonWidgets(): Get all active top level loon plots.

l_basePaths(): Get the set of basic path types for loon plots.

l_compoundPaths(): Get the set of basic path types for loon plots.

Scaling plots

`l_aspect<-`(): Set the aspect ratio of a plot

l_aspect(): Query the aspect ratio of a plot

l_setAspect(): Set the aspect ratio of a plot

l_scale3D(): Scale for 3d plotting

l_scaleto_active(): Change Plot Region to Display All Active Data

l_scaleto_layer(): Change Plot Region to Display All Elements of a Particular Layer

l_scaleto_plot(): Change Plot Region to Display the All Data of the Model Layer

l_scaleto_selected(): Change Plot Region to Display All Selected Data

l_scaleto_world(): Change Plot Region to Display All Plot Data

l_getScaledData(): Data Scaling

Moving points

l_move_grid(): Arrange Points or Nodes on a Grid

l_move_halign(): Horizontally Align Points or Nodes

l_move_hdist(): Horizontally Distribute Points or Nodes

l_move_jitter(): Jitter Points Or Nodes

l_move_reset(): Reset Temporary Point or Node Locations to the x and y states

l_move_valign(): Vertically Align Points or Nodes

l_move_vdist(): Vertically Distribute Points or Nodes

Accessing and modifying loon plot states

states from “names()” are also accessible and settable via “[]”

general

names(<loon>): Get State Names of Loon Object

l_cget(): Query a Plot State

l_configure(): Modify one or multiple plot states

l_info_states(): Retrieve Information about the States of a Loon Widget

l_state_names(): Get State Names of Loon Object

l_nDimStateNames(): N dimensional state names access

linked states

l_getLinkedStates(): Query the States that are Linked with Loon's Standard Linking Model

l_setLinkedStates(): Modify States of a Plot that are Linked in Loon's Standard Linking Model

saving and reusing

l_copyStates(): A generic function to transfer the values of the states of one `loon` structure to another.

l_getSavedStates(): Retrieve saved plot states from the named file.

l_saveStates(): Save the info states of a loon plot widget in a file

Glyphs

Glyphs as point symbols in scatterplots

l_primitiveGlyphs(): The primitive glyphs available to a scatterplot or graph display

l_make_glyphs(): Make arbitrary glyphs with R graphic devices

adding glyphs

functions to add glyphs to, or delete them from, a scatterplot

l_glyph_add(): Add non-primitive glyphs to a scatterplot or graph display

l_glyph_add(<default>): Default method for adding non-primitive glyphs

l_glyph_add_image(): Add an image glyphs

l_glyph_add_pointrange(): Add a Pointrange Glyph

l_glyph_add_polygon(): Add a Polygon Glyph

l_glyph_add_serialaxes(): Add a Serialaxes Glyph

l_glyph_add_text(): Add a Text Glyph

l_glyph_delete(): Delete a Glyph

identifying glyphs

functions to add glyphs to, or delete them from, a scatterplot

l_glyph_ids(): List glyphs ids

l_glyph_getType(): Get Glyph Type

l_glyph_getLabel(): Get Glyph Label

l_glyph_relabel(): Relabel Glyph

image glyphs

creating image glyphs

l_make_glyphs(): Make arbitrary glyphs with R graphic devices

l_image_import_array(): Import Greyscale Images as Tcl images from an Array

l_image_import_files(): Import Image Files as Tk Image Objects

l_imageviewer(): Display Tcl Images in a Simple Image Viewer

glyph inspector

loon inspectors for various type of glyphs

l_glyphs_inspector(): Create a Glyphs Inspector

l_glyphs_inspector_image(): Create a Image Glyph Inspector

l_glyphs_inspector_pointrange(): Create a Pointrange Glyph Inspector

l_glyphs_inspector_serialaxes(): Create a Serialaxes Glyph Inspector

l_glyphs_inspector_text(): Create a Text Glyph Inspector

Layers

Loon plots have multiple display layers

l_layer(): Loon layers

l_layer_hide(): Hide a Layer

l_layer_show(): Show or unhide a Layer

l_layer_group(): layer a group node

l_layers_inspector(): Create a Layers Inspector

l_layer_printTree(): Print the layer tree

print(<l_layer>): Print a summary of a loon layer object

creating layers

functions to create layers of different types

l_layer_contourLines(): Layer Contour Lines

l_layer_group(): layer a group node

l_layer_heatImage(): Display a Heat Image

l_layer_line(): Layer a line

l_layer_lines(): Layer lines

l_layer_oval(): Layer a oval

l_layer_points(): Layer points

l_layer_polygon(): Layer a polygon

l_layer_polygons(): Layer polygons

l_layer_smooth(): Layer a smooth line for loon

l_layer_rasterImage(): Layer a Raster Image

l_layer_rectangle(): Layer a rectangle

l_layer_rectangles(): Layer rectangles

l_layer_text(): Layer a text

l_layer_texts(): Layer texts

l_predict(): Model Prediction

the generic l_layer function

various methods to layer particular objects on a loon plot

l_layer(): Loon layers

l_layer(<density>): Layer Method for Kernel Density Estimation

l_layer(<map>): Add a Map of class map as Drawings to Loon plot

l_layer(<Line>): Layer line in Line object

l_layer(<Lines>): Layer lines in Lines object

l_layer(<Polygon>): Layer polygon in Polygon object

l_layer(<Polygons>): Layer polygons in Polygons object

l_layer(<SpatialLines>): Layer lines in SpatialLines object

l_layer(<SpatialLinesDataFrame>): Layer lines in SpatialLinesDataFrame object

l_layer(<SpatialPoints>): Layer points in SpatialPoints object

l_layer(<SpatialPointsDataFrame>): Layer points in SpatialPointsDataFrame object

l_layer(<SpatialPolygons>): Layer polygons in SpatialPolygons object

l_layer(<SpatialPolygonsDataFrame>): Layer polygons in SpatialPolygonDataFrame

layer organization

query the layer organization

l_layer_bbox(): Get the bounding box of a layer.

l_layer_ids(): List ids of layers in Plot

l_layer_printTree(): Print the layer tree

individual layers

query an individual layer

l_layer_index(): Get the order index of a layer among its siblings

l_layer_getLabel(): Get layer label.

l_layer_relabel(): Change layer label

l_layer_getType(): Get layer type

l_layer_getChildren(): Get children of a group layer

l_layer_getParent(): Get parent layer id of a layer

l_layer_isVisible(): Return visibility flag of layer

l_layer_layerVisibility(): Returns logical value for whether layer is actually seen

l_layer_groupVisibility(): Queries visibility status of decendants

organizing and reordering layers

various methods to organize layers in a plot

l_layer_hide(): Hide a Layer

l_layer_show(): Show or unhide a Layer

l_layer_lower(): Switch the layer place with its sibling to the right

l_layer_raise(): Switch the layer place with its sibling to the left

l_layer_move(): Move a layer

l_layer_group(): layer a group node

l_layer_demote(): Moves the layer to be a child of its right group layer sibling

l_layer_promote(): Moves the layer up to be a left sibling of its parent

l_layer_delete(): Delete a layer

l_layer_expunge(): Delete a layer and all its descendants

Graph

Loon’s native graph class and connection to those of the graph package

loongraph(): Create a graph object of class loongraph

as.loongraph(): Convert a graph object to a loongraph object

as.graph(): Convert a loongraph object to an object of class graph

linegraph(): Create a linegraph

linegraph(<loongraph>): Create a linegraph of a graph

complement(): Create the Complement Graph of a Graph

complement(<loongraph>): Create the Complement Graph of a loon Graph

completegraph(): Create a complete graph or digraph with a set of nodes

graphreduce(): Make each space in a node apprear only once

l_getGraph(): Extract a loongraph or graph object from loon's graph display

ndtransitiongraph(): Create a n-d transition graph

interactive graphs

l_graph(): Generic funtction to create an interactive graph display

interactive graph switching

functions for switching between graphs in the same display

l_graphswitch(): Create a graphswitch widget

l_graphswitch_add(): Add a graph to a graphswitch widget

l_graphswitch_add(<default>): Add a graph that is defined by node names and a from-to edges list

l_graphswitch_add(<graph>): Add a graph to the graphswitch widget using a graph object

l_graphswitch_add(<loongraph>): Add a graph to the graphswitch widget using a loongraph object

l_graphswitch_delete(): Delete a graph from the graphswitch widget

l_graphswitch_get(): Return a Graph as a loongraph Object

l_graphswitch_getLabel(): Query Label of a Graph in the Graphswitch Widget

l_graphswitch_ids(): List the ids of the graphs in the graphswitch widget

l_graphswitch_move(): Move a Graph in the Graph List

l_graphswitch_relabel(): Relabel a Graph in the Graphswitch Widget

l_graphswitch_reorder(): Reorder the Positions of the Graphs in the Graph List

l_graphswitch_set(): Change the Graph shown in the Active Graph Widget

graph inspector

loon inspector for graphs

l_graph_inspector(): Create a Graph Inspector

l_graph_inspector_analysis(): Create a Graph Analysis Inspector

l_graph_inspector_navigators(): Create a Graph Navigator Inspector

Loon’s navigation graphs having two dimensional nodes and 3- or 4-d edges

l_navgraph(): Explore a dataset with the canonical 2d navigation graph setting

l_navigator_add(): Add a Navigator to a Graph

l_navigator_delete(): Delete a Navigator

l_navigator_getLabel(): Query the Label of a Navigator

l_navigator_getPath(): Get the sequence of nodes of a navigator's current path

l_navigator_ids(): List Navigators

l_navigator_relabel(): Modify the Label of a Navigator

l_navigator_walk_backward(): Have the Navigator Walk Backward on the Current Path

l_navigator_walk_forward(): Have the Navigator Walk Forward on the Current Path

l_navigator_walk_path(): Have the Navigator Walk a Path on the Graph

navigation configured based on bivariate statistical measures

l_ng_ranges(): 2d navigation graph setup with with dynamic node fitering using a slider

l_ng_ranges(<default>): Select 2d spaces with variable associated measures using a slider

l_ng_ranges(<measures>): 2d Navigation Graph Setup with dynamic node fitering using a slider

l_ng_ranges(<scagnostics>): 2d Navigation Graph Setup with dynamic node fitering based on scagnostic measures and using a slider

l_ng_plots(): 2d navigation graph setup with with dynamic node fitering using a scatterplot matrix

l_ng_plots(<default>): Select 2d spaces with variable associated measures displayed in scatterplot matrix

l_ng_plots(<measures>): 2d Navigation Graph Setup with dynamic node fitering using a scatterplot matrix

l_ng_plots(<scagnostics>): 2d Navigation Graph Setup with dynamic node fitering based on scagnostic measures and by using a scatterplot matrix

Navigators

the large ball that traverses a graph; action depends on its “context”

l_navigator_add(): Add a Navigator to a Graph

l_navigator_delete(): Delete a Navigator

l_navigator_getLabel(): Query the Label of a Navigator

l_navigator_getPath(): Get the sequence of nodes of a navigator's current path

l_navigator_ids(): List Navigators

l_navigator_relabel(): Modify the Label of a Navigator

l_navigator_walk_backward(): Have the Navigator Walk Backward on the Current Path

l_navigator_walk_forward(): Have the Navigator Walk Forward on the Current Path

l_navigator_walk_path(): Have the Navigator Walk a Path on the Graph

Contexts

contexts attach to navigators and react to their state changes

l_context_add_context2d(): Create a context2d navigator context

l_context_add_geodesic2d(): Create a geodesic2d navigator context

l_context_add_slicing2d(): Create a slicind2d navigator context

l_context_delete(): Delete a context from a navigator

l_context_getLabel(): Query the label of a context

l_context_ids(): List context ids of a navigator

l_context_relabel(): Change the label of a context

Measures

statistical measures to define navigation graphs

measures1d(): Closure of One Dimensional Measures

measures2d(): Closure of Two Dimensional Measures

scagnostics2d(): Closure of Two Dimensional Scagnostic Measures

print(<measures1d>): Print function names from measure1d object

print(<measures2d>): Print function names from measure2d object

L2_distance(): Euclidean distance between two vectors, or between column vectors of two matrices.

Colors

color_loon(): Create a palette with loon's color mapping

l_colorName(): Get Color Names from the Hex Code

l_hexcolor(): Convert color names to their 12 digit hexadecimal color representation

tkcolors(): List the valid Tk color names

hex12tohex6(): Convert 12 hexadecimal digit color representations to 6 hexidecimal digit color representations

l_colRemoveAlpha(): Convert color representations having an alpha transparency level to 6 digit color representations

loon_palette(): Loon's color generator for creating color palettes

l_getColorList(): Get loon's color mapping list

as_hex6color(): Return a 6 hexidecimal digit color representations

l_setColorList(): Use custom colors for mapping nominal values to distinct colors

l_setColorList_ColorBrewer(): Set loon's color mapping list to the colors from ColorBrewer

l_setColorList_baseR(): Set loon's color mapping list to the colors from base R

l_setColorList_ggplot2(): Set loon's color mapping list to the colors from ggplot2

l_setColorList_hcl(): Set loon's color mapping list to the colors from hcl color wheen

l_setColorList_loon(): Set loon's color mapping list to the colors from loon defaults

Inspectors

loon inspectors attachable to loon plots

l_worldview(): Create a Worldview Inspector

l_hist_inspector_analysis(): Create a Histogram Analysis Inspector

l_glyphs_inspector(): Create a Glyphs Inspector

l_graph_inspector(): Create a Graph Inspector

l_hist_inspector(): Create a Histogram Inspector

l_layers_inspector(): Create a Layers Inspector

l_loon_inspector(): Create a loon inspector

l_plot_inspector(): Create a Scatterplot Inspector

l_serialaxes_inspector(): Create a Serialaxes Inspector

Bindings and new interaction

Loon can create new interaction via a variety of bindings. Each binding has its own id and will evaluate its own user-defined callback function when it is triggered. See l_help(“learn_R_bind”)

l_after_idle(): Evaluate a function on once the processor is idle

l_currentindex(): Get layer-relative index of the item below the mouse cursor

l_currenttags(): Get tags of the item below the mouse cursor

state binding

Bindings which evaluate a callback function when certain plot states change, as specified at binding creation.

l_bind_state(): Add a state change binding

l_bind_state_get(): Get the event pattern and callback Tcl code of a state binding

l_bind_state_delete(): Delete a state binding

l_bind_state_ids(): List state binding ids

l_bind_state_reorder(): Reorder the state binding evaluation sequence

glyph binding

Bindings which evaluate a callback function for particular changes in the collection of glyphs of a display

l_bind_glyph(): Add a glyph binding

l_bind_glyph_get(): Get the event pattern and callback Tcl code of a glyph binding

l_bind_glyph_delete(): Delete a glyph binding

l_bind_glyph_ids(): List glyph binding ids

l_bind_glyph_reorder(): Reorder the glyph binding evaluation sequence

item binding

Item bindings are used for evaluating callback functions at certain mouse and/or keyboard gestures events (i.e. X events) on visual items on the canvas. Items on the canvas can have tags and item bindings are specified to be evaluated at certain X events for items with specific tags.

l_bind_item(): Create a Canvas Binding

l_bind_item_get(): Get the event pattern and callback Tcl code of a item binding

l_bind_item_delete(): Delete a item binding

l_bind_item_ids(): List item binding ids

l_bind_item_reorder(): Reorder the item binding evaluation sequence

layer binding

Bindings which evaluate a callback function for particular changes in the collection of layers of a display.

l_bind_layer(): Add a layer binding

l_bind_layer_get(): Get the event pattern and callback Tcl code of a layer binding

l_bind_layer_delete(): Delete a layer binding

l_bind_layer_ids(): List layer binding ids

l_bind_layer_reorder(): Reorder the layer binding evaluation sequence

navigator binding

Bindings which evaluate a callback function for particular changes in the collection of navigators of a display.

l_bind_navigator(): Add a navigator binding

l_bind_navigator_get(): Get the event pattern and callback Tcl code of a navigator binding

l_bind_navigator_delete(): Delete a navigator binding

l_bind_navigator_ids(): List navigator binding ids

l_bind_navigator_reorder(): Reorder the navigator binding evaluation sequence

canvas binding

Canvas bindings are triggered by a mouse/keyboard gesture over the plot as a whole. They evaluate a callback function when triggered.

l_bind_canvas(): Create a Canvas Binding

l_bind_canvas_get(): Get the event pattern and callback Tcl code of a canvas binding

l_bind_canvas_delete(): Delete a canvas binding

l_bind_canvas_ids(): List canvas binding ids

l_bind_canvas_reorder(): Reorder the canvas binding evaluation sequence

context binding

Bindings which evaluate a callback function for particular changes in the collection of contexts of a display

l_bind_context(): Add a context binding

l_bind_context_get(): Get the event pattern and callback Tcl code of a context binding

l_bind_context_delete(): Delete a context binding

l_bind_context_ids(): List context binding ids

l_bind_context_reorder(): Reorder the context binding evaluation sequence

R and TCL

functions interfacing between R and TCL

l_create_handle(): Create a loon object handle

l_getFromPath(): Create loon objects from path name

l_data(): Convert an R data.frame to a Tcl dictionary

l_widget(): Dummy function to be used in the Roxygen documentation

l_subwin(): Create a child widget path

l_toR(): Convert a Tcl Object to some other R object

l_isLoonWidget(): Check if a widget path is a valid loon widget

l_loonWidgets(): Get all active top level loon plots.

l_basePaths(): Get the set of basic path types for loon plots.

l_compoundPaths(): Get the set of basic path types for loon plots.

l_throwErrorIfNotLoonWidget(): Throw an error if string is not associated with a loon widget

l_Rlist2nestedTclList(): Convert an R list to a nested Tcl list

l_nestedTclList2Rlist(): Convert a Nested Tcl List to an R List

l_toplevel(): loon tk top level

tkcolors(): List the valid Tk color names

glyph_to_pch(): Glyph to Pch

get_font_info_from_tk(): Return Font Information

tcl_img_2_r_raster(): A tk Image Object to a Raster Object

Accessories

some handy functions to query the loon plot states

get_display_color(): Return the Displayed Color

get_layer_states(): Get Layer States

get_model_display_order(): Get the Order of the Display

char2num.data.frame(): A Character Data Frame to a Numerical Data Frame