Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
faq [2023/08/14 16:12] 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. Then, close 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// menu, and 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 only occurs 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 I-2 === |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question T-3 === | + | |
| **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 | ||
| Line 27: | Line 26: | ||
| </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 performance, but the graphical interface may become unusable. |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question T-4 === | + | |
| - | **Dinamica EGO will not start because it says 'Unable to deserialize perspectives from XML'. What is wrong?** | + | === Question I-3 === |
| - | 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. | + | **Dinamica EGO will not start because it says 'Unable to deserialize perspectives from XML'. What is wrong?** |
| + | |||
| + | 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 documentation. No additional information, other than the version of the Dinamica EGO software installed in your system, is sent. | + | **Dinamica EGO does not install on my computer. When I click on the Dinamica EGO installer, nothing happens. What is wrong?** |
| - | If you prefer, you can disable the version check disabling the "Tools => Options | System | Update" switch, but this is not recommended. | + | First, make sure the installer is not corrupted. Also, 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 computer. Why 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 downloaded, Dinamica 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 utility, try running Dinamica EGO again. |
| - | 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''. | + | ===== Updates, Security, and 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 proceed. This 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 connection. Why 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 issue. However, 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 there. What 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?** |
| - | This limitation no longer applies to Dinamica EGO version 4.0.x and newer. | + | * From time to time, it 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 checking, which prevents any version checking from happening at all. The 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. |
| - | \\ | + | |
| - | \\ | + | |
| - | === 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?** | + | * Users can send data to our servers by accessing the "[[submodels|submodel]]" repository within the application, or by downloading "[[submodels|submodels]]" from our server. Both 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. |
| - | 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. | + | * 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. |
| - | 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. | + | ===== Runtime Errors and Crashes ===== |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question T-11 === | + | |
| - | **Dinamica EGO does not install on my computer. When I click on the Dinamica EGO installer, nothing happens. What is wrong?** | + | === Question R-1 === |
| - | First, make sure the installer is not corrupted. Also, make sure your anti-virus is not blocking the Dinamica EGO installer. | + | **When I'm running a simulation model, Dinamica EGO closes without showing any error message. What should I do?** |
| - | 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. | + | - 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)). |
| - | === Question T-12 === | + | - 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. |
| - | **When I try to run Dinamica EGO, I get a message box that says 'Unable to load library "JavaBinding"'. What is wrong?** | + | === Question R-2 === |
| - | 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: | + | **Sometimes 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?** |
| - | Go to the [[https://www.microsoft.com/en-us/download/details.aspx?id=48145|Microsoft website]], and click the "Download" button. | + | 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. |
| - | After installing this utility, try running Dinamica EGO again. | + | ===== Performance and Memory ===== |
| - | \\ | + | === Question P-1 === |
| - | \\ | + | |
| - | ===== Documentation ===== | + | |
| - | === Question D-1 === | + | **How can I maximize Dinamica EGO's performance?** |
| - | **I can't find Dinamica's pdf guidebook file anywhere. Where was it installed at?** | + | See [[Useful Tips|"Useful Tips: Increasing performance"]]. |
| - | 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]]. | + | === Question P-2 === |
| - | \\ | + | |
| - | \\ | + | |
| - | ===== General ===== | + | |
| - | === Question G-1 === | + | **How can I prevent Dinamica EGO from showing "Memory allocation has failed" when it runs my models?** |
| - | **What languages is Dinamica EGO available in?** | + | A few things to try: |
| - | For now, the software is only available in English. | + | * Run Dinamica EGO on a machine with as much available memory as possible. |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question G-2 === | + | |
| - | **When I'm running a simulation model, Dinamica EGO closes without informing any error message. What should I do?** | + | * 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''. |
| - | - Open Dinamica EGO using administrator privileges using "Run As Administrator". | + | * Reduce the number of lines and columns in your maps. |
| - | - 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?** | + | * 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. |
| - | 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. | + | * 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. |
| - | \\ | + | |
| - | \\ | + | |
| - | === 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?** | + | === Question P-3 === |
| - | 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. | + | **How do I change the folder where Dinamica EGO stores temporary images and temporary DLL libraries?** |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question G-5 === | + | |
| - | **What are difference between each log level available in 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 info about [[log_tag_type#log_level|Log Levels]]. | + | 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 folder. On 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-6 === | + | |
| - | **Why Dinamica EGO is automatically converting tests like ''i1 == null'' to ''isNull(i1)''?** | + | ===== The Expression Language ===== |
| - | Unfortunately the expression | + | === Question E-1 === |
| - | <code pascal Expression A> | + | |
| + | **I am seeing the following message: 'This operator is deprecated and should be removed in future releases of Dinamica.' What does it mean?** | ||
| + | |||
| + | It means the operator is no longer recommended, since it will be removed in a future release. Avoid 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. | ||
| + | |||
| + | === Question E-2 === | ||
| + | |||
| + | **Why does Dinamica EGO automatically convert tests like ''i1 == null'' to ''isNull(i1)''?** | ||
| + | |||
| + | The expression below doesn't have the meaning it appears to: | ||
| + | <code> | ||
| if i1 == null then | if i1 == null then | ||
| null | null | ||
| Line 183: | Line 142: | ||
| 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. 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 | + | ''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 pascal Expression B> | + | <code> |
| if isNull(i1) then | if isNull(i1) then | ||
| null | null | ||
| Line 191: | Line 150: | ||
| </code> | </code> | ||
| - | Dinamica EGO automatically identifies the wrong expression and re-write it to better represent the user intention. | + | Dinamica EGO automatically detects the incorrect expression and rewrites it to reflect what the user actually intended. |
| - | For more information about the expression syntax see the documentation of the [[Image Expression Type]]. | + | > **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 G-7 === | + | |
| - | **What image formats are supported by Dinamica EGO?** | + | 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. |
| - | Consult the [[supported_map_formats|list of the supported map formats]]. | + | ===== Modeling and Calibration ===== |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question G-8 === | + | |
| - | **I can't find Dinamica's Examples. Where are they installed at?** | + | === Question M-1 === |
| - | The default location is ''C:\Users\<User>\Documents\Dinamica EGO\Dataset''. | + | **Is it possible to automatically calibrate the values for "mean patch size," "patch variance," and "patch isometry" in Dinamica EGO?** |
| - | 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. | + | 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. |
| - | 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. | + | === Question M-2 === |
| - | 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]] | + | **Why does Dinamica EGO say it can't calculate the multi-step transition matrix?** |
| - | \\ | + | |
| - | \\ | + | |
| - | === Question G-9 === | + | |
| - | **How do I change the folder where Dinamica EGO stores temporary images and temporary dll libraries?** | + | 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 eigenvalues. Without 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: |
| - | 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. | + | P = M * V * INVM |
| - | 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. | + | * ''M'' — matrix of eigenvectors |
| + | * ''V'' — matrix of eigenvalues (a diagonal matrix, with nonzero values only along its diagonal) | ||
| + | * ''INVM'' — inverse of the matrix of eigenvectors | ||
| - | \\ | + | 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 the time period. Not every matrix has real-number eigenvalues, which is the source of the error. |
| - | \\ | + | |
| - | === 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?** | + | It's still possible to work around this limitation by calculating a 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. |
| - | * 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! | + | === Question M-3 === |
| - | + | ||
| - | * 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 4'' folder, 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 ===== | + | |
| - | + | ||
| - | === Question L-1 === | + | |
| - | + | ||
| - | **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 (file examples). | + | |
| - | + | ||
| - | + | ||
| - | ===== Calibration ===== | + | |
| - | + | ||
| - | === Question C-1 === | + | |
| - | + | ||
| - | **Is it possible to automatically calibrate the values for "mean patch size", "patch variance" and "patch isometry" using Dinamica EGO?** | + | |
| - | + | ||
| - | 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 === | + | |
| - | + | ||
| - | **Why does Dinamica EGO say it can not calculate the multi-step transition matrix?** | + | |
| - | + | ||
| - | Unfortunately, the multi-step matrix can only be calculated using the functor [[Determine Transition Matrix]] if the single step matrix have a 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: | + | |
| - | + | ||
| - | P=M*V*INVM | + | |
| - | + | ||
| - | M matrix of Eigenvalues\\ | + | |
| - | V matrix of Eigenvectors (V is a 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. | + | |
| - | + | ||
| - | 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 anywhere. Where 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]]. |
| - | ^Windows 64 Bits (Vista 64, 7 64, 8 64, 10 64, Server 2008 R2, Server 2012, Server 2016) & Linux|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 === |
| - | ^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 === | + | |
| - | **How can I prevent Dinamica EGO from showing "Memory allocation has failed" when it runs my models?** | + | **What image formats does Dinamica EGO support?** |
| - | You can try some solutions: | + | Dinamica EGO supports most image formats supported by GDAL. See the [[supported_map_formats|list of supported map formats]]. |
| - | * 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; | + | === Question D-3 === |
| - | * 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; | + | **I can't find Dinamica's examples. Where are they installed?** |
| - | * Reduce the number of lines and columns in your maps; | + | Download them from [[https://csr.ufmg.br/dinamica/nui_download/1054/|Dataset Download]]. |
| - | * 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; | + | ===== General ===== |
| - | * 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. | + | === Question G-1 === |
| + | **What languages is Dinamica EGO available in?** | ||
| - | + | For now, the software is only available in English. | |
| - | ===== Usage ===== | + | |
| - | === Question U-1 === | + | === Question G-2 === |
| - | **Console Launcher output window only shows the last messages produced by model execution. Is there any way to see the complete model output?** | + | **What's the difference between each log level available in Dinamica EGO?** |
| - | 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. | + | See [[log_tag_type#log_level|Log Levels]]. |
| - | 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. | + | === Question G-3 === |
| - | + | ||
| - | ===== Models ===== | + | |
| - | + | ||
| - | === Question M-1 === | + | |
| - | **What is CARLUC? Where can I 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 scientific, commercial, 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|Hirsch, A.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 Amazon: analysis using a process-based model. Global Change Biology, 10, 908-924]]. | + | |