Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
faq [2016/09/27 04:02]
hermann [General]
faq [2023/08/14 17:00] (current)
admin [Performance]
Line 2: Line 2:
  
 ===== Troubleshooting =====  ===== Troubleshooting ===== 
 +\\ 
 +=== GNU/Linux === 
 +For GNU/Linux related questions, please refer to [[dinamica_linux_faq|Dinamica GNU/Linux - Frequently Asked Questions]] 
 +\\ 
 +\\
 === Question T-1 === === Question T-1 ===
  
Line 10: Line 14:
  
 Typically, this problem may occurs only on the first run of a new Dinamica EGO installation. ​ Typically, this problem may occurs only on the first run of a new Dinamica EGO installation. ​
 +\\ 
 +\\
 === Question T-3 === === Question T-3 ===
  
Line 19: Line 24:
 -Xss1m -Xss1m
 -Xms64m -Xms64m
--Xmx256m+-Xmx8096m
 </​code>​ </​code>​
  
 These values represent the maximum amount of memory available to Dinamica Graphical Interface (in megabytes). If Dinamica still not launching, lower the ''​-Xmx''​ value and try again. Only lower the value just far enough to allow Dinamica to launch, as the lower this value is, the less memory it is allowed to use. Lowering this value will not impact model execution performance but the Graphical Interface may become useless. These values represent the maximum amount of memory available to Dinamica Graphical Interface (in megabytes). If Dinamica still not launching, lower the ''​-Xmx''​ value and try again. Only lower the value just far enough to allow Dinamica to launch, as the lower this value is, the less memory it is allowed to use. Lowering this value will not impact model execution performance but the Graphical Interface may become useless.
 +\\ 
 +\\
 === Question T-4 === === Question T-4 ===
  
Line 31: Line 37:
  
 The perspective configuration file is usually stored in the folder ''​C:​\Users\<​User>​\.jydocking''​. The perspective configuration file is usually stored in the folder ''​C:​\Users\<​User>​\.jydocking''​.
 +\\ 
 +\\
 === Question T-5 === === Question T-5 ===
  
 **My Anti-Virus is telling me that Dinamica EGO is trying to open an Internet connection. Why does Dinamica EGO need access to the Internet?** **My Anti-Virus is telling me that Dinamica EGO is trying to open an Internet connection. Why does Dinamica EGO need access to the Internet?**
  
-Dinamica EGO uses an Internet connection to check for new updates. No additional information,​ other than the version of the Dinamica EGO software installed in your system, is sent.+Dinamica EGO uses an Internet connection to check for new updates ​and to access the online documentation. No additional information,​ other than the version of the Dinamica EGO software installed in your system, is sent.
  
 If you prefer, you can disable the version check disabling the "Tools => Options | System | Update"​ switch, but this is not recommended. If you prefer, you can disable the version check disabling the "Tools => Options | System | Update"​ switch, but this is not recommended.
 +\\ 
 +\\
 === Question T-6 === === Question T-6 ===
  
Line 53: Line 61:
  
 If you prefer, you can disable the auto-update disabling the "Tools => Options | System | Update"​ switch, but this is not recommended. If you prefer, you can disable the auto-update disabling the "Tools => Options | System | Update"​ switch, but this is not recommended.
 +\\ 
 +\\
 === Question T-7 === === Question T-7 ===
  
Line 59: Line 68:
  
 This error is really unusual. To help us investigate the problem, copy and send the auto update log file, named ''​app_updater_log.txt'',​ to dinamica@csr.ufmg.br. The log file is located in the folder ''​C:​\Users\<​User>​\AppData\Local\Temp\AppUpdater_DinamicaEGO''​. This error is really unusual. To help us investigate the problem, copy and send the auto update log file, named ''​app_updater_log.txt'',​ to dinamica@csr.ufmg.br. The log file is located in the folder ''​C:​\Users\<​User>​\AppData\Local\Temp\AppUpdater_DinamicaEGO''​.
 +\\ 
 +\\
 === Question T-8 === === Question T-8 ===
  
Line 67: Line 77:
  
 To prevent the occurrence of this problem, enable the UAC system on your computer. If you can not enable UAC, you may turn off the auto-update feature to workaround this issue. However, turning off the auto-update is not recommended. To prevent the occurrence of this problem, enable the UAC system on your computer. If you can not enable UAC, you may turn off the auto-update feature to workaround this issue. However, turning off the auto-update is not recommended.
 +\\ 
 +\\
 === Question T-9 === === Question T-9 ===
  
Line 76: Line 87:
 To workaround this limitation, make sure your are including only characters that are part of the English alphabet in your file names and paths. Other universal characters like ''​_'',​ ''​-''​ and white spaces can be used normally. Check the list of [[wp>​ASCII#​ASCII_printable_characters|ASCII printable characters]] for a reference. To workaround this limitation, make sure your are including only characters that are part of the English alphabet in your file names and paths. Other universal characters like ''​_'',​ ''​-''​ and white spaces can be used normally. Check the list of [[wp>​ASCII#​ASCII_printable_characters|ASCII printable characters]] for a reference.
  
 +This limitation no longer applies to Dinamica EGO version 4.0.x and newer.
 +\\
 +\\
 === Question T-10 === === Question T-10 ===
  
 **When I run my simulation/​model,​ Dinamica EGO reports an error like 'The index 12345678 is out of bounds [0, 9876543]'​. What is wrong?** **When I run my simulation/​model,​ Dinamica EGO reports an error like 'The index 12345678 is out of bounds [0, 9876543]'​. What is wrong?**
  
-You are probably using images with different geometries as part of your model. Make sure all your images have the same number of lines and the same number of columns.+You are probably using images with different geometries as part of your model in Dinamica EGO 3.0.x (or earlier versions). Make sure all your images have the same number of lines and the same number of columns.
  
 +It is worth noting that Dinamica EGO 4.0.x (and later versions) does not require input images to have the same number of lines and columns, or extents. ​
 +\\
 +\\
 === Question T-11 === === Question T-11 ===
  
Line 88: Line 105:
 First, make sure the installer is not corrupted. Also, make sure your anti-virus is not blocking the Dinamica EGO installer. First, make sure the installer is not corrupted. Also, make sure your anti-virus is not blocking the Dinamica EGO installer.
  
-When using Windows 10 or Windows 8/8.1, [[http://​windows.microsoft.com/​en-us/​windows/​smartscreen-filter-faq|Windows SmartScreen Filter]] (and some anti-virus) tends to warn the user about a potential hazard when installing Dinamica EGO. This is not cause by Dinamica itself, but simply by the fact that Dinamica EGO is not as popular as Microsoft Office or Google Chrome, so the anti-virus will flag the software as unknown or suspicious. It is safe to ignore this warnings and proceed with the installation,​ as long as you have downloaded Dinamica EGO from a reliable source, preferably from the Dinamica EGO website.+When using Windows 10 or Windows 8/8.1, [[http://​windows.microsoft.com/​en-us/​windows/​smartscreen-filter-faq|Windows SmartScreen Filter]] (and some anti-virus) tends to warn the user about a potential hazard when installing Dinamica EGO. This is not caused ​by Dinamica itself, but simply by the fact that Dinamica EGO is not as popular as Microsoft Office or Google Chrome, so the anti-virus will flag the software as unknown or suspicious. It is safe to ignore this warnings and proceed with the installation,​ as long as you have downloaded Dinamica EGO from a reliable source, preferably from the Dinamica EGO website. 
 +\\ 
 +\\ 
 +=== Question T-12 ===
  
 +**When I try to run Dinamica EGO, I get a message box that says '​Unable to load library "​JavaBinding"'​. What is wrong?**
 +
 +Installing the "​Visual C++ Redistributable for Visual Studio 2015" on your computer will fix the issue. Usually, the Dinamica EGO installer tries to install the redistributable files itself, but in case it fails, you might have to install them manually:
 +
 +Go to the [[https://​www.microsoft.com/​en-us/​download/​details.aspx?​id=48145|Microsoft website]], and click the "​Download"​ button.
 +
 +After installing this utility, try running Dinamica EGO again.
 +
 +\\
 +\\ 
 ===== Documentation ===== ===== Documentation =====
  
Line 97: Line 127:
  
 In version Dinamica 2.2 and beyond, the updated guidebook is no longer available as a pdf file. It is available now as part of the online documentation Wiki and can be found [[tutorial:​start|here]]. In version Dinamica 2.2 and beyond, the updated guidebook is no longer available as a pdf file. It is available now as part of the online documentation Wiki and can be found [[tutorial:​start|here]].
 +\\ 
 +\\
 ===== General ===== ===== General =====
  
Line 105: Line 136:
  
 For now, the software is only available in English. For now, the software is only available in English.
 +\\ 
 +\\
 === Question G-2 === === Question G-2 ===
  
Line 117: Line 149:
   - Go to the user folder, typically ''​C:​\Users\<​User>​\Documents\Dinamica EGO'',​ and copy the file ''​debug.txt''​.   - Go to the user folder, typically ''​C:​\Users\<​User>​\Documents\Dinamica EGO'',​ and copy the file ''​debug.txt''​.
   - Compact these two files in a zip file and send it to dinamica@csr.ufmg.br so we can try to find out what's causing Dinamica EGO to crash.   - Compact these two files in a zip file and send it to dinamica@csr.ufmg.br so we can try to find out what's causing Dinamica EGO to crash.
 +\\ 
 +\\
 === Question G-3 === === Question G-3 ===
  
 **Some times when I try to load a model in Dinamica EGO I get the following error message: 'The input port "<<​ some name here >>"​ is not defined.'​ What am I doing wrong?** **Some times when I try to load a model in Dinamica EGO I get the following error message: 'The input port "<<​ some name here >>"​ is not defined.'​ What am I doing wrong?**
  
-It’s probably caused by an old Dinamica EGO version. Please update Dinamica by downloading and installing the latest version from the [[http://​www.csr.ufmg.br/​dinamica/​downloads/​downloads.php|Download]] section of its website. It will likely solve your problem. +It’s probably caused by an old Dinamica EGO version. Please update Dinamica by downloading and installing the latest version from the [[http://​www.csr.ufmg.br/​dinamica/​download|Download]] section of its website. It will likely solve your problem. 
 +\\ 
 +\\
 === Question G-4 === === Question G-4 ===
  
Line 129: Line 163:
  
 It means that the use of this operator is no longer recommended as it will be eliminated in the future. Please do not use it or if used, replace this operator in existing models with new ones that perform the same function. It means that the use of this operator is no longer recommended as it will be eliminated in the future. Please do not use it or if used, replace this operator in existing models with new ones that perform the same function.
 +\\ 
 +\\
 === Question G-5 === === Question G-5 ===
  
Line 135: Line 170:
  
 Consult the info about [[log_tag_type#​log_level|Log Levels]]. Consult the info about [[log_tag_type#​log_level|Log Levels]].
 +\\ 
 +\\
 === Question G-6 === === Question G-6 ===
  
Line 147: Line 183:
   1   1
 </​code>​ </​code>​
-does not have the expected meaning. The evaluation of ''​i1 == null''​ always yields ''​null''​ because we can not use ''​null''​ as part of any algebraic expression without "​poisoning"​ its execution. To avoid that, we have to test if the value of a image is null explicitly using the operator ''​isNull''​. Based on that, the correct expression should be +does not have the expected meaning. The evaluation of ''​i1 == null''​ always yields ''​null''​ because we can not use ''​null''​ as part of any algebraic expression without "​poisoning"​ its execution. For the same reason, expressions like ''​i1 + null'',​ ''​i1 / null'',​ ''​if null then 1 else 2''​ always yields ''​null''​ as result. To avoid that, we have to test if the value of a image is null explicitly using the operator ''​isNull''​ or ''?​''​. Based on that, the correct expression should be 
 <code pascal Expression B> <code pascal Expression B>
 if isNull(i1) then if isNull(i1) then
Line 157: Line 193:
 Dinamica EGO automatically identifies the wrong expression and re-write it to better represent the user intention. Dinamica EGO automatically identifies the wrong expression and re-write it to better represent the user intention.
  
-For more information about the expression syntax see the documentation of the [[Image Expression Type]]. +For more information about the expression syntax see the documentation of the [[Image Expression Type]]. And for more information about how null values are handled during the map and value calculations see [[Image Expression Null Value Handling]]. 
 +\\ 
 +\\
 === Question G-7 === === Question G-7 ===
  
Line 164: Line 201:
  
 Consult the [[supported_map_formats|list of the supported map formats]]. ​ Consult the [[supported_map_formats|list of the supported map formats]]. ​
 +\\ 
 +\\
 === Question G-8 === === Question G-8 ===
  
Line 175: Line 213:
 If you still can't find the folder ''​Dataset'',​ you may have installed it in a different location or you may have skipped its installation while installing Dinamica EGO. We suggest you to re-install the software making sure that the option to install Dinamica EGO's Examples is checked. If you still can't find the folder ''​Dataset'',​ you may have installed it in a different location or you may have skipped its installation while installing Dinamica EGO. We suggest you to re-install the software making sure that the option to install Dinamica EGO's Examples is checked.
  
 +It is also possible to download the dataset with the examples directly without having to download and install Dinamica EGO itself: [[http://​csr.ufmg.br/​dinamica/​nui_download/​1054/​|Dataset Download]].
 +\\
 +\\
 === Question G-9 === === Question G-9 ===
  
 **How do I change the folder where Dinamica EGO stores temporary images and temporary dll libraries?​** **How do I change the folder where Dinamica EGO stores temporary images and temporary dll libraries?​**
  
-By default, Dinamica EGO uses the Windows temporary folder to store temporary images and compiled libraries. Since version 3.0.17, it is possible to define a different temporary folder independently of the definition used by Windows itself. That can be done defining a environment variable "​DINAMICA_TEMP_DIR"​ with the path for the new temporary folder. On Windows 10, go to "Start menu -> Settings -> System ​-> About | System Info Advanced system settings ​Advanced | Environment Variables | System variables",​ click on New and type "​DINAMICA_TEMP_DIR"​ as the variable name and the new temporary folder ​as the system path.+By default, Dinamica EGO uses the Windows temporary folder to store temporary images and compiled libraries. Since version 3.0.17, it is possible to define a different temporary folder independently of the definition used by Windows itself. That can be done defining a environment variable "​DINAMICA_TEMP_DIR"​ with the path for the new temporary folder. 
 + 
 +On Windows 10, go to "Start menu -> Settings -> System ​About | System Info -> Advanced system settings ​-> Advanced | Environment Variables | System variables"​. Then, click on "New" ​and type "​DINAMICA_TEMP_DIR"​ as the variable name and choose ​the new path as the variable content. 
 + 
 +\\ 
 +\\ 
 +=== Question G-10 === 
 + 
 +**How does Dinamica EGO interacts with the CSR/UFMG servers? And what kind of information does it send back when I am running the software on my computer?​** 
 + 
 +  * From time to time it sends a request to our servers checking if user has the latest version of the software. If he/she does not have it, it will download an update and apply it. The user is free to turn off the automatic update checking which will prevent any version checking from being performed. Bear in mind that, when checking for updates, the only information sent to our servers is the current version of the Dinamica software running on the computer. No other information that could potentially be used to identify the user or even the computer is ever sent! 
 +  
 +  * The user can send data to our servers by accessing the "​[[submodels|submodel]]"​ repository on the application or by downloading "​[[submodels]]"​ from our server. All those actions have to be explicitly started by the user. When checking the "​[[submodels|submodel]]"​ repository, the user receives a list of "​[[submodels]]"​ available for download. If the user decides to install one of the "​[[submodels]]"​ from the list, a file is downloaded and placed in the user's ''​%localappdata%\Dinamica EGO X''​ folder (where X is Dinamica EGO's major version number), so it can be used by the software. 
 + 
 +  * When browsing a model, and clicking on the "?"​ button on the action bar, the user will access an online wiki page from our servers with the documentation of the given functor/​operator. This is just a standard request for an static page (e.g. http://​www.csr.ufmg.br/​dinamica/​dokuwiki/​doku.php?​id=calc_cost_map),​ and it does not send any information that could be used to identify the user or the computer.
  
 ===== License ===== ===== License =====
Line 187: Line 242:
 **I’m interested in purchasing Dinamica EGO software for using it in my dissertation. How can I do that?** **I’m interested in purchasing Dinamica EGO software for using it in my dissertation. How can I do that?**
  
-Dinamica EGO is a [[http://​csr.ufmg.br/​dinamica/​license|free for scientific, commercial and non-commercial use]]. Go to the [[http://​www.csr.ufmg.br/​dinamica/​download|Download]] section of this website and get it. It includes everything you need to get it started (guidebook and examples ​files).+Dinamica EGO is a [[http://​csr.ufmg.br/​dinamica/​license|free for scientific, commercial and non-commercial use]]. Go to the [[http://​www.csr.ufmg.br/​dinamica/​download|Download]] section of this website and get it. It includes everything you need to get it started (file examples).
  
  
Line 197: Line 252:
  
 There isn't any mechanism for automatic calibrating those values in Dinamica EGO. In case you don't want to use trial and error we recommend using a different software like [[http://​www.umass.edu/​landeco/​research/​fragstats/​fragstats.html | Fragstats]] to calculate the parameters. There isn't any mechanism for automatic calibrating those values in Dinamica EGO. In case you don't want to use trial and error we recommend using a different software like [[http://​www.umass.edu/​landeco/​research/​fragstats/​fragstats.html | Fragstats]] to calculate the parameters.
 +\\ 
 +\\
 === Question C-2 === === Question C-2 ===
  
Line 213: Line 269:
  
 However, it is possible to workaround this limitation calculating a different transition matrix for every year using crude rates instead of net rates. The model [[variable_time_step_net_transition_rates]] and submodel [[Calc Net Transition Rates]] available as part of the standard Dinamica EGO distribution use that technique. However, it is possible to workaround this limitation calculating a different transition matrix for every year using crude rates instead of net rates. The model [[variable_time_step_net_transition_rates]] and submodel [[Calc Net Transition Rates]] available as part of the standard Dinamica EGO distribution use that technique.
 +\\ 
 +\\
 === Question C-3 === === Question C-3 ===
  
Line 219: Line 276:
  
 See [[http://​csr.ufmg.br/​dinamica/​2015/​09/​22/​validation/​|this post]] from Dinamica website about validation. See [[http://​csr.ufmg.br/​dinamica/​2015/​09/​22/​validation/​|this post]] from Dinamica website about validation.
 +\\ 
 +\\
 ===== Performance =====  ===== Performance ===== 
  
Line 227: Line 285:
  
 See [[Useful Tips|"​Useful Tips: Increasing performance"​]]. See [[Useful Tips|"​Useful Tips: Increasing performance"​]].
 +\\ 
 +\\
 === Question P-2 === === Question P-2 ===
  
 **How much memory (RAM) is Dinamica EGO able to handle?** **How much memory (RAM) is Dinamica EGO able to handle?**
  
-On Windows 64 (Vista 64, 7 64, 8 64 and 10 64), Dinamica EGO is limited by the amount of memory that you have in your system. So, if you are using Dinamica on a 64 Gigabyte computer, Dinamica will be able to use all memory available, if necessary. +Dinamica EGO is limited by the amount of memory that you have in your system. So, if you are using Dinamica on a 64 Gigabyte computer, Dinamica will be able to use all memory available, if necessary.| 
- +\\ 
-On Windows 32 Bits (Vista 32, 7 32, 8 32 and 10 32), Dinamica EGO is limited by Windows Operating System memory policies (~2 Gigabytes per process), no matter how much memory you have installed in your system. However, Dinamica is a "​LargeAddressAware"​ application,​ so it is possible to increase the amount of memory used in a 32 bit arquiteture to ~3 Gigabytes following the instructions available [[ http://​usa.autodesk.com/​adsk/​servlet/​ps/​dl/​item?​siteID=123112&​id=9583842&​linkID=9240617|here]]. //Beware that changing the Windows memory partition policy can have some unpredicted consequences.//​ Being a a "​LargeAddressAware"​ application also means that the 32 bit version of Dinamica is able to handle ~4 Gigabytes when running on a 64 bit Windows Operating System. +\\
 === Question P-3 === === Question P-3 ===
  
Line 242: Line 300:
 You can try some solutions: You can try some solutions:
  
-  * Run Dinamica EGO 64 in a //Windows 10/​8/​7/​Vista 64-bit// ​environment ​and add //much more// ​memory ​to your computer. Do not use a Windows 32-bit environment to run your simulations;+  * Run Dinamica EGO in environment ​with as much memory ​as possible;
  
-  * Make sure the flag Disable Raster Map Swapping in Tools|Options|Advanced ​is //​unchecked//​. If your are using the Console Launcher, you will have to edit the model configurations. Unchecking this flag degrades performance,​ but uses less memory;+  * Set the memory management option ("Tools" -> "Options" ​"Advanced") to "​Balanced"​. If your are using the command line tool, you will have to use the option "-memory-allocation-policy"​ with value 1;
  
   * Reduce the number of lines and columns in your maps;   * Reduce the number of lines and columns in your maps;
Line 254: Line 312:
  
    
-===== Usage ===== 
- 
-=== Question U-1 === 
- 
-**Console Launcher output window only shows the last messages produced by model execution. Is there any way to see the complete model output?** 
- 
-In the folder where the model is been executed, there is a complete log file written by the Console Launcher with the model name. It allows the Console to run several models at the same folder one after another without discarding the previous output logs. 
- 
-Clicking on the "Show More" on the Console Launcher Output panel, it is possible to see a list of output log of models that have completed the execution and are available for inspection. 
  
 ===== Models =====  ===== Models =====