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 [2017/12/08 03:26]
admin [Troubleshooting]
faq [2026/07/29 14:58] (current)
hermann [General]
Line 1: Line 1:
 ====== Frequently Answered Questions====== ====== Frequently Answered Questions======
  
-===== Troubleshooting ​=====  +===== GNU/​Linux ​===== 
-\\ +
-=== GNU/Linux ===+
 For GNU/Linux related questions, please refer to [[dinamica_linux_faq|Dinamica GNU/Linux - Frequently Asked Questions]] For GNU/Linux related questions, please refer to [[dinamica_linux_faq|Dinamica GNU/Linux - Frequently Asked Questions]]
-\\ + 
-\\ +===== Installation and Startup ===== 
-=== Question ​T-1 ===+ 
 +=== Question ​I-1 ===
  
 **After installing Dinamica EGO it shows only a blank screen with a toolbar and a menubar. What is wrong?** **After installing Dinamica EGO it shows only a blank screen with a toolbar and a menubar. What is wrong?**
  
-To workaround ​the problem, open Dinamica EGO, goes to the //Window// menu and choose the //Reset Window Layout// item. Thenclose Dinamica EGO and start it again. Dinamica EGO should display the correct layout on the next run.+To work around ​the problem, open Dinamica EGO, go to the //Window// menuand choose the //Reset Window Layout// item. Then close Dinamica EGO and start it again. Dinamica EGO should display the correct layout on the next run.
  
-Typically, this problem ​may occurs ​only on the first run of a new Dinamica EGO installation.  +Typically, this problem ​only occurs on the first run of a new Dinamica EGO installation. 
-\\ + 
-\\ +=== Question ​I-===
-=== Question ​T-===+
  
 **Dinamica EGO will not start because it says 'Could not create the Java virtual machine'​. What is wrong?** **Dinamica EGO will not start because it says 'Could not create the Java virtual machine'​. What is wrong?**
  
-Edit the file ''​Dinamica.vmoptions''​ located in the Dinamica EGO installation folder using a raw text editor (like notepad ​or [[http://​notepad-plus-plus.org|notepad++]]). The content of the original file can be seen below:+Edit the file ''​Dinamica.vmoptions''​ located in the Dinamica EGO installation folder using a plain text editor (like Notepad ​or [[https://​notepad-plus-plus.org|Notepad++]]). The content of the original file can be seen below:
 <​code>​ <​code>​
 -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 the Dinamica ​graphical interface ​(in megabytes). If Dinamica still isn'​t ​launching, lower the ''​-Xmx''​ value and try again. Only lower it just far enough to allow Dinamica to launch ​— the lower this value is, the less memory ​the interface ​is allowed to use. Lowering this value doesn'​t ​impact model execution performancebut the graphical interface ​may become ​unusable
-\\ + 
-\\ +=== Question ​I-===
-=== Question ​T-===+
  
-**Dinamica EGO will not start because it says '​Unable to deserialize perspectives from XML'. What is wrong?​** ​+**Dinamica EGO will not start because it says '​Unable to deserialize perspectives from XML'. What is wrong?**
  
-Probably, the perspective file used to store the layout of the graphical interface is corrupted. To workaround ​this issue, remove the folder containing the perspective configuration and restart the application.+The perspective file used to store the layout of the graphical interface is probably ​corrupted. To work around ​this issue, remove the folder containing the perspective configuration and restart the application.
  
 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 === 
  
-**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?**+=== Question I-4 ===
  
-Dinamica EGO uses an Internet connection to check for new updates and to access the online documentationNo additional information,​ other than the version of the Dinamica EGO software installed in your system, is sent.+**Dinamica EGO does not install on my computerWhen I click on the Dinamica EGO installernothing happens. What is wrong?**
  
-If you preferyou can disable ​the version check disabling the "Tools => Options | System | Update"​ switch, but this is not recommended. +Firstmake sure the installer ​is not corruptedAlso, make sure your anti-virus is not blocking the Dinamica EGO installer.
-\\ +
-\\ +
-=== Question T-6 ===+
  
-**My Anti-Virus is telling me that Dinamica EGO is trying to download some files to my computerWhy does Dinamica EGO need to download new files?**+Windows Defender (and some anti-virus software) tends to warn the user about a potential hazard when installing ​Dinamica EGO. This isn't caused by Dinamica itself — it's simply that Dinamica EGO isn't as widely used as software like Microsoft Office or Google Chrome, so anti-virus tools flag it as unknown or suspicious. It's safe to ignore these warnings and proceed with the installation,​ as long as you've downloaded Dinamica EGO from a reliable source, preferably the Dinamica EGO website.
  
-Since version 2.0, Dinamica EGO has an auto-update feature, so it automatically downloads patches to upgrade the version installed in your system to the newest version. This makes the update process easier and less disruptive.+=== Question I-5 ===
  
-It works this way:+**When I try to run Dinamica EGO, I get a message box that says '​Unable to load library "​JavaBinding"'​. What is wrong?**
  
-  - Every time a new version is available, Dinamica EGO automatically downloads ​the corresponding patches in the background. The patches are stored in the user temp folder. +Installing ​the "​Visual C++ Redistributable for Visual Studio"​ on your computer will fix the issue. The Dinamica EGO installer usually installs ​the redistributable files automatically,​ but if that fails, you may need to install them manually:
-  - When all file were downloadedDinamica EGO asks you to restart the application. +
-  - The patches are applied and the new version becomes available.+
  
-If you prefer, you can disable ​the auto-update disabling the "​Tools ​=> Options ​System | Update" ​switch, but this is not recommended. +Go to the [[https://​learn.microsoft.com/​en-us/​cpp/​windows/​latest-supported-vc-redist?​view=msvc-170|Microsoft website]] and click "Download."
-\\ +
-\\ +
-=== Question T-7 ===+
  
-**After an update, Dinamica EGO shows a message like '​Dinamica failed to auto update'​What should I do?**+After installing this utilitytry running ​Dinamica EGO again.
  
-This error is really unusual. To help us investigate the problemcopy and send the auto update log filenamed ''​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''​. +===== UpdatesSecurityand Privacy ​=====
-\\ +
-\\ +
-=== Question T-8 ===+
  
-**Dinamica EGO asked me to restart the application and now it is stuck in a loop repeatedly showing a dialog saying '​Dinamica EGO will now ask for Administrator permission'​. What is wrong?**+=== Question U-1 ===
  
-The Windows [[wp>​User_Account_Control|User Access control (UAC)]] system ​is disabled on your computer. When UAC is disabled, ​Dinamica EGO can not open a special system dialog to ask the user for administrator privileges in order to proceedThis dialog also allows the user to cancel ​the pending update and run the version already installed.+**My anti-virus ​is telling me that Dinamica EGO is trying to open an Internet connectionWhy does Dinamica EGO need access ​to the Internet?**
  
-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 issueHowever, turning off the auto-update is not recommended. +Dinamica EGO uses an Internet connection to check for new updates and to access ​the online documentation. No information other than the version ​of the Dinamica EGO software installed ​on your system is sent — see question U-2.
-\\ +
-\\ +
-=== Question T-9 ===+
  
-**Dinamica EGO is reporting that 'The file X does not exist',​ but I am sure file X is thereWhat is wrong?**+If you prefer, you can turn off this version check by disabling "Tools => Options | System | Update,"​ though this is not recommended.
  
-There is a bug in the current Dinamica EGO version preventing the software from loading and writing maps, Weight of Evidence coefficient files and CSV tables if the file name or its path include some non-[[wp>​ASCII|ASCII]] characters such as ''​ç'',​ ''​ã'',​ ''​ê''​ and ''​ü''​.+=== Question U-2 ===
  
-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. +**How does Dinamica EGO interact with the CSR/UFMG servers? What kind of information does it send back while I'm running ​the software?**
-\\ +
-\\ +
-=== Question T-10 ===+
  
-**When I run my simulation/​modelDinamica EGO reports ​an error like 'The index 12345678 ​is out of bounds [09876543]'​What is wrong?**+  ​From time to timeit sends a request to our servers checking whether the user has the latest version of the software. If not, it downloads and applies ​an update. ​The user is free to turn off automatic update checkingwhich prevents any version checking from happening at allThe only information ever sent to our servers during this check is the current version of the Dinamica software running on the computer — nothing that could be used to identify the user or the computer is ever sent.
  
-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.+  * Users can send data to our servers by accessing the "​[[submodels|submodel]]"​ repository within the application, ​or by downloading "​[[submodels|submodels]]"​ from our serverBoth actions ​have to be explicitly started by the user. When browsing the "​[[submodels|submodel]]"​ repository, the user sees a list of "​[[submodels|submodels]]"​ available for download; installing one downloads a file into 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.
  
-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 +  * When browsing a model and clicking the "?"​ button on the action bar, the user opens an online wiki page with documentation for that functor or operator — for instance, [[Calc Cost Map]]This is just a standard request for a static page and doesn'​t send any information that could identify ​the user or the computer.
-\\ +
-\\ +
-=== Question T-11 ===+
  
-**Dinamica EGO does not install on my computer. When I click on the Dinamica EGO installer, nothing happens. What is wrong?**+===== Runtime Errors and Crashes =====
  
-First, make sure the installer is not corrupted. Also, make sure your anti-virus is not blocking the Dinamica EGO installer.+=== Question R-1 ===
  
-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 reliable sourcepreferably from the Dinamica EGO website. +**When I'm running ​simulation model, Dinamica EGO closes without showing any error messageWhat should I do?**
-\\ +
-\\ +
-===== Documentation =====+
  
-=== Question D-1 ===+  ​Open Dinamica EGO with administrator privileges, using "Run As Administrator."​ 
 +  - Open the model and run it. 
 +  - As soon as Dinamica EGO crashes and closes, go to the folder where it was installed — typically ''​C:​\Program Files\Dinamica EGO''​ — and copy the files ''​hs_err_pidXXXX.log''​ and ''​hs_err_pidXXXX.mdmp''​ (XXXX is a number)((There may be more than one file with that name inside the installation folder. Make sure you get the most recent one)). 
 +  - Compress these two files into 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.
  
-**I can't find Dinamica'​s pdf guidebook file anywhere. Where was it installed at?**+=== Question R-2 ===
  
-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]]. +**Sometimes when I try to load a model in Dinamica ​EGOI get the following error message'The input port "<<​ some name here >>"​ is not defined.' What am I doing wrong?**
-\\ +
-\\ +
-===== General =====+
  
-=== Question G-1 ===+This is probably caused by an old Dinamica EGO version. Download and install the latest version from the [[https://​www.csr.ufmg.br/​dinamica/​download|Download]] section of the website — it will likely solve your problem.
  
-**What languages is Dinamica EGO available in?**+===== Performance and Memory =====
  
-For now, the software is only available in English. +=== Question ​P-===
-\\ +
-\\ +
-=== Question ​G-===+
  
-**When I'm running a simulation model, ​Dinamica EGO closes without informing any error message. What should I do?**+**How can maximize ​Dinamica EGO's performance?**
  
-  - Open Dinamica EGO using administrator privileges using "Run As Administrator"​. +See [[Useful Tips|"​Useful Tips: Increasing performance"​]].
-  - Open the model. +
-  - Before you run it, change the main [[log_tag_type#​log_level|log level]] defined in "Tools => Options | General | Main Log" to "​Debug"​. +
-  - Run the model. +
-  - As soon as Dinamica EGO crashes and close go to the folder where it was installed, typically ''​C:​\Program Files\Dinamica EGO'',​ and copy the file ''​hs_err_pidXXXX.log''​ (XXXX is a number)((There may be more than one file with that name inside the installation folder. Make sure you get the most recent one)). +
-  - 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. +
-\\ +
-\\ +
-=== 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?**+=== Question P-2 ===
  
-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. +**How can I prevent ​Dinamica EGO from showing "​Memory allocation has failed"​ when it runs my models?**
-\\ +
-\\ +
-=== Question G-4 ===+
  
-**I am seeing the following message 'This operator is deprecated and should be removed in future releases of Dinamica.'​ What does it mean?**+A few things to try:
  
-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. +  * Run Dinamica EGO on a machine ​with as much available memory as possible.
-\\ +
-\\ +
-=== Question G-5 ===+
  
-**What are difference between each log level available in Dinamica EGO?**+  ​Set the memory management option ("​Tools"​ -> "​Options"​ | "​Advanced"​) to "​Balanced."​ If you're using the command line tool, use the option ''​-memory-allocation-policy''​ with value ''​1''​.
  
-Consult ​the info about [[log_tag_type#​log_level|Log Levels]]. +  * Reduce ​the number of lines and columns in your maps.
-\\ +
-\\ +
-=== Question G-6 ===+
  
-**Why Dinamica EGO is automatically converting tests like ''​i1 == null'' ​to ''​isNull(i1)''?​**+  ​Reduce the number of different transitions (2 to 1, 5 to 3, etc.in your simulation — this reduces the number of layers in the probability map and uses less memory.
  
-Unfortunately the expression +  * Use sub-regions in your simulation. This lets [[Patcher]] and/or [[Expander]] work through your landscape and probability map one sub-region at a time, using less memory.
-<code pascal Expression A> +
-if i1 == null then +
-  null +
-else +
-  1 +
-</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 thatwe have to test if the value of a image is null explicitly ​using the operator ''​isNull''​Based on that, the correct expression should be  +
-<code pascal Expression B> +
-if isNull(i1) then +
-  null +
-else +
-  1 +
-</​code>​+
  
-Dinamica EGO automatically identifies the wrong expression and re-write it to better represent the user intention.+=== Question P-3 ===
  
-For more information about the expression syntax see the documentation of the [[Image Expression Type]]. +**How do I change ​the folder where Dinamica EGO stores temporary images and temporary DLL libraries?​**
-\\ +
-\\ +
-=== Question G-7 ===+
  
-**What image formats are supported by Dinamica EGO?**+By default, ​Dinamica EGO uses the Windows temporary folder to store temporary images and compiled libraries. You can change this directly in the GUI, via "Tools -> Options -> Advanced | Use alternative folder for storing temporary files."​
  
-Consult the [[supported_map_formats|list ​of the supported map formats]] +Alternatively,​ you can point Dinamica at a different folder — independent ​of the one Windows itself uses — by defining an environment variable named ''​DINAMICA_TEMP_DIR''​ with the path to the new folderOn Windows 10, go to "Start menu -> Settings -> System | About | System Info -> Advanced system settings -> Advanced | Environment Variables | System variables."​ Click "​New,"​ then type ''​DINAMICA_TEMP_DIR''​ as the variable name and choose the new path as its value.
-\\ +
-\\ +
-=== Question G-8 ===+
  
-**I can't find Dinamica'​s Examples. Where are they installed at?**+===== The Expression Language =====
  
-The default location is ''​C:​\Users\<​User>​\Documents\Dinamica EGO\Dataset''​.+=== Question E-1 ===
  
-It is worth noting that the name convention used by the OS to represent these folder names may be different ​in a localized Windows version.+**I am seeing the following message: 'This operator ​is deprecated and should ​be removed ​in future releases of Dinamica.' What does it mean?**
  
-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 EGOWe suggest you to re-install the software making sure that the option to install Dinamica EGO'​s ​Examples is checked.+It means the operator is no longer recommendedsince it will be removed ​in a future releaseAvoid using it going forward, and if it'​s ​already used in an existing model, replace it with a newer operator that performs the same function.
  
-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 ​E-===
-\\ +
-\\ +
-=== Question ​G-===+
  
-**How do I change the folder where Dinamica EGO stores temporary images and temporary dll libraries?**+**Why does Dinamica EGO automatically convert tests like ''​i1 == null''​ to ''​isNull(i1)''​?**
  
-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.+The expression below doesn'​t have the meaning ​it appears ​to
 +<​code>​ 
 +if i1 == null then 
 +  null 
 +else 
 +  1 
 +</​code>​ 
 +''​i1 == null''​ always evaluates to ''​null'',​ because ''​null'' ​can'​t ​be used in any algebraic expression without ​"poisoning" ​its result. For the same reason, expressions like ''​i1 + null'',​ ''​i1 / null'',​ and ''​if null then 1 else 2''​ always evaluate to ''​null''​ as well. To avoid this, an image'​s value has to be tested ​for null explicitly, using the ''​isNull''​ operator or ''?''​The correct version of the expression above is: 
 +<​code>​ 
 +if isNull(i1) then 
 +  null 
 +else 
 +  1 
 +</​code>​
  
-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.+Dinamica EGO automatically detects ​the incorrect expression ​and rewrites it to reflect what the user actually intended.
  
-===== License =====+> **Editor'​s note:** The null-poisoning behaviour of ''​i1 ​== null''​ described above is confirmed and consistent with the rest of this wiki's documentation. The specific claim that Dinamica EGO **automatically rewrites** the expression in the saved model, however, is not something the editor has an independent source to confirm. It's plausible as a GUI-level safeguard, but should be verified before being relied upon.
  
-=== Question L-1 ===+For more on expression syntax, see the documentation of the [[Image Expression Type]]. For more on how null values are handled during map and value calculations,​ see [[calculate_functors#​null_value_handling|Null Value Handling]] on Calculate Functors.
  
-**I’m interested in purchasing Dinamica EGO software for using it in my dissertation. How can I do that?**+===== Modeling and Calibration =====
  
-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).+=== Question M-1 ===
  
 +**Is it possible to automatically calibrate the values for "mean patch size," "patch variance,"​ and "patch isometry"​ in Dinamica EGO?**
  
-===== Calibration =====+There is no mechanism for calibrating those values automatically in Dinamica EGO. If you'd rather not rely on trial and error, we recommend using different software, such as [[https://​fragstats.org/​|Fragstats]],​ to calculate the parameters.
  
-=== Question ​C-===+=== Question ​M-===
  
-**Is it possible to automatically calibrate the values for "mean patch size", "patch variance"​ and "patch isometry"​ using Dinamica EGO?**+**Why does Dinamica EGO say it can't calculate the multi-step transition matrix?**
  
-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. +The multi-step matrix can only be calculated with the [[Determine Transition Matrix]] functor if the single-step matrix has a decomposition into its corresponding eigenvectors and eigenvaluesWithout that decomposition,​ the process can't be represented as an ergodic matrix — that is, the eigenvalues aren't real numbers. The time-step matrix is obtained as follows:
-\\ +
-\\ +
-=== Question C-2 ===+
  
-**Why does Dinamica EGO say it can not calculate the multi-step transition matrix?**+P = M INVM
  
-Unfortunately,​ the multi-step ​matrix ​can only be calculated using the functor [[Determine Transition Matrix]] if the single step matrix ​have decomposition to its corresponding eigenvectors and eigenvalues. The lack of a that decomposition means that the process can not be represented as ergodic matrices; that is, the eigenvalues are not real numbers. Remember that the time-step ​matrix ​is obtained as follows:+  * ''​M''​ — matrix ​of eigenvectors 
 +  * ''​V''​ — matrix ​of eigenvalues (diagonal matrix, with nonzero values only along its diagonal) 
 +  * ''​INVM''​ — inverse ​of the matrix ​of eigenvectors
  
-P=M*V*INVM+To get the time-step matrix, the elements of matrix ​must be raised to the power (1/t), where t is the number of time steps within the time period. Not every matrix has real-number eigenvalues,​ which is the source of the error.
  
-M matrix of Eigenvalues\\ +It's still possible to work around this limitation by calculating ​separate transition ​matrix ​for each year, using crude rates instead ​of net rates. The model [[variable_time_step_net_transition_rates]] and the submodel [[Calc Net Transition Rates]], both available as part of the standard Dinamica EGO distribution,​ use this technique.
-V matrix of Eigenvectors (V is diagonal ​matrix ​with values different from zero only in its diagonal)\\ +
-INVM inverse ​of matrix ​of Eigenvalues+
  
-To get the time step matrix, the elements of matrix V must be raised to the power (1/t), where t is the number of time steps within a time-period. Not all matrices have real-number Eigenvalues,​ hence the error. +=== Question ​M-3 ===
- +
-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 ===+
  
 **How can I improve the similarity values resulting from my model calibration?​** **How can I improve the similarity values resulting from my model calibration?​**
  
-See [[http://​csr.ufmg.br/​dinamica/​2015/​09/​22/​validation/​|this post]] ​from Dinamica website about validation. +See [[https://​csr.ufmg.br/​dinamica/​2015/​09/​22/​validation/​|this post]] ​on the Dinamica website about validation.
-\\ +
-\\ +
-===== Performance ===== +
  
-=== Question P-1 ===+===== Documentation and Resources =====
  
-**How is it possible to maximize Dinamica EGO performance?​**+=== Question D-1 ===
  
-See [[Useful Tips|"​Useful Tips: Increasing performance"​]]. +**I can't find Dinamica'​s PDF guidebook file anywhereWhere was it installed?​**
-\\ +
-\\ +
-=== Question P-2 ===+
  
-**How much memory (RAM) is Dinamica EGO able to handle?**+It's no longer distributed as a PDF — the guidebook ​is now part of the online documentation wiki. See [[guidebook_start|here]].
  
-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.+=== Question D-2 ===
  
-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. +**What image formats does Dinamica EGO support?**
-\\ +
-\\ +
-=== Question P-3 ===+
  
-**How can I prevent ​Dinamica EGO from showing "​Memory allocation has failed"​ when it runs my models?**+Dinamica EGO supports most image formats supported by GDAL. See the [[supported_map_formats|list of supported map formats]].
  
-You can try some solutions:+=== Question D-3 ===
  
-  ​Run Dinamica ​EGO 64 in a //Windows 10/​8/​7/​Vista 64-bit// environment and add //much more// memory to your computerDo not use a Windows 32-bit environment to run your simulations;​+**I can't find Dinamica's examplesWhere are they installed?​**
  
-  * 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;+Download them from [[https://csr.ufmg.br/dinamica/nui_download/​1054/​|Dataset Download]].
  
-  * Reduce the number of lines and columns in your maps;+===== General =====
  
-  * Reduce the number of different transitions (2 to 1, 5 to 3 etc) in your simulation. This will reduce the number of layers in the probability map and use less memory;+=== Question G-===
  
-  ​Use sub-regions ​in your simulation. This allows [[Patcher]] and/or [[Expander]] to work with your landscape and probability map one sub-region at a time, using less memory.+**What languages is Dinamica EGO available ​in?**
  
 +For now, the software is only available in English.
  
-  +=== Question G-2 ===
-===== Usage =====+
  
-=== Question U-1 ===+**What'​s the difference between each log level available in Dinamica EGO?**
  
-**Console Launcher output window only shows the last messages produced by model executionIs there any way to see the complete model output?**+See [[log_tag_type#​log_level|Log Levels]].
  
-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. +=== Question ​G-===
- +
-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 =====  +
- +
-=== Question ​M-===+
  
-**What is CARLUC? Where can find further information regarding it?**+**I'm interested in purchasing Dinamica EGO for use in my dissertation. How do I do that?**
  
-CARLUC algorithm ​is described in the following articles: +Dinamica EGO is [[https://csr.ufmg.br/dinamica/license|free for scientificcommercial, and non-commercial use]]Go to the [[https://www.csr.ufmg.br/​dinamica/​dinamica-8|Download]] section of the website to get it — it includes everything you need to get started, including file examples.
-[[http://onlinelibrary.wiley.com/doi/10.1111/​j.1529-8817.2003.00765.x/​abstract|HirschA.I., Little, W.S., Houghton, R.A., Scott, N.A., and White, J.D. 2004. The net carbon flux due to deforestation and forest re-growth in the Brazilian Amazonanalysis using a process-based modelGlobal Change Biology, 10, 908-924]].+