Computational details Computational Limits and Efficiency There are limits imposed by the amount of memory that a computer can address and these can limit the maximum size of an Anaqsim model.  The following graph shows data from numerical experiments with 64-bit Anaqsim on a number of different computers.  These data are specific to these machines and each computer will behave differently depending on what other software is running and how the computer is configured, but this at least gives rough guidance.  The vertical axis shows the RAM used by the Anaqsim task - you will need more than this amount of memory to handle the operating system and possibly other tasks.  Thanks to staff at McLane Environmental for providing several of the data points in this graph. When the number of equations approaches the upper limit posed by memory on a given computer, the solve times increase significantly.   If, while running a model, all available memory (RAM) is used by Anaqsim and other tasks running, the windows operating system and .net will swap pages of memory to/from disk, which is a much slower than using RAM.  Symptoms of this condition are a dramatic slowing of all tasks and lots of hard disk activity; this is generally a condition to avoid.  It is best to increase your computer's memory or reduce the complexity of the model so that you can make runs entirely within RAM. Another potential limit to the application of Anaqsim is where the system of equations gets so large that it takes too long to solve in a reasonable time.   That limit, on present standard personal computers, is probably in the range of several tens of thousands of equations.  Anaqsim can be the right tool for problems of moderate complexity, but not extreme complexity.  Computing power evolves rapidly, and these limits will migrate upward with time.  For situations with extreme complexity, a numerical method like finite differences or finite elements is probably a better choice. Using multi-level areas in a model adds rapidly to the number of equations in the system.  To keep your problem within a manageable number of equations, use multiple levels sparingly, just in your area of interest and transition to a single level in the far-field. Some additional suggestions for efficient modeling and limiting computation time are given in the Solve section.Parallel Processing Starting with release 2023-1, parallel processing was implemented for determining the coefficients of the matrix A, and the vector b, which form the core components of the linear equation solver Ax = b, updated at each timestep in the solve process. Starting with release 2019-1, parallel processing was implemented for these computations that occur in plot-making: Computing values (e.g. head) that are the basis for contours Computing values (e.g. velocity) that are the basis for vectors Tracing multiple pathlines from lines, areas, wells, and circles These can be a time-saver for complex models and plots, if your computer's CPU has multiple cores.  Experiments indicate that: Solve time has been sped up by 1.5 - 3 times depending on complexity of the model, and whether steady or transient on a 4-core CPU Making a plot with hundreds of area pathlines is quicker by a factor approaching 4 on a 4-core CPU, or approaching a factor of 6 on a 6-core CPU. Automating Runs In addition to running Anaqsim interactively through the graphic user interface, you can make automated runs using the Windows command prompt.  This may be useful for running parameter estimation software such as PEST or for executing a batch of unattended runs.  Two input files are required for each model run: Anaqsim model file (.anaq) - this is the file which describes the model setup and is created by Anaqsim. Run control file (.txt) - a text file which describes what type of outputs the model should create and where these will be saved. This is created by the user with a text editor, like the Notepad accessory that comes with Windows operating systems. See the following sections for a description and examples. To run an automated model in the Command Prompt, the command syntax is:     The command prompt is accessed in Windows 11 by clicking Start Button and searching for 'Command Prompt'.Within the command prompt it is necessary to put quotes around the path when the path contains names with spaces such as "program files" or "my documents".To avoid typing out the full file path it is possible to change the current directory within the command prompt to the location that files are saved, then just type in the file names (no path needed) for every input/output file. Assuming you've changed the current directory in the command prompt to the directory with all input/output files, the following is an example command that would execute a run of Anaqsim: "c:\program files\yellow sub hydro\Anaqsim\Anaqsim.exe" run23.anaq run23.txt In the above example, Anaqsim is launched, run23.anaq is opened from the command prompt current directory, then execution and outputs are controlled by lines in the run control file run23.txt, also in the command prompt current directory.  An optional 'batch' command can be added to the command which will force Anaqsim to work in the background and not open a user-interface.  An example command that would execute a run of Anaqsim in the background is: "c:\program files\yellow sub hydro\Anaqsim\Anaqsim.exe" run23.anaq run23.txt batch The section below shows all the possible commands that can be included in the run control file, their output options, and examples of each.  Some output files are dynamically named based on the input file name, and labels of elements in the model.  Where is specified this relates to the filename of the .anaq input file. Where is specified, it relates to the label associated with each well in the model. Similar syntax is used for lines, rivers, etc which have labels within the model. Starting from version 2023-1 additional outputs and output options are available. Run Control File Commands All of the commands listed in the run control file are lower case (case sensitive).  The lines may appear in any order. Initial Heads File Command: initialheadsfile filename.hdsRequired: required for transient runsExplanation: Tells Anaqsim to use file filename.hds (replace with your own filename) as the initial heads for a transient run.  As written with no path, the file must be located in the command prompt current directory.  If it's located elsewhere, you must write the entire path+filename here instead of just the filename.  The two parameters on this line must be separated by any combination of spaces and/or tab characters.  This line is only needed for transient runs where the starting heads are to be read from a file.Output options: N/AExamples: initialheadsfile run23.hds Output Log File Command: outputfile filename.outRequired: YesExplanation:  Tells Anaqsim to write text outputs from the automated run to a new text file named filename.out (replace with your own filename). As written with no path, filename.out will be written to the command  prompt current directory.  If you want it written elsewhere, you must enter the entire path+filename here. The two parameters on this line must be separated by any combination of spaces and/or tab characters Output options: N/AExamples: outputfile run23.out Write Head Locations Command: writeheadlocations filename.ihlRequired: NoExplanation:  Tells Anaqsim to write the initial head locations from the automated run to a new file named filename.ihl (replace with your own filename). This command (combined with the Save Initial Heads command) is useful if you wish to automate running a steady state model, and creating the initial conditions for a subsequent transient model. As written with no path, filename.ihl will be written to the command prompt current directory.  If you want it written elsewhere, you must enter the entire path+filename here. The two parameters on this line must be separated by any combination of spaces and/or tab characters Output options: N/AExamples: writeheadlocations run23.ihl Save Initial Heads Command: saveinitialheads filename.hdsRequired: NoExplanation:  Tells Anaqsim to save the initial head locations from the automated run to a new file named filename.hds (replace with your own filename). This command (combined with the Write Head Locations) is useful if you wish to automate running a steady state model, and creating the initial conditions for a subsequent transient model. As written with no path, filename.hds will be written to the command prompt current directory.  If you want it written elsewhere, you must enter the entire path+filename here. The two parameters on this line must be separated by any combination of spaces and/or tab characters Output options: N/AExamples: saveinitialheads run23.hds This command will fail if you have not also specified 'writeheadlocations' as Anaqsim requires the head locations to be written first before the initial heads can be saved at those locations. Head Specified Wells Command: headspecifiedwellsRequired: NoExplanation: Directs Anaqsim to write the discharges of head-specified wells to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _hspecWells_.png Examples: headspecifiedwells log headspecifiedwells csv run23_head_wells.csv headspecifiedwells graph Discharge Specified Wells Command: dischargespecifiedwellsRequired: NoExplanation: Directs Anaqsim to write the heads at discharge-specified wells to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _qspecWells_.png Examples: dischargespecifiedwells log dischargespecifiedwells csv run23_discharge_wells.csv dischargespecifiedwells graph Discharge Specified Multilayer Wells Command: dischargespecifiedmultilayerwellsRequired: NoExplanation: Directs Anaqsim to write multi-level discharge-specified wells in the model.  For these the breakdown of discharges by domain will be written to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _qspecMultiWells_.png Examples: dischargespecifiedmultilayerwells log dischargespecifiedmultilayerwells csv run23_discharge_multilayer_wells.csv dischargespecifiedmultilayerwells graph Head Specified Lines Command: headspecifiedlinesRequired: NoExplanation: Directs Anaqsim to write the discharges of internal head-specified line boundaries to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _HspecLines_.png Examples: headspecifiedlines log headspecifiedlines csv run23_HspecLines.csv headspecifiedlines graph Rivers Command: riversRequired: NoExplanation: Directs Anaqsim to write the discharges of river line boundaries to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _RiverDischarge_.png Examples: rivers log rivers csv run23_Rivers.csv rivers graph River Groups Command: rivergroupsRequired: NoExplanation: Directs Anaqsim to write the cumulative discharge of grouped rivers to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _RiverDsicharge_.png Examples: rivergroups log rivergroups csv run23_RiverGroups.csv rivergroups graph External Boundaries Command: externalboundariesRequired: NoExplanation: Directs Anaqsim to write the discharges across external boundaries to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to Head Boundaries: _ExternalHeadBoundaries_.png Normal Flux Boundaries: _ExternalNormalFluxBoundaries_.png Head Normal Flux Boundaries: _ExternalHeadNormalFluxBoundaries_.png Examples: externalboundaries log externalboundaries csv run23_ExternalBoundaries.csv externalboundaries graph Vertical Leakage Command: verticalleakageRequired: NoExplanation: Directs Anaqsim to write the vertical leakages over polygon areas to the output file.Output options: log - outputs saved to log file csv - a filename must be provided after csv key word graph - graphs will be saved to _VerticalLeakage_.png Examples: verticalleakage log verticalleakage csv run23_Vertical_Leakage.csv verticalleakage graph Conditions along a Line Command: conditionsalonglineRequired: NoExplanation: Directs Anaqsim to write steady and/or transient conditions along a line to the output file.  All variables are output for all preset lines.Output options: csv - csv files will be saved to _TransientLine__.csv where is either: Head DischargeTangent DischargeNormal ExtractionModel ExtractionHBased LeakageTop LeakageBottom StorageFlux Unlike other csv options, you do not specify a filename following the csv key word graph - graphs will be saved to _TransientLine__.png Examples: conditionsalongline csv conditionsalongline graph Head Hydrographs Command: headhydrographsRequired: NoExplanation: Directs Anaqsim to write head hydrographs for preset hydrograph points to the output file.Output options: csv - a filename must be provided after csv key word graph - graphs will be saved to _HeadHydrograph_.png Examples: headhydrographs csv run23_Head_Hydrographs.csv headhydrographs graph Drawdown Hydrographs Command: drawdownhydrographsRequired: NoExplanation: Directs Anaqsim to write drawdown hydrographs for preset hydrograph points to the output file.Output options: csv - a filename must be provided after csv key word graph - graphs will be saved to _DrawdownHydrograph_.png Examples: drawdownhydrographs csv run23_Drawdown_Hydrographs.csv drawdownhydrographs graph Captured Pathlines Command: capturedpathlinesRequired: NoExplanation: If no csv key word provided, directs Anaqsim to write the number of captured pathlines to the output file.  This is useful for running parameter optimization problems where you want to maximize or minimize the number of pathlines captured by specified wells or line boundaries.   Use this with capture constrain in pathline settings.If csv is specified and a filename is provided, then the x,y,z vertices of all pathlines (whether captured or not) are saved to a file.  Output options: No keyword - captured pathlines written to output file (specified by outputfile command) csv - a filename must be provided after csv key word Examples: capturedpathlines capturedpathlines csv run23_Pathlines.csv Head Output File Command: headoutputfileRequired: NoExplanation: Directs Anaqsim to evaluate heads according to the current plot settings (Plot Input / What to Plot / Window and Plot Input / Contours Settings / Points_Evaluate) in each model level and at each time step if it is a transient simulation.  Output options: xyz - A filename must be provided where the outputs will be written.  x, y locations and head levels are written to a csv file for each level, time period, and time step binary - A filename prefix should be specified.  Outputs will be named: _t