Content Comparison

At this section we would like to answer some important questions about scripting in jBEAM.

Table of Contents

minLevel	1
maxLevel	7

Graphs

How to set the size/position of a graph?

You can set the size/position of a graph very easy with the following lines:

Code Block

// the graph
UniversalCurveGraph u2DGraph = ... // create or get graph
// size values
int graphWidth = 500;
int graphHeight = 400;
// sets position and size
u2DGraph.setScreenBounds(0, 0, graphWidth, graphHeight);

How to make a graph modifyable?

Code Block
// the graph UniversalCurveGraph u2DGraph = ... . . . // makes the graph modifyable in jBEAM u2DGraph.setModifyable(true);

How to make a graph moveable?

Code Block
// the graph UniversalCurveGraph u2DGraph = ... . . . // makes the graph moveable u2DGraph.setMoveable(true);

How to make a graph growable/resizeable?

Code Block
// the graph UniversalCurveGraph u2DGraph = ... . . . // makes the graph resizeable u2DGraph.setGrowable(true);

How to make a graph printable?

Code Block
// the graph UniversalCurveGraph u2DGraph = ... . . . // makes the graph printable -> important for PDF-Export u2DGraph.setPrintable(true);

How to show the legend of a graph?

Code Block
// the graph UniversalCurveGraph u2DGraph = ... . . . // to show the legend u2DGraph.getLegende().setVisible(true);

How to set the name of a graph?

Code Block
// the graph UniversalCurveGraph u2DGraph = ... . . . // set title of the graph u2DGraph.getTitle().setName("Example");

Curves

How to create a curve and how to add it to an existing graph?

If you want to create an new curve and add it to an existing graph, you have to do the following steps:

Code Block

// the graph
UniversalCurveGraph u2DGraph = ...
.
.
.
// create a new XY_Curve
XY_Curve curve = new XY_Curve(u2DGraph);
// sets the input data to the curve
curve.setYInputChannel(<inputDataObject>);
// adds curve to the graph
u2DGraph.addCurve(curve);
// redraw the graph to apply the change
u2DGraph.redraw();

How to change the color of a curve?

If you want to change the color of your curve, you can easily do this with the following line:

Code Block
XY_Curve curve = new XY_Curve(graph); . . . // get the line object of the curve and sets the new color (here Color.RED) on it curve.getLine().setColor(Color.RED);

How to change the thickness of a curve?

If you want to change the thickness of your curve, you can easily do this with the following line:

Code Block
XY_Curve curve = new XY_Curve(graph); . . . // get the line object of the curve and sets the new thickness (here 2.0) on it curve.getLine().setWidth(2.0);

How to change the fill color of a curve?

If you want to change the fill color of your curve, you can easily do this with the following line:

Code Block
XY_Curve curve = new XY_Curve(graph); . . . // enables the fill mode curve.getLine().setFilled(true); // sets the fill color curve.getLine().setFillColor(.GREEN);

How to set colored markers to the curve?

If you want to set colored markers to your curve, you can easily do this with the following line:

Code Block
XY_Curve curve = new XY_Curve(<graph>); . . . // to activate the marker curve.setWithMarker(true); // set the color of the markers curve.getMarker().setColor(.RED);

How to change the type of the markers?

If you want to change the type of the markers of a curve, you do this with the following lines:

Code Block

.
.
.
// to activate the marker
curve.setWithMarker(true);
// change the type of the marker
curve.getMarker().setType(CurveMarker.X_MARKER);
/* further possible marker types:
 X_MARKER
 CIRCLE_MARKER
 PLUS_MARKER
 RECT_MARKER
 RECT_VER_LIN_MARKER
 CIRCLE_VER_LIN_MARKER
 CIRCLE_FILLED_MARKER
 RECT_FILLED_MARKER
 STAR_MARKER
 DBLCROSS_MARKER
 Y_MARKER
 MAX_MARKER_TYPES 
*/

How to delete a curve from a graph?

If you want to delete an existing curve from a graph, you have to do the following steps.

Use deleteCurve() to delete a specific curve:

Code Block
UniversalCurveGraph u2DGraph = ... XY_Curve curve = new XY_Curve(u2DGraph); . . . u2DGraph.deleteCurve(curve)

Or use removeAllCurves() to delete all existing curves from a graph:

Code Block
UniversalCurveGraph u2DGraph = ... XY_Curve curve = new XY_Curve(u2DGraph); . . . u2DGraph.removeAllCurves();

Channels

How to get the channel length of the read data channel?

If you want to get the length of a channel, you can use the following line:

Code Block
DoubleChannel anc = new DoubleChannel(jD); . . . // get the UsedSize (count of elements) of the channel anc.getUsedSize();

How to get access to individual measured data within a channel?

If you want to get or set an individual valueof a channel, you should use the following ways:

Code Block

DoubleChannel anc = new DoubleChannel(jD);
.
.
.
// get the length of the channel
anc.getUsedSize();
.
.
.
// gets the value at a given index
int index = 0;
double value = anc.getValue(index);
.
.
.
int index = 5;
double newValue = 2.5;
// sets a value at a specific index
anc.setValue(index, newValue);

How to get the value for a given time value?

Because jBEAM uses delta x and x-offset to describe the time structure of its channels it is very easy to get a value of any data channel by just providing the time value:

Code Block
double timeValue = 100; // get value at 100s int index = (timeValue - offsetX) / deltaX; // or simply use the channel method int index = channel.getIndexForXValue(timeValue);

If you use independent channels this can be a little bit trickier:

Code Block

double timeValue = 100; // get value at 100s
int index;
if (channel.getIndependentChannel() != null)
 index = channel.getIndependentChannel().getIndexForValue(timeValue); // get index for 100s from independent channel
else
 index = channel.getIndexForXValue(timeValue); // get index for 100s from value channel
myChannel.getValue(index); // access the value at 100s

How to set the DeltaT for QuantumX-measurements?

Because jBEAM-QuantumX measurement module for B-firmware before December 2017 doesn't set DeltaT it can be useful to set DeltaT later during postprocessing. The following script sets the DeltaT for all channels in QuantumX measurement module:

Code Block

List<? extends jbComponentIF> components = jB.getComponentManager().getComponentsByType(jbComponentIF.MM_HBM_QuantumX);
if (!components.isEmpty()) {
 com.AMS.jBEAM.MM_HBM_QuantumX component = (com.AMS.jBEAM.MM_HBM_QuantumX) components.get(0);
 final jbDataObjectIF[] resultObjects = component.getResultObjects();
 final List<AbstractNumericChannel> foundResultChannels = new ArrayList<>();
 for (com.AMS.hbm.devicecomponents.SyncSignal signal : component.getSelectedSignals()) {
  final String signalName = signal.getSignalName() != null ? signal.getSignalName() : "null";
  foundResultChannels.clear();
  for (jbDataObjectIF resultObject : resultObjects) {
   if (resultObject instanceof AbstractNumericChannel && resultObject.getName() != null) {
    if (resultObject.getName().endsWith(signalName)) {
     foundResultChannels.add(resultObject);
    }
   }
  }
  if (foundResultChannels.isEmpty()) {
   throw new IllegalStateException("Cannot found result object for the selected signal: " + signalName);
  } else if (foundResultChannels.size() > 1) {
   throw new IllegalStateException("It is impossible to uniquely determine the resulting channel by the signal name: " + signalName);
  } else {
   AbstractNumericChannel timeChannel = foundResultChannels.get(0).getExplicitXChannel(false);
   if (timeChannel != null && !foundResultChannels.contains(timeChannel)) {
    foundResultChannels.add(timeChannel);
   }
  }
  final double outputRate = 1 / signal.getOutputRate();
  for (AbstractNumericChannel channel : foundResultChannels) {
   channel.setDelX(0, outputRate);
  }
 }
}

Miscellaneous

jBEAM freezes during executing script

One posibility to prevent this is to activate the Checkbox “Script configures user interface” before launching the script. Activate this option, if the script manipulates the user interface (e.g. buttons, graphical controls, graphs).

Otherwise the script may cause the application to freeze. If the checkbox is selected, the script is executed within the Java UI Thread.

Image Removed

Image Added

How to start an existing measure automatically over an extern script?

If you want to start a measure automatically by an extern script you have to do the following thing before:

create a project with a measure modul with a trigger (e.g. Adam 6000 with a time trigger)

save the created project

write a batch file, which starts jBEAM with the project and the script as parameter:

Code Block
@echo off cd jBEAM java -Xmx1024m -jar jBEAM.jar -ProjectfileURL="../measure.jbs" -ScriptURL="../script_ADAM.groovy" pause

write the script you want to run after jBEAM startup:

Code Block

jbMeasurementServiceIF measurementService = jB.getMeasurementService();
TriState clearValuesBeforeMeasure = measurementService.getClearValuesBeforeMeasure();
measurementService.setClearValuesBeforeMeasure(TriState.YES); // suppress confirm dialog
measurementService.startMeasure();
measurementService.setClearValuesBeforeMeasure(clearValuesBeforeMeasure);

If you execute the batch file, jBEAM starts and loads the project. After the project is loaded the script runs automatically and starts the measure in the project.

How to start an existing measure automatically over an intern script?

If you want to start a measure automatically by an intern script you have to do the following thing before:

create a project with a measure modul with a trigger (e.g. Adam 6000 with a time trigger)

create a script with the Scripting component editor and save it in your project:

Code Block

jbMeasurementServiceIF measurementService = jB.getMeasurementService();
TriState clearValuesBeforeMeasure = measurementService.getClearValuesBeforeMeasure();
measurementService.setClearValuesBeforeMeasure(TriState.YES); // suppress confirm dialog
measurementService.startMeasure();
measurementService.setClearValuesBeforeMeasure(clearValuesBeforeMeasure);

save the created project with the integrated script

write a batch file, which starts jBEAM with the project as parameter:

Code Block
@echo off cd jBEAM java -Xmx1024m -jar jBEAM.jar -ProjectfileURL="../measure.jbs" -Script="StartMeasureScript" pause

If you execute the batch file, jBEAM starts and loads the project. After the project is loaded the script in the project runs automatically and starts the measure in the project.

How can I connect to a (SQL-)Database using scripts?

To enable database access you need to provide a special connector library to jBEAM on startup. The library for Mircosoft SQLServers can be downloaded here. Please download and extract the zipfile into the jBEAM-library folder (mostly C:\Program Files\jBEAM\lib or %APPDATA%\jBEAM\lib). jBEAM will now load the database connection library automatically on startup.
To connect and select some data from the database you may use the Java JDBC connection standard API shown in this small example:

Code Block

mport java.sql.*;
 
// load the connection class
Class.forName("net.sourceforge.jtds.jdbc.Driver");
// create a new connection using a standard jdbc connection string
Connection connection = DriverManager.getConnection("jdbc:jtds:sqlserver://localhost:1433/MyServerInstance;user=MyUser;password=MyPassword");
// now we can create statements and select data from the database
Statement statement = connection .createStatement();
if (statement.execute("SELECT * FROM MyTable")) {
 ResultSet resultSet = statement.getResultSet();
 if (resultSet.next()) {
  // access result set here
 }
}

Links

In order to learn more about scripting in jBEAM visit the scripting tutorials.

Version	Old Version 2	New Version 3
Changes made by	Lutz Klabuhn	Lutz Klabuhn
Saved on	Aug 17, 2023	Aug 17, 2023

Versions Compared

Key

Graphs

How to set the size/position of a graph?

How to make a graph modifyable?

How to make a graph moveable?

How to make a graph growable/resizeable?

How to make a graph printable?

How to show the legend of a graph?

How to set the name of a graph?

Curves

How to create a curve and how to add it to an existing graph?

How to change the color of a curve?

How to change the thickness of a curve?

How to change the fill color of a curve?

How to set colored markers to the curve?

How to change the type of the markers?

How to delete a curve from a graph?

Channels

How to get the channel length of the read data channel?

How to get access to individual measured data within a channel?

How to get the value for a given time value?

How to set the DeltaT for QuantumX-measurements?

Miscellaneous

jBEAM freezes during executing script

How to start an existing measure automatically over an extern script?

How to start an existing measure automatically over an intern script?

How can I connect to a (SQL-)Database using scripts?

Links