SWITCH_DATABASE
This command is for the TABULATE_REACTION (TAB) module.
By default, the TAB module always automatically retrieves thermodynamic data for substances or reactant/product substances in a defined reaction, or for pure phases or ideal solution phases, from the SSUB Substances database. However, you can select thermodynamic data for complex non-ideal solution phases from another database, which is possible with this command.
|
Syntax |
switch_database |
|
Prompt |
Database /XYZ/: <new database name> Specify a If an appropriate database name is not given and the Use one of these databases:
|
This command switches (or changes) from the current database to a new one, and reinitializes the entire TAB module for defining a substance or reaction and the GIBBS workspace for storing retrieved data. All the directly connected databases as predefined by the original database initiation file tc_initd.tdb are listed by pressing the <Enter> key without giving any argument. You can also supply your own database by giving the argument USER and then the database name and, if it is not located in the current working directory, its correct path.
This command (when required to use another database for subsequent tabulations) must be used before executing the TAB commands TABULATE_SUBSTANCE for substances, and ENTER_REACTION or TABULATE_REACTION for reactions.
When a predefined database or an appropriate USER database is switched on, the DATA command GET_DATA is automatically executed.
DATABASE NAME: The new database is specified by typing the abbreviation given in the front of one of the available predefined databases. For convenience when switching/appending databases you can add them to the predefined database list in the database initiation file tc_initd.tdb of your installed software.
When this command is used in a macro (*.TCM) file, if the USER option is selected, the database setup file name (*setup.TDB) containing the setup definitions of the user database, and its correct path, must be provided.
If a USER database name or its path is not given on the same line of the SWITCH_DATABASE command, or if it is incomplete or incorrect, an Open window displays to specify the filename of the database setup file name (*setup.TDB) of the to-be-switched USER database.
Unlike in the TDB module, if a user database is chosen, the Gibbs energy system is also reinitialized and only data from the user databases are retrieved for tabulations.
After this command, those commands to define systems (in terms of either elements or species), to reject/restore phases or species, retrieve data, as well as to append data from additional database(s), can be done.