A holistic microclimate model

You are here: Technical Model Webpage » Defining Alias MYALIAS.DAT

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
defining_alias_myalias.dat [2012/06/30 13:26] – 134.93.180.188defining_alias_myalias.dat [2012/08/11 02:41] – [How are Alias defined?] marenlie
Line 1: Line 1:
 ====== Defining Alias MYALIAS.DAT ====== ====== Defining Alias MYALIAS.DAT ======
-\\ + 
-**What are Alias?**+===== What are Alias? ======
  
 Alias are keywords that can be used instead of directory names. Whenever ENVI-met expects information about the location of a certain file, an alias can be used instead of typing the complete path to that file. Alias are keywords that can be used instead of directory names. Whenever ENVI-met expects information about the location of a certain file, an alias can be used instead of typing the complete path to that file.
 In older versions, alias have already been used in ENVI-met to point for example to the default input (alias=[INPUT]) or the output (=[OUTPUT]) directory. From version 3.1 on, you are able to define your own list of alias. In older versions, alias have already been used in ENVI-met to point for example to the default input (alias=[INPUT]) or the output (=[OUTPUT]) directory. From version 3.1 on, you are able to define your own list of alias.
  
-//When installing ENVI-met, you are asked to select a database folder. This is the place where you should store your simulation files. The alias for this default folder is [PROJECTS].//+**When installing ENVI-met, you are asked to select a database folder. This is the place where you should store your simulation files. The alias for this default folder is [PROJECTS].**\\
 This is a system-internal folder and it is not stored in the ''MYALIAS.DAT'' file. If you need to change the location of the [PROJECTS] alias, you need to edit ENVIMET.ini in the ENVI-met program folder. This is a system-internal folder and it is not stored in the ''MYALIAS.DAT'' file. If you need to change the location of the [PROJECTS] alias, you need to edit ENVIMET.ini in the ENVI-met program folder.
-\\ + 
-\\ + 
-\\ +===== What are the Benefits? =====
-**What are the benefits?**+
  
 In former ENVI-met version, all of the directories used in a simulation had to be given in an explicit way.\\ In former ENVI-met version, all of the directories used in a simulation had to be given in an explicit way.\\
Line 18: Line 17:
  
 Using the new alias concept, you define one or more individual alias for each simulation project and then just use the alias name in your configuration file. If you change the structure on your computer, you just have to update the alias definition and all the files keep working. If you use different computers, your directories can be stored wherever you want. You just have to take care of the alias definition file to point ENVI-met to the correct folders. Using the new alias concept, you define one or more individual alias for each simulation project and then just use the alias name in your configuration file. If you change the structure on your computer, you just have to update the alias definition and all the files keep working. If you use different computers, your directories can be stored wherever you want. You just have to take care of the alias definition file to point ENVI-met to the correct folders.
-\\ 
-\\ 
-\\ 
-**How are alias defined?** 
  
-Alias are defined in the global file ''MYALIAS.DAT'' which is located in the ''\sys.basedata'' folder of ENVI-met. This file is loaded when ENVI-met is executed.If you change data in ''MYALIAS.DAT'' while ENVI-met is running, you have to update the data manually. + 
-//Also you have to re-load your configuration file if it uses one of the changed alias.//  +===== How are Alias defined? ===== 
 + 
 +Alias are defined in the global file ''MYALIAS.DAT'' which is located in the ''\sys.basedata'' folder of ENVI-met. This file is loaded when ENVI-met is executed.If you change data in ''MYALIAS.DAT'' while ENVI-met is running, you have to update the data manually.\\ 
 +**Also you have to re-load your configuration file if it uses one of the changed alias.**  
  
 ''MYALIAS.DAT'' is a simple text file that can be opened and edited with any ASCII text editor. It might look like this: ''MYALIAS.DAT'' is a simple text file that can be opened and edited with any ASCII text editor. It might look like this:
    
  <file>  <file>
- 01:*[area1]=c:\simulation\area1 + 01: *[area1]=     c:\simulation\area1 
- 02:*[trees]=d:\envimet\trees_in_streets + 02: *[trees]=     d:\envimet\trees_in_streets 
- 03:[trees_out]=[trees]\output + 03: [trees_out]=  [trees]\output 
- 04:*[Co2]=d:\envimet sim\CO2 impact + 04: *[Co2]=       d:\envimet sim\CO2 impact 
- 05:[co2_input]=[co2]\input + 05: [co2_input]=  [co2]\input 
- 06:[co2_output]=[co2]\output+ 06: [co2_output]= [co2]\output
  (...)</file>  (...)</file>
  
 Basically, you type in the alias you want to use in a project in square brackets "[..]" followed by "=" plus the path to the assigned folder. Although it is possible to assign folders located on other computers in a network there is a risk that file paths become unavailable during the simulation, so we do not recommend this method. Basically, you type in the alias you want to use in a project in square brackets "[..]" followed by "=" plus the path to the assigned folder. Although it is possible to assign folders located on other computers in a network there is a risk that file paths become unavailable during the simulation, so we do not recommend this method.
  
-If you place a "*" in front of the alias, it will be treated as project alias (for example line 01). Project alias will be listed in the "Active Project" drop down box on the control panel of ENVI-met (see [[here]]). Selecting a project will automatically open the correct folder for selecting files.+If you place a "*" in front of the alias, it will be treated as project alias (for example line 01). Project alias will be listed in the "Active Project" drop down box on the control panel of ENVI-met (see [[control panel - model einvironment|here]]). Selecting a project will automatically open the correct folder for selecting files.
  
 Alias can be defined recursively. For example the alias ''[trees]'' is defined in line 02 and used to define another alias ''[trees_out]'' in line 03. The order of definition does not matter as long as all alias are resolved somewhere in ''MYALIAS.DAT''. Alias can be defined recursively. For example the alias ''[trees]'' is defined in line 02 and used to define another alias ''[trees_out]'' in line 03. The order of definition does not matter as long as all alias are resolved somewhere in ''MYALIAS.DAT''.