menu
The CLI version of D2S2 is available to users with a Developer license. It performs all the same simulation calculations as the standard application but without the overhead of rendering the simulation graphics, making it significantly faster to execute.
The CLI is well suited to scenarios where a graphical interface is not required or practical:
D2S2.exe <task> <task parameters> --user <username> --pwd <password>
D2S2.exe <task> <task parameters> --license <license file>
Running the CLI application without any arguments displays the built-in help message.
runsimRuns a simulation from a provided scenario file.
| Parameter | Required | Description |
|---|---|---|
--scenario <file> |
Yes | Path to the scenario file (.d2s2) |
--useropts <file> |
No | Path to the user settings file |
Example:
D2S2.exe runsim --scenario c:\temp\scenario.d2s2 --useropts c:\temp\useropts.xml
runscriptRuns a scenario in conjunction with a script. Either --scriptname or --scriptopts must be specified.
| Parameter | Required | Description |
|---|---|---|
--scriptname <name> |
Yes* | Fully qualified type name of the script to run. Use the list task to see available names. |
--scriptopts <file> |
Yes* | Path to a script options file (.d2s2-script). Can be used instead of --scriptname. |
--scenario <file> |
No | Path to the scenario file (.d2s2) |
--useropts <file> |
No | Path to the user settings file |
*At least one of --scriptname or --scriptopts is required.
Examples:
D2S2.exe runscript --scriptname D2S2.Simulation.LoggingScript
D2S2.exe runscript --scriptopts c:\temp\options.d2s2-script --scenario c:\temp\scenario.d2s2 --useropts c:\temp\useropts.xml
listLists all available scripts by their fully qualified type names. Use these names with the --scriptname parameter of runscript and makescript.
D2S2.exe list
makescriptSaves a template script options file (.d2s2-script) with default options for the named script. Use this as a starting point before customising and passing the file to runscript.
| Parameter | Required | Description |
|---|---|---|
--scriptname <name> |
Yes | Fully qualified type name of the script. Use the list task to see available names. |
--scriptopts <file> |
Yes | Output path for the generated script options file |
--useropts <file> |
No | Path to the user settings file |
Example:
D2S2.exe makescript --scriptname D2S2.Simulation.LoggingScript --scriptopts c:\temp\options.d2s2-script
The CLI supports two authentication methods:
| Method | Parameters | Notes |
|---|---|---|
| Credentials | --user <username> --pwd <password> |
Same credentials used to sign in to the UI application. If omitted, the CLI reuses the credentials from the last UI sign-in. |
| License file | --license <license file> |
Provide the file path to a valid license file directly. |
If neither method is specified, the CLI falls back to the credentials cached from the most recent UI sign-in. For automated or headless environments (such as CI/CD pipelines or test servers), it is recommended to use the license file method to avoid dependency on a cached session.
Security note: Avoid passing
--pwddirectly on the command line in shared or logged environments, as the password may be visible in process listings or shell history. Prefer the license file method for automated workflows.
Script parameters — such as the output path for the Logging script — are configured via a script options file (.d2s2-script). See Scripts for instructions on generating a script options file using the makescript task.
The script options file is a JSON document where each field corresponds to a configurable property of the selected script. The following example shows a typical options file for the built-in LoggingScript:
{
"$type": "D2S2.Simulation.LoggingScript, D2S2Library",
"CsvFilename": "C:/temp/Logger.csv",
"SaveObjects": "ExampleSat CubeComputer",
"StateSaveInterval": 1,
"UpdateVisual": false,
"SaveStateHistory": false,
"ScriptResult": false
}
| Field | Description |
|---|---|
$type |
Fully qualified type name of the script. This must match the name returned by the list task. |
CsvFilename |
Output path for the generated CSV log file. |
SaveObjects |
Space-separated list of simulation object names whose state will be logged. |
StateSaveInterval |
Interval (in simulation seconds) at which state is recorded. |
UpdateVisual |
When true, updates the visual state of objects during logging. Set to false for headless/CLI use. |
SaveStateHistory |
When true, retains the full state history in memory during the run. |
ScriptResult |
Reserved for script result reporting. Typically set to false. |
User code directories are configured in the user settings file (.xml), which controls where D2S2 looks for custom scripts and components at startup. This file is generated when developer options are configured — see Developer User Settings for details. The file is located in the D2S2 installation directory, typically AppData\Roaming\D2S2.
An example user settings file is shown below:
<UserSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<LastEulaAcceptedVer>1</LastEulaAcceptedVer>
<DeveloperLocations>
<string>C:/temp/Source</string>
</DeveloperLocations>
<ShowUpdateInfo>false</ShowUpdateInfo>
<DeveloperIncludeVis>true</DeveloperIncludeVis>
<DeveloperIncludeWinForms>true</DeveloperIncludeWinForms>
<OptimiseUserCode>false</OptimiseUserCode>
</UserSettings>
| Field | Description |
|---|---|
DeveloperLocations |
List of directories to scan for user-authored scripts and components. Add one <string> entry per directory. |
DeveloperIncludeVis |
When true, includes WPF/visual assemblies when compiling user code. Set to false for pure CLI use to reduce compilation overhead. |
DeveloperIncludeWinForms |
When true, includes WinForms assemblies when compiling user code. Set to false if your scripts do not use WinForms UI components. |
OptimiseUserCode |
When true, compiles user code with optimisations enabled. Useful for performance-sensitive scripts in production runs. |
DawnDusk ("we," "our," or "us") is committed to protecting your privacy. This Privacy Policy explains how your personal information is collected, used, and disclosed by DawnDusk. This Privacy Policy applies to our website, dawndusk.space , and its associated subdomains (collectively, our "Service"). By accessing or using our Service, you signify that you have read, understood, and agree to our collection, storage, use, and disclosure of your personal information as described in this Privacy Policy and our Terms of Service.
To help explain things as clearly as possible in this Privacy Policy, every time any of these terms are referenced, are strictly defined as:
We collect information from you when you visit our service, register, place an order, subscribe to our newsletter, respond to a survey or fill out a form.
Any of the information we collect from you may be used in one of the following ways:
We receive some information from the third parties when you contact us. For example, when you submit your email address to us to show interest in becoming our customer, we receive information from a third party that provides automated fraud detection services to us. We also occasionally collect information that is made publicly available on social media websites. You can control how much of your information social media websites make public by visiting these websites and changing your privacy settings.
We may share the information that we collect, both personal and non-personal, with third parties such as advertisers, contest sponsors, promotional and marketing partners, and others who provide our content or whose products or services we think may interest you. We may also share it with our current and future affiliated companies and business partners, and if we are involved in a merger, asset sale or other business reorganization, we may also share or transfer your personal and non-personal information to our successors-in-interest.
We may engage trusted third party service providers to perform functions and provide services to us, such as hosting and maintaining our servers and our service, database storage and management, e-mail management, storage marketing, credit card processing, customer service and fulfilling orders for products and services you may purchase through our service. We will likely share your personal information, and possibly some non-personal information, with these third parties to enable them to perform these services for us and for you.
We may share portions of our log file data, including IP addresses, for analytics purposes with third parties such as web analytics partners, application developers, and ad networks. If your IP address is shared, it may be used to estimate general location and other technographics such as connection speed, whether you have visited the service in a shared location, and type of device used to visit the service. They may aggregate information about our advertising and what you see on the service and then provide auditing, research and reporting for us and our advertisers.
We may also disclose personal and non-personal information about you to government or law enforcement officials or private parties as we, in our sole discretion, believe necessary or appropriate in order to respond to claims, legal process (including subpoenas), to protect our rights and interests or those of a third party, the safety of the public or any person, to prevent or stop any illegal, unethical, or legally actionable activity, or to otherwise comply with applicable court orders, laws, rules and regulations.
We will collect personal information that you submit to us. We may also receive personal information about you from third parties as described above.
By submitting your email address on our service, you agree to receive emails from us. You can cancel your participation in any of these email lists at any time by clicking on the opt-out link or other unsubscribe option that is included in the respective email. We only send emails to people who have authorized us to contact them, either directly, or through a third party. We do not send unsolicited commercial emails, because we hate spam as much as you do. By submitting your email address, you also agree to allow us to use your email address for customer audience targeting on sites like Facebook, where we display custom advertising to specific people who have opted-in to receive communications from us. Email addresses submitted only through the order processing page will be used for the sole purpose of sending you information and updates pertaining to your order. If, however, you have provided the same email to us through another method, we may use it for any of the purposes stated in this Policy. Note: If at any time you would like to unsubscribe from receiving future emails, we include detailed unsubscribe instructions at the bottom of each email.
We are incorporated in SOUTH AFRICA. Information collected via our website, through direct interactions with you, or from use of our help services may be transferred from time to time to our offices or personnel, or to third parties, located throughout the world, and may be viewed and hosted anywhere in the world, including countries that may not have laws of general applicability regulating the use and transfer of such data. To the fullest extent allowed by applicable law, by using any of the above, you voluntarily consent to the trans- border transfer and hosting of such information.
We take precautions to protect the security of your information. We have physical, electronic, and managerial procedures to help safeguard, prevent unauthorized access, maintain data security, and correctly use your information. However, neither people nor security systems are foolproof, including encryption systems. In addition, people can commit intentional crimes, make mistakes or fail to follow policies. Therefore, while we use reasonable efforts to protect your personal information, we cannot guarantee its absolute security. If applicable law imposes any non-disclaimable duty to protect your personal information, you agree that intentional misconduct will be the standards used to measure our compliance with that duty.
The rights you have to request updates or corrections to the information we collect depend on your relationship with us. Personnel may update or correct their information as detailed in our internal company employment policies. Customers have the right to request the restriction of certain uses and disclosures of personally identifiable information as follows. You can contact us in order to (1) update or correct your personally identifiable information, (2) change your preferences with respect to communications and other information you receive from us, or (3) delete the personally identifiable information maintained about you on our systems (subject to the following paragraph), by cancelling your account. Such updates, corrections, changes and deletions will have no effect on other information that we maintain, or information that we have provided to third parties in accordance with this Privacy Policy prior to such update, correction, change or deletion. To protect your privacy and security, we may take reasonable steps (such as requesting a unique password) to verify your identity before granting you profile access or making corrections. You are responsible for maintaining the secrecy of your unique password and account information at all times. You should be aware that it is not technologically possible to remove each and every record of the information you have provided to us from our system. The need to back up our systems to protect information from inadvertent loss means that a copy of your information may exist in a non-erasable form that will be difficult or impossible for us to locate. Promptly after receiving your request, all personal information stored in databases we actively use, and other readily searchable media will be updated, corrected, changed or deleted, as appropriate, as soon as and to the extent reasonably and technically practicable. If you are an end user and wish to update, delete, or receive any information we have about you, you may do so by contacting the organization of which you are a customer.
If you are one of our workers or applicants, we collect information you voluntarily provide to us. We use the information collected for Human Resources purposes in order to administer benefits to workers and screen applicants. You may contact us in order to (1) update or correct your information, (2) change your preferences with respect to communications and other information you receive from us, or (3) receive a record of the information we have relating to you. Such updates, corrections, changes and deletions will have no effect on other information that we maintain, or information that we have provided to third parties in accordance with this Privacy Policy prior to such update, correction, change or deletion.
We reserve the right to transfer information to a third party in the event of a sale, merger or other transfer of all or substantially all of the assets of us or any of its Corporate Affiliates (as defined herein), or that portion of us or any of its Corporate Affiliates to which the Service relates, or in the event that we discontinue our business or file a petition or have filed against us a petition in bankruptcy, reorganization or similar proceeding, provided that the third party agrees to adhere to the terms of this Privacy Policy.
We may disclose information (including personal information) about you to our Corporate Affiliates. For purposes of this Privacy Policy, "Corporate Affiliate" means any person or entity which directly or indirectly controls, is controlled by or is under common control with us, whether by ownership or otherwise. Any information relating to you that we provide to our Corporate Affiliates will be treated by those Corporate Affiliates in accordance with the terms of this Privacy Policy.
We keep your information only so long as we need it to provide service to you and fulfill the purposes described in this policy. This is also the case for anyone that we share your information with and who carries out services on our behalf. When we no longer need to use your information and there is no need for us to keep it to comply with our legal or regulatory obligations, we'll either remove it from our systems or depersonalize it so that we can't identify you.
We implement a variety of security measures to maintain the safety of your personal information when you place an order or enter, submit, or access your personal information. We offer the use of a secure server. All supplied sensitive/credit information is transmitted via Secure Socket Layer (SSL) technology and then encrypted into our Payment gateway providers database only to be accessible by those authorized with special access rights to such systems, and are required to keep the information confidential. After a transaction, your private information (credit cards, social security numbers, financials, etc.) is never kept on file. We cannot, however, ensure or warrant the absolute security of any information you transmit to us or guarantee that your information on the Service may not be accessed, disclosed, altered, or destroyed by a breach of any of our physical, technical, or managerial safeguards.
The laws of SOUTH AFRICA, excluding its conflicts of law rules, shall govern this Agreement and your use of our service. Your use of our service may also be subject to other local, state, national, or international laws.
By using our service, registering an account, or making a purchase, you consent to this Privacy Policy.
This Privacy Policy applies only to the Services. The Services may contain links to other websites not operated or controlled by us. We are not responsible for the content, accuracy or opinions expressed in such websites, and such websites are not investigated, monitored or checked for accuracy or completeness by us. Please remember that when you use a link to go from the Services to another website, our Privacy Policy is no longer in effect. Your browsing and interaction on any other website, including those that have a link on our platform, is subject to that website's own rules and policies. Such third parties may use their own cookies or other methods to collect information about you.
We use "Cookies" to identify the areas of our website that you have visited. A Cookie is a small piece of data stored on your computer or mobile device by your web browser. We use Cookies to personalize the Content that you see on our website. Most web browsers can be set to disable the use of Cookies. However, if you disable Cookies, you may not be able to access functionality on our website correctly or at all. We never place Personally Identifiable Information in Cookies.
If we decide to change our privacy policy, we will post those changes on this page, and/or update the Privacy Policy modification date below.
We may display, include or make available third-party content (including data, information, applications and other products services) or provide links to third-party websites or services ("Third- Party Services").
You acknowledge and agree that we shall not be responsible for any Third-Party Services, including their accuracy, completeness, timeliness, validity, copyright compliance, legality, decency, quality or any other aspect thereof. We do not assume and shall not have any liability or responsibility to you or any other person or entity for any Third-Party Services.
Third-Party Services and links thereto are provided solely as a convenience to you and you access and use them entirely at your own risk and subject to such third parties' terms and conditions.
Cookies
We use Cookies to enhance the performance and functionality of our
service but are non-essential to their use. However, without these
cookies, certain functionality like videos may become unavailable or
you would be required to enter your login details every time you visit
our service as we would not be able to remember that you had logged in
previously.
Local Storage Local Storage sometimes known as DOM storage, provides web apps with methods and protocols for storing client-side data. Web storage supports persistent data storage, similar to cookies but with a greatly enhanced capacity and no information stored in the HTTP request header.
Don't hesitate to contact us if you have any questions.
Via Email: info@dawndusk.space