Execute project

Execute

After saving a project at the top of the project page a new button appears: Execute button. Just clicking this button the randomization and simulation process immediately starts.
The time of the process depends on the number of simulations: it can run even more days in case of large number of repetition. The process can be followed on the project page:

  • Project start time - immediately after starting
  • Project end time - only the whole process is finished
  • Successfully completed - how many percents are successfully finished
  • Error/Unknown - how many percents are finished with error
  • Project status - see it below

Project status

Each project have a status field which is automatically created and changed. The project status can be checked on project page or on the list of projects (in menu).

  • planned: the project saved, but not executed
  • in progress: the project is running
  • closed: the project has finished
  • aborted: error occured
  • in use: if project is used to calculation (e.a. SA)
  • data removed: the project directory is deleted

Link to the result directory

If the project starts a new directory is created, this is the project directory. You can see it by clicking Link to the result directory link. While the project is running, you can watch this directory but it is unnecesseary.

List of files in the result directory

Created before simulation:

  • tsat.txt: displays the station of process
  • *.zip: the input and ini files of 10 simulations (it is deleted during process)
  • *randinput.zip: ranomization data of 10 simulations (it is deleted during process)
  • output_parameters, status, submitted (binary files, text editors cannot read it)
  • job directories (36 chars long): contain the initialization and randomization data of 10 simulations (*.zip and *randinput.zip files)

Created by simulation:

  • in job directories: bbgc_out.tar.gz - the tarred results of 10 simulations
  • *_var.png: generated images from the results
  • report.pdf: a summary created from simulation annual results

The tarred results depend on the output set: which output types were selected. The results can be ASCII or binary files (also depending on the output set).

If simulation failed

There are many reasons of project error:

  • error in the BBGCDB system
    result: nothing happens or aborted project status
  • incompatible inputs or wrong input files
    result: the project has directory but there is not any results, or empty results in it
  • other

It is useful in finding the error to check project status and results in job directory bbgc_out.tar.gz, mainly spinup.log or output.log. If you can not find out what happened, contact the system maintainer.