SUBMIT Blossom Statistics Command File to Blossom Session

The SUBMIT command causes Blossom to read commands from an input file rather than the command line. The command line syntax for the SUBMIT command is:

        SUBMIT filename

where filename is the filename of the file containing Blossom commands to be executed.

In this way, "programs" can be submitted to Blossom for carrying out long or repetitive analyses or to exactly repeat an analysis already performed. An ASCII text file containing any valid Blossom commands can be submitted. The STATUS and SHELL commands are of little use with the SUBMIT command, however the comment command (' or ", see below) is useful for documenting analyses called for in the submit file. It is possible to copy the BLOSSOM.LOG to another file, edit it, save it as a submit file, and submit the modified file. The command:

        >SUBMIT SUBWAY

causes Blossom to process the set of commands in submit command file SUBWAY. If the submitted file has other than the "SUB" file extension then its complete name must be specified. If the file has the default extension (SUB), it need not be specified.

In the Console version, the command SUBMIT without a file specification produces a list of files with the SUB extension. The desired file can then be specified.

In the Windows version a "Submit Command File" dialog box can be invoked from the Blossom menu bar selection "Use/Submit Files | Submit Command File", or from the"Submit Command File" button on the toolbar, or with the SHIFT+F2 Function Key. A drop-down selection listing of submit files (files with the extension SUB) or all files in the local folder can be obtained.

Advanced SUBMIT Operations with Program Arguments and DOS Batch Files

Both the Windows and Console versions of Blossom can be invoked from a DOS Batch file. If the last command of a submitted command file is QUIT, control returns to the batch file for further processing.

For example, the two Blossom command submit files:

    ' File: sub1.sub
    output subtest1
    use bgrouse
    mrpp dist elev * sex
    quit

and

    ' File: sub2.sub
    output subtest1
    use mrbp.dat
    mrpp spp1 spp2 spp3 * trtmt * block
    quit

can be invoked from a batch file called BATWIN.BAT:

     REM File: batwin.bat
     REM Run two blossom submit files
     REM Windows version
     blossom submit sub1
     blossom submit sub2

When the BATWIN.BAT is invoked, Blossom starts and the SUB1.SUB file is submitted for processing. When that is finished, the SUB2.SUB file is submitted for processing. Control is then returned to the system. The resultant SUBTEST1.OUT output file looks like this:

 ======================================================================



                  Multi-Response Permutation Procedure (MRPP)

 Data Used
             Data File: BGROUSE.DAT
     Grouping Variable: SEX
    Response Variables: DIST, ELEV

 Specification of Analysis
    Number of observations: 21
          Number of groups: 2
         Distance exponent: 1.000000000000000
          Weighting factor: n(I)/sum(n(I)) = C(I) = 1

 Group Summary
   Group Value                 Group Size  Group Distance
   3.000000000000000                    9  1.072146525258270
   4.000000000000000                   12  1.396438929704272

 Variable Commensuration Summary
    Variable Name             Average Distance (Euclidean if V=1)
    DIST                      9264.761904761905
    ELEV                      279.2285714285715

 Results
    Delta Observed = 1.257456470655986
    Delta Expected = 1.512563363155316
    Delta Variance = 0.002706187555240923
    Delta Skewness = -2.097589827330834

                Standardized test statistic = -4.903918527376526
                   Probability (Pearson Type III) of a
                     smaller or equal delta = 0.002983168009908485


 ======================================================================



 Multi-Response Permutation Procedure for Blocked Data (MRBP)

 Data Used
             Data file: MRBP.DAT
     Grouping Variable: TRTMT
     Blocking Variable: BLOCK
    Response Variables: SPP1, SPP2, SPP3

 Specification of Analysis
    Number of observations: 18
          Number of groups: 6
          Number of blocks: 3
         Distance exponent: 1.000000000000000

 Group Summary
   Group Value                 Group Size
   1.000000000000000                    3
   2.000000000000000                    3
   3.000000000000000                    3
   4.000000000000000                    3
   5.000000000000000                    3
   6.000000000000000                    3

 Block Alignment Summary
   Block Value               Variable Name             Alignment Value
   1.000000000000000         SPP1                      6.500000000000000
                             SPP2                      3.165000000000000
                             SPP3                      2.170000000000000
   2.000000000000000         SPP1                      9.914999999999999
                             SPP2                      1.165000000000000
                             SPP3                      2.665000000000000
   3.000000000000000         SPP1                      6.250000000000000
                             SPP2                      1.915000000000000
                             SPP3                      2.415000000000000

 Variable Commensuration Summary
    Variable Name             Average Euclidean Distance
    SPP1                      7.601503267973862
    SPP2                      3.106928104575162
    SPP3                      0.9005882352941186

 Results
    Delta Observed = 1.785190971554857
    Delta Expected = 1.980491196233544
    Delta Variance = 0.02093173163716452
    Delta Skewness = -0.3897419356412425

             Agreement measure among blocks = 0.09861201355002502
                Standardized test statistic = -1.349895544421471
                   Probability (Pearson Type III) of a
                     smaller or equal delta = 0.09499298021013625

In a similar fashion, the DOS batch file BATCON.BAT

    REM File: batcon.bat
    REM Run two blossom submit files
    REM Console version
    conblos submit sub1
    conblos submit sub2

invokes the Console version of Blossom using the same submitted command files as above and produces identical results.

If the last command in the submitted command file is QUIT, control returns to the operating system prompt. With this in mind, a DOS Batch file can be created that invokes several submit files in succession. With the DOS change directory (CD) commands, a session could process several folders of data by running one Batch file.