GAMBIT - How do I convert my GAMBIT journal file to work in a newer GAMBIT release


My journal file does not work in the current release of GAMBIT. How do I migrate my existing journal file to this release?
Entities are typically identified by their name, but may also be found by referring to their centroid (via the LOC2ENT function) or the relative time they were created (via the RETLABEL function). See a description of each function on the following page:

LOC2ENT: <a target=_blank href="http://www.fluentusers.com/gambit/doc/ori/html/users_guide/ug0b.htm#loc2ent">http://www.fluentusers.com/gambit/doc/ori/html/users_guide/ug0b.htm#loc2ent</a>http://www.fluentusers.com/gambit/doc/ori/html/users_guide/ug0b.htm#loc2ent

RETLABEL: <a target=_blank href="http://www.fluentusers.com/gambit/doc/ori/html/users_guide/ug0b.htm#retlabel">http://www.fluentusers.com/gambit/doc/ori/html/users_guide/ug0b.htm#retlabel</a>http://www.fluentusers.com/gambit/doc/ori/html/users_guide/ug0b.htm#retlabel

The conversion of an existing journal to these formats may be accomplished automatically by first setting the GAMBIT default GUI.GENERAL.JOURNAL_ENTITY to 1 for the RETLABEL format and to 2 for the LOC2ENT format. Simply re-run the journal after setting this default and the resulting journal will be in the desired format. This process can also be automated by adding:

default set "GUI.GENERAL.JOURNAL_ENTITY" numeric 1
or
default set "GUI.GENERAL.JOURNAL_ENTITY" numeric 2

to the top of the existing journal file and then running in batch mode:

Run the new journal file to ensure that all volumes are created and meshed as before, and that all entities are created successfully.

A couple notes:

- the LOC2ENT function has no way of discriminating between multiple entities with the same centroid, so RETLABEL may be a more reliable starting point.
- a journal file in this format is very general, and may also be used to migrate a journal to a previous version of GAMBIT as well





Show Form
No comments yet. Be the first to add a comment!