ecl-logo Documentation

EmeraldListLinePlot

EmeraldListLinePlot[primaryData]fig

creates a ListLinePlot of primaryData.

EmeraldListLinePlot[datasets]fig

overlays each dataset in datasets onto a single figure.

EmeraldListLinePlot[{{nestedData..}..}]fig

overlays all primaryData onto one figure, while associating the innermost data sets to one another through color.

Details

    Input
    Output
    Data Specifications Options
    Fractions Options
    Frame Options
    Grid Options
    Image Format Options
    Ladder Options
    Legend Options
    Peaks Options
    Plot Labeling Options
    Plot Range Options
    Plot Style Options
    Secondary Data Options
    General Options
    Messages
  • BadPeaksPeaks option format not recognized. Peak epilogs could not be created.
    PeakLabelsThe peak label specifications could not be associated with the peaks. For each set of peaks, please provide a list of the strings you would like to use to label the peaks.

Examples

Basic Examples  (3)

Plot a single trace:

Overlay multiple traces on one plot:

Multiple primary traces:

Additional Examples  (14)

Distributions  (2)

Data points can be distributions:

Distribution units must match other data units:

Missing Data  (8)

Null values in a coordinate list are ignored and not connected:

Null values in primary data set are ignored:

Null values in secondary data set are ignored:

Null values at top level of secondary data set skip that data entirely:

Null is also the placeholder for absent Peaks:

Secondary axis is labeled with first signal that is not completely null:

An empty plot is returned if no data is given:

Can specify secondary data without primary data:

PrimaryData  (1)

Specify additional primary data along with secondary data and legend:

Replicates  (2)

Specify replicate data:

Mixture of replicates and non-replicates:

Units  (1)

Units of associated data sets must be compatible, but do not need to be the same:

Options  (120)

AspectRatio  (2)

Specify the AspectRatio of our plot. The AspectRatio is the ratio of the height to the width:

Specify the AspectRatio of our plot. The AspectRatio is the ratio of the height to the width:

Background  (1)

Specify the background of the plot using a Color directive:

Boxes  (1)

Use swatch boxes instead of lines in the legend:

ClippingStyle  (2)

Specify how clipped values should be styled in the plot. For more information, evaluate ?ClippingStyle in the notebook:

Specify how clipped values should be styled in the plot. For more information, evaluate ?ClippingStyle in the notebook:

ColorFunction  (3)

Specify a coloring function for the lines in our plot. To see all of the built in ColorFunctions, evaluate ColorData["Gradients"] in the notebook:

Specify a coloring function for the lines in our plot. To see all of the built in ColorFunctions, evaluate ColorData["Gradients"] in the notebook:

Specify a coloring function for the lines in our plot. To see all of the built in ColorFunctions, evaluate ColorData["Gradients"] in the notebook:

ColorFunctionScaling  (1)

Specify if the coloring function should be scaled to the range of this plot:

Epilog  (1)

Epilogs explicitly specified are joined onto any epilogs created by EmeraldListLinePlot:

ErrorBars  (2)

Show error bars over averaged replicated data:

Do not show error bars over averaged replicated data:

ErrorType  (2)

Show error bars corresponding to StandardDeviation:

Show error bars corresponding to StandardError:

Filling  (4)

Fill the area above the data of the plot:

Fill the area below the data of the plot:

Fill the area between the data of the plot and the axis:

Fill the area between the data of the plot and the line y=0.3:

FillingStyle  (1)

Use FillingStyle to specify the style of the plot filling. To see more example of possible styles, evaluate ?FillingStyle in the notebook:

FractionColor  (1)

Specify fraction color:

FractionHighlightColor  (1)

Specify fractions and fraction highlights for one data:

FractionHighlights  (2)

Specify fractions and fraction highlights for one data:

Specify fractions and highlights for each data:

Fractions  (2)

Specify fractions for one data:

Specify fractions for each data:

Frame  (2)

Specify which parts of the plot's frame should be visible. Frame is specified in the format {{Left Frame, Right Frame},{Bottom Frame, Top Frame}}. In the following example, all frame borders are visible:

Specify which parts of the plot's frame should be visible. Frame is specified in the format {{Left Frame, Right Frame},{Bottom Frame, Top Frame}}. In the following example, only the left and bottom frame borders are visible:

FrameLabel  (6)

Specify frame labels for unitless data:

Override a default label:

When specifying a flat list, frame order is {bottom, left, top, right}:

When specifying a pair of lists, frame order is {{left, right},{bottom, top}}:

Must turn on top frame to see top label:

Labels are only displayed for frames that are turned on:

FrameStyle  (3)

Specify the style of the plot's frame. FrameStyle can be set to any valid graphics directive. For more information, evaluate ?FrameStyle in the notebook:

Specify the style of the plot's frame. FrameStyle can be set to any valid graphics directive. For more information, evaluate ?FrameStyle in the notebook:

Specify the style of the plot's frame. FrameStyle can be set to any valid graphics directive. For more information, evaluate ?FrameStyle in the notebook:

FrameTicks  (2)

Turn off all frame ticks:

Turn off right frame ticks:

FrameTicksStyle  (1)

Specify the style of the plot's frame ticks. FrameTicksStyle can be set to any valid graphics directive. For more information, evaluate ?FrameTicksStyle in the notebook:

FrameUnits  (1)

Specify a label and automatically append the data's units:

GridLines  (1)

Specify the grid lines of this plot. Setting GridLines->None shows no grid lines, this is the default value for GridLines. For more information, evaluate ?GridLines in the notebook:

GridLinesStyle  (1)

Specify the style of the plot's grid lines. GridLinesStyle can be set to any valid graphics directive. For more information, evaluate ?GridLinesStyle in the notebook:

ImageSize  (3)

Adjust the size of the plot:

Specify the plot size as a {width,height} pair:

Set the plot size using keywords Small, Medium, or Large:

InsetImages  (2)

Inset an image over the data trace:

Inset multiple images:

InterpolationOrder  (1)

InterpolationOrder specifes the degree of polynomial that should be used to fit data points:

Joined  (6)

If Joined->False, data points are not connected by lines:

If Joined->Automatic, data points are connected only if their x-values are monotonically increasing:

If Joined->Automatic and x-values are out of order, points are left unconnected:

Specify a Joined value for each data set:

Specify a Joined value for each data set when grouped primary data is present:

Incomplete Joined speciication is padded right with the last value:

LabelingFunction  (1)

Specify a pure function that generates labels for each point in the plot. This function should take in coordinates and return graphics primitives. For more information, evaluate ?LabelingFunction in the notebook:

LabelStyle  (1)

Specify how the plot's label should be styled. Evaluate ?LabelStyle in the notebook for more information:

Ladder  (2)

Specify ladder sizes for one data set:

Specify ladder sizes for two data sets:

Legend  (3)

Specify a legend:

Legend can be nested to match the shape of the primary input:

Legend elements can be styled:

LegendLabel  (1)

Put a label on the plot legend:

LegendPlacement  (1)

Specify legend position:

Normalize  (2)

Normalize all primary traces, and any primary epilogs, to a specified value:

Units on Normalize option must be compatible with primary data units:

PeakLabels  (3)

Directly specify the peak labels:

Provide labels for each set of peaks:

Don't include any peak labels:

PeakLabelStyle  (1)

Set the appearance of the peak label text:

Peaks  (4)

Specify peaks for one data:

Specify peaks for each data:

SecondY values get highlighted on peak mouseover:

By default any labels included in the peaks specification will be plotted:

PlotLabel  (1)

Specify the label of our plot:

PlotLabels  (2)

When multiple datasets are plotted, provide a label for each plot:

Add styling to the PlotLabels for each dataset:

PlotLayout  (1)

Use PlotLayout->"Stacked" to cumulatively sum input datasets from left to right. For a full list of possible arguments to PlotLayout, please run ?PlotLayout in the notebook:

PlotMarkers  (3)

Specify how data points on the plot should be marked:

Specify how data points on the plot should be marked:

Specify how data points on the plot should be marked:

PlotRange  (4)

Specify plot range for primary data. Units in PlotRange must be compatible with primary data units:

Can mix explicit specification with Automatic resolution:

Automatic resolution of Y-range depends on the values remaining after filtering based on X-range:

Automatic resolution of Y-range depends on the values remaining after filtering based on X-range:

PlotRangeClipping  (2)

PlotRangeClipping specifies whether graphics objects should be clipped at the edge of the region defined by PlotRange or should be allowed to extend to the actual edge of the image. In the following example, the data extends past the actual PlotRange of the image:

PlotRangeClipping specifies whether graphics objects should be clipped at the edge of the region defined by PlotRange or should be allowed to extend to the actual edge of the image. In the following example, the data is cutoff at 50, since that is the maximum x-value set by the PlotRange:

PlotStyle  (1)

Specify the style of the data to be plotted:

Prolog  (1)

Any graphics passed to the Prolog option are drawn before the plot and any epilogs created by EmeraldListLinePlot:

Reflected  (2)

Reflect data about the x-axis, but retain the original tick values:

Secondary data and epilogs also get reflected:

RotateLabel  (2)

Specify whether to rotate the label of the Y-Axis on the plot:

Specify whether to rotate the label of the Y-Axis on the plot:

Scale  (4)

Plot data using a log scale on the y-axis:

Plot data using a log scale on the x-axis:

Plot data using log scales on both x and y axes:

Negative values are excluded from a log plot:

ScaleX  (1)

Add plot range padding in the x-direction:

ScaleY  (1)

Remove the plot range padding in the y-direction:

SecondYColors  (1)

Specify colors for second-y data:

SecondYCoordinates  (3)

Specify data for second-y axis:

Specify multiple data sets for second-y axis:

Specify second-y data for multilpe primary data sets:

SecondYRange  (4)

Plot range for secondary data axis:

Plot range for all sets of secondary data:

SecondYRange can be a mixture of explicit ranges and Automatics:

Unspecified plot ranges for secondary data are padded as Automatic:

SecondYStyle  (1)

Change the style for the secondary data to dashed:

SecondYUnit  (1)

Unit for secondary data axis:

TargetUnits  (2)

Specify the desired output {x,y}-units for the plot:

EmeraldListLinePlot will fail and trigger an error message if the input data cannot be converted into the requested TargetUnits:

Tooltip  (3)

Specify tooltips for primary data:

Specify tooltips for grouped primary data:

Incomplete tooltip specification is padded with Nulls:

VerticalLine  (5)

Specify vertical line at a position:

Specify x-position and relative y-height:

Specify x-position, relative y-height, and label:

Full specification for a vertical line epilog: x-position, relative y-height, label, style__:

Specify multiple vertical lines in a list. Can mix different levels of specification detail:

Zoomable  (1)

Make the plot zoomable:

Messages  (12)

IncompatibleUnits  (4)

Incompatible units amongst primary data set:

Incompatible units amongst secondary data set:

Incompatible units in Peaks option:

Incompatible units in Fractions option:

InvalidPrimaryDataSpecification  (1)

Inconsistent dimensions in primary data specification:

InvalidSecondYSpecification  (3)

Invalid dimensions in SecondYCoordinates option:

Invalid dimensions in SecondYCoordinates option:

Invalid dimensions in SecondYCoordinates option:

MixedDataTypes  (1)

Internal helper function packetToELLP[] requires a list of objects of the same type:

NonMappableOption  (1)

When internal helper function packetToELLP[] receives listed option values with Map->True, the length of the listed options must match the length of the inputs:

NullPrimaryData  (1)

Internal helper function packetToELLP[] throws an error and returns Null if the input object has empty data fields:

PeakLabels  (1)

Label list size must match peak size:

Possible Issues  (2)

Reflected  (2)

Some display elements, such as this Polygon epilog, are not affected by the Reflected option:

Specified x-range normally when using Reflected option: