|
| |
StampPlot provides many features for logging and saving data.
 | Logging Data
 | Automatic |
| Manual & special file types |
| Raw Logging |
|
| Logging Messages |
| Saving Plot Files
| Manual |
| Automatic |
|
| Plot Snapshots
| Manual |
| Automatic |
| Object Snapshots |
|
| Printing Plots
|
| Logging Data
StampPlot provides a variety of ways to create logs of data.
| Automatic Logging of Data
Log Menu, Log Data to File option (!SAVD), when enabled, logs
incoming analog and digital data to a file. The name of the file
by default is "SDAT.TXT". The file may be deleted
through the option menu or using the !DELD instruction. The file
is saved by default to the Data directory. The name of the file
may be changed using the !NAMD instruction, including an optional
path.
!SAVD ON/OFF
!DELD
!NAMD [path]filename.ext
!NAMD mydata.txt
!DELD
!SAVD ON
If time stamping is enabled - The clock on the button bar (!TSMP), the
date and time, and time into the plot, will precede the data. Time
stamping is enabled by default.
!TSMP ON/OFF.
Log entry:
MM/DD/YY HH:MM:SS:ss, seconds into plot, digital data, analog1,
analog2,...
Data is logged whether it is comma-separated, binary, or specially
parsed data.
Notes:
Plotting must be enabled to perform logging automatically.
The filename may be changed as desired during processing to store data
in different files (see below for more uses).
The name of the current log can be gotten from macro value (DATALOG).
'open the data file using the associated
program:
!APPA (DATALOG)
|
| Manually Logging Data & Special File Types:
Data may be manually logged to a data file using the !LOGD
instruction. Math and values will be replaced prior to
writing. If Time-Stamping is enabled, the date & time and
seconds into plot will be logged at the beginning of the entry.
'Name the log
!NAMD special.dat
'disable time stamping
!TSMP OFF
'Log a special string
!LOGD The temperature at (RTIME) was (AINVAL0)
!DELD will delete the currently named data log.
One way to use this option is to create an html file of data:
!NAMD data.htm
!DELD
!LOGD <CENTER>(RTIME)</CENTER>
!LOGD The temperature is <B>(AINVAL0)</B><BR>
!APPA (DATALOG)
Another means of creating special documents is using the !TMPL
instruction for templates.
|
| Logging raw instructions
A macro can be used to create other macros. Using the Log Raw (!LOGR)
instruction, no data replacement will occur allowing a macro to be created
and eventually ran. This could be used with objects to save data,
such as a list box contents and reload it again (saving user input
data).
!LOGR !STAT (RTIME) |
|
| Automatically Logging Messages
Messages which are logged in the Message Window may also be sent directly to
a file through use of the !SAVM instruction or under the Log
menu. The default name is SAVM.TXT and it will reside in the Data
directory. If time stamping is enabled, the message will be preceded
with date and time. The message name may be changed with !NAMM and
deleted with !DELM.
!SAVM ON/OFF
!DELM
!NAMM [path]filename
|
| Saving a Plot
| Manual Plot Saves
A plot may be manually saved and opened from the file menu. All
CURRENT data points in memory, constant drawings (@) and CURRENT plotted drawings
(^) in memory, along with any
messages in the Message Window, are saved.
The control instruction !SAVP may also be invoked in code to save the
plot. Optionally, a name may be provided. If omitted, the title
of the plot will be used, and if none, "Untitled" will be
used. .plt is automatically appended to the plot name.
!SAVP [filename]
!SAVP
!SAVP MyPlot
!SAVP c:\myplots\MyPlot
(The directory must exist)
!SAVP (PATH)MyPlot
(Saves to the current Macro directory)
If Append-Date-Time is enabled (found on the Files tab
of the Configuration Window), the date and time will be appended to the
file name to create unique names.
!APDT ON/OFF
!APDT OFF
If Save/Print/Snap Entire form is enabled, the Plot objects and layout
will also be saved. All object code will be saved EXCEPT object event
code, update values and Timers.
!FORM ON/OFF
!FORM ON
|
| Automatic Plot Saves
If the Logging menu option "Auto Save Plot File at Max" is
enabled (!ASAV), the plot will be automatically saved using the
Auto Save name (!NAMA). The extension of .plt is
automatically appended.
!ASAV ON/OFF
!ASAV ON
!NAMA filename
!NAMA MyPlot
The file is automatically saved based on the number of data points
reaching maximum (!AUTP), or the plot reaching the maximum time (!AUTT).
If set for maximum time and data points reach max first, maximum points
will take priority unless data flushing (!FLSH) is enabled.
!AUTP
!AUTT
!FLUSH ON/OFF
|
|
| Plot Snapshots
| Manual Snapshots
A snapshot of the plot screen, either the plot itself or the entire
form, may be taken and saved as a jpg image file. By default the
image is placed in Stamp Plot's Data directory, though this may be
changed using by specifying the path. The camera-snap shot toolbar
button may be used, or the !SNAP instruction.
If Appended Date-Time is enabled (!APDT ON/OFF, ON by default)),
the image name will have the data & time appended for unique names.
If Snap is used with no name, the plot title will be used. If
there is no title, the automatic save name will be used (see below).
!SNAP
If a name is given, the plot will be named that with .jpg appended.
!SNAP myplot
(PATH) is a macro value specifying the current macro directory.
!SNAP (PATH)myplot
!SNAP c:\my documents\myplot
The quality of the JPEG may be set by using the !JPGQ instruction,
where 100 is best. 80 is the default.
!JPGQ 90
NOTE: The resolution and size of the resulting JPEG is a
direct relationship to the size of the image on the screen.
To specify the that the entire form be used for images, enable
Save/Print/Snap Entire Form under the file menu, or use !FORM ON/OFF.
NOTE: To use the entire form, it MUST remain visible on the
desktop.
|
| Automatic Snap Shots
Automatic snapshots operate similarly to the plot save. The
default name for auto snapshots is ASAVE with data and time appended.
To name the automatic saves:
!NAMS filename
!NAMS run1
|
| Snapshots of Objects
Objects of plots, meters and gauges may have snapshots taken. Data
and time will be appended if enabled.
If no name is given, the object name will be used.
!POBJ objName.Snap
!POBJ objname.Snap=TempGauge |
|
| Plot Printing
| Manual Printing
Manual Printing of the plot may be perform using the Print toolbar
button, or using the !PRNT instruction. The size of the plot may
to be printed may be scaled:
!PSIZ %
!PSIZ 50
Multiple plots may be printed on a single sheet using by enabling
multiple plots
!MPRN ON/OFF
The entire form may be printed. NOTE: The entire form must remain
visible on the desktop.
!FORM ON/OFF
|
| Automatic Printing
Just as with plot saves and snapshots, the plot may be printed automatically
using !APRN ON/OFF.
Note: The quality of the print is a direct relationship to the
size of the plot on the screen.
Printing works most reliably when using the default printer.
|
|
|
