HistoryArchive Custom Task

From OSUPDOCS
Jump to navigation Jump to search

A custom task to archive material history data in an alternate format.

Introduction

The ToArchive command options can only archive material history variables 1 through 4 for each particle. A HistoryArchive custom task provides a method to archive more history variables and also provides an alternate format for archiving history variables 1 through 4.

Task Scheduling

In scripted files, a HistoryArchive custom task is scheduled using

CustomTask HistoryArchive
Parameter archiveTime,(timeInterval)
Parameter firstArchiveTime,(firstTime)
Parameter (number)
   . . .

In XML files, this tasks is scheduled using a Schedule element, which must be within the single <CustomTasks> block:

<Schedule name='HistoryArchive'>
   <Parameter name='archiveTime'>(timeInterval)</Parameter>
   <Parameter name='firstArchiveTime'>(firstTime)</Parameter>
   <Parameter name='(number)'/>
        . . .
</Schedule>

where the first two parameters, both of which are optional, are

  • (timeInterval) - Enter the time interval (in alt time units) between saving of history data. If this parameter is omitted, the history files are written on the same steps as the [[MPM Archiving Options}particle archives]]. The one exception is that no history file is written before the first step.
  • (firstTime) - Enter the time to save the first results (in alt time units). After this time is reached, subsequent archives will be spaced by the entered (timeInterval) This parameter is ignored unless the (timeInterval) parameter is set as well. To get a history data file after the first step, enter (firstTime) of zero.

The remaining parameters each specify a (number) corresponding to a material history variable number to be included in the output files.

Output Tab-Delimited File

When this task is activated, the history data on each particle will be written to tab-delimited text files in the output results folder. The name of the file will include the archive path and will be followed by "_History_#.txt", where "#" is the step number. The file will begin with short header giving step number, step time, and column labels. Each row that follows will have data for one particle. It will include particle number, current particle position (in length units), and each requested history variable.