GROUP LABEL TO STRINGS

GROUP LABEL TO STRINGS

Let Subcommand

Convert group labels to strings.

The GROUP LABEL command can be used to convert previously read character data to group labels. Group labels are primarily used with the TIC MARK LABEL FORMAT and TIC MARK LABEL CONTENT commands.

It may sometimes be useful to convert these group labels to individual strings to permit greater flexibility in how they are used.

With this command, you define a base name. Then an integer is appended to the base name to create the individual strings. For example, if the base name is S and there are 10 values in the group label variable, this command will create the strings S1, S2, ..., S10.

Currently, a maximum of 999 strings can be created with this command.

LET <sbase> = GROUP LABEL TO STRINGS <ig>
where <sbase> is the base name for the strings to be created;
and      <ig> is a previously created group label variable name.

LET SOUT = GROUP LABEL TO STRINGS IG

The number of strings generated by this command will be saved in the internal parameter NUMSTRIN.

The total number of characters that DATAPLOT can use for storing functions and strings is set when DATAPLOT is built. The current default (11/2008) is 50,000 characters. Previous versions may set this limit at 1,000 or 10,000 characters. This limit applies to the combined number of characters for all functions and strings.

The current maximum number of names (i.e., for all parameters, variables, matrices, and functions/strings) is currently set to 50,000.

An error message will be generated if either of these limits is exceeded when running this command.

None

None

GROUP LABEL	= Create a group label variable from previously read character data or previously defined strings.
CONVERT CHARACTER	= Specify whether Dataplot READ comamnd will try to read character fields.
CHARACTER CODE	= Convert previously read character data to coded numeric values.
LET STRING	= Defines a string.
READ STRING	= Reads a string from a file.
TIC MARK LABEL FORMAT	= Specify the format for tic mark labels.
TIC MARK LABEL CONTENT	= Specify the content for tic mark labels.

Data Management

10/2011

 
set convert character on
skip 25
read draft69c.dat rank day month
.
let ig = group label month
let smonth = group label to strings ig
print smonth1 to smonth^numstrin
    

The following output is generated.

 
 FUNCTIONS--

     SMONTH1 --January
     SMONTH2 --February
     SMONTH3 --March
     SMONTH4 --April
     SMONTH5 --May
     SMONTH6 --June
     SMONTH7 --July
     SMONTH8 --August
     SMONTH9 --September
     SMONTH10--October
     SMONTH11--November
     SMONTH12--December