Configuring the Output

You can use the Quick Data Source Configuration option or the Exchanger Wizard to define the ASCII output file that will be generated by the application that is triggered by the Simcode component. You then specify regions from the file that will be used to define an Isight parameter and its value.

This task shows you how to:


Before you begin: To use Quick Data Source Configuration, you must select Data Exchanger as the default parser and select the Show Quick Data Source Configuration preference (see Setting Simcode Component Preferences).

Configure the Output Using the Quick Data Source Configuration Option

You can use the Quick Data Source Configuration option to configure the output.

  1. Double-click the Simcode component icon .
    The Simcode Component Editor icon appears.
  2. From the Simcode Component Editor, select the Output tab.
  3. Click the box labeled Click here to open a new Data Source in the center of the dialog box.
    The Quick Data Source Configuration dialog box appears.
    Tip: If you want to use the Exchanger Wizard, click Advanced (see Configure the Output Using the Exchanger Wizard).
  4. In the Template File text box, enter the path to the template file, or click Browse to locate the file.
  5. Select the Line Ending:
    OptionDescription
    Default Select this option to leave the line endings as they were found in the output file. Isight does not attempt to change the line endings. If the file has to be copied for some reason, local line endings are used.
    Local Select this option to write the file with the local line endings for the computer on which the model is running. This is the location of the Isight Gateway and the SIMULIA Execution Engine station. This means CR-LF on Windows and LF on Linux. The file will always be copied in text mode and the line endings updated, even if the line endings already appear to be correct.
    Linux Select this option to always separate lines with LF, even if the model is running on Windows.
    Windows Select this option to always separate lines with CR-LF, even if the model is running on Linux.
  6. Choose the format of the file.
    OptionDescription
    General Text Use this format for text with no particular structure. Fields are located by searching for words or phrases.
    Name/Value Use this format for data organized as a list of name/value pairs, where the name is the first word on the line and there is a delimiter (space or some punctuation) between the name and the value. Fields are located by matching names. This format is used only with specially formatted data; however, it does allow the variable names to be automatically selected based on the field names.
    Table Use this format for tables and lists of numbers. Fields are identified by row number (line) and column number. This format can be used with files in any format as long as the line numbers never change; the number of entries on each line do not have to be the same. The cells in the table can be separated by delimiters (e.g., space, comma, etc.), or the table columns can be defined by absolute character position (sometimes useful for reading packed Fortran formatted data). This format allows whole columns, rows, and arrays to be read into array parameters in one action.
    Vector This format is for data organized as a list of values separated by spaces or punctuation. Fields are numbered sequentially through the whole section. This format allows one-dimensional arrays to be read in one operation. The values can span multiple lines. This option is often used for Fortran list-directed input.
  7. If you selected Name/Value as the format, you can specify a Delimiter (Space, Tab, Colon, Equal Sign).
  8. Click OK.
  9. From the Simcode Component Editor, select regions of the output file that will be used to define a parameter and its value.

    When you are configuring the output of the Simcode component, you can only read parameters from the output file.

Configure the Output Using the Exchanger Wizard

You can use the Exchanger Wizard to configure the output.

  1. Double-click the Simcode component icon .
    The Simcode Component Editor icon appears.
  2. From the Simcode Component Editor, select the Output tab.
  3. Click the box labeled Click here to open a new Data Source in the center of the dialog box.
    The Exchanger Wizard appears.
  4. Select the data source (Java String or Text File).
  5. Click Next.
    The Select Sample File screen appears.
  6. Enter the name of the local file, or click Browse to locate the file. Isight writes to this file during execution.
  7. Click Next.
    The Output Destination screen appears.
  8. Select where the data will be stored after the local file is parsed.
    OptionDescription
    Store with the Job Results Data is stored with the job results in the job database.
    Don't store the file The file cannot be mapped to other components.
    Write to a file You will need to enter the name of the file or click Browse to locate the file.
  9. Click Next.
    The File Format screen appears.
  10. Choose the format of the output file.
    OptionDescription
    General Text Use this format for text with no particular structure. Fields are located by searching for words or phrases.
    Name/Value Use this format for data organized as a list of name/value pairs, where the name is the first word on the line and there is a delimiter (space or some punctuation) between the name and the value. Fields are located by matching names. This format is used only with specially formatted data; however, it does allow the variable names to be automatically selected based on the field names.
    Table Use this format for tables and lists of numbers. Fields are identified by row number (line) and column number. This format can be used with files in any format as long as the line numbers never change; the number of entries on each line do not have to be the same. The cells in the table can be separated by delimiters (e.g., space, comma, etc.), or the table columns can be defined by absolute character position (sometimes useful for reading packed Fortran formatted data). This format allows whole columns, rows, and arrays to be read into array parameters in one action.
    Vector This format is for data organized as a list of values separated by spaces or punctuation. Fields are numbered sequentially through the whole section. This format allows one-dimensional arrays to be read in one operation. The values can span multiple lines. This option is often used for Fortran list-directed input.
  11. Click Finish to exit the Exchanger Wizard.
  12. From the Simcode Component Editor, select regions of the output file that will be used to define a parameter and its value.

    When you are configuring the output of the Simcode component, you can only read parameters from the output file.