ChargeCalculator:CMD Version - Revision history

Crina at 01:24, 22 August 2015

2015-08-22T01:24:23Z

← Older revision		Revision as of 01:24, 22 August 2015
Line 1:		Line 1:
			The command line version of '''ACC ''' is available as an executable, meaning that it is not necessary to install it. Simply download the .zip file with the current '''ACC''' version from the '''ACC''' home page. Extract the files in the .zip to a location of your choice, which we shall refer to as ''workingFolder''. Open a terminal and run '''ACC''' in your machine according to the instructions given below.

	This is help for version 1.0.14.11.28 or newer. The help text for other versions can be viewed using the --help command when running the application.		This is help for version 1.0.14.11.28 or newer. The help text for other versions can be viewed using the --help command when running the application.
	== Running the Service ==		== Running the Service ==

Dave at 15:49, 8 December 2014

2014-12-08T15:49:18Z

Dave at 14:18, 5 December 2014

2014-12-05T14:18:23Z

← Older revision		Revision as of 14:18, 5 December 2014
Line 6:		Line 6:
	<pre>mono WebChemistry.Charges.Service.exe workingFolder configuration.json</pre>		<pre>mono WebChemistry.Charges.Service.exe workingFolder configuration.json</pre>
	Alternatively, on Linux and MacOS, an official version of .NET Framework should become available during 2015.		Alternatively, on Linux and MacOS, an official version of .NET Framework should become available during 2015.
	In Linux and MacOS, specific version of the Intel MKL library must be provider in order for the computation to run fast. See ~~http://~~http://numerics.mathdotnet.com/ for more info.		In Linux and MacOS, specific version of the Intel MKL library must be provider in order for the computation to run fast. See http://numerics.mathdotnet.com/ for more info.

	== Configuration ==		== Configuration ==

Dave: Created page with "This is help for version 1.0.14.11.28 or newer. The help text for other versions be viewed using the --help command when running the application. == Running the Service == The..."

2014-12-05T14:16:42Z

Created page with "This is help for version 1.0.14.11.28 or newer. The help text for other versions be viewed using the --help command when running the application. == Running the Service == The..."

New page

This is help for version 1.0.14.11.28 or newer. The help text for other versions be viewed using the --help command when running the application.
== Running the Service ==
The service can be executed using the command (latest .NET Framework required):
<pre>WebChemistry.Charges.Service.exe workingFolder configuration.json</pre>
In Linux (where available) and MacOS, the latest version the Mono Framework (http://mono-project.com/) must be used to run the application:
<pre>mono WebChemistry.Charges.Service.exe workingFolder configuration.json</pre>
Alternatively, on Linux and MacOS, an official version of .NET Framework should become available during 2015.
In Linux and MacOS, specific version of the Intel MKL library must be provider in order for the computation to run fast. See http://http://numerics.mathdotnet.com/ for more info.

== Configuration ==
The configuration is specified using the JSON format.

=== Configuration Example ===
This is the general shape of the JSON input configuration.
<pre>{
"InputFolder": "c:\\Data\\Structures",
"SetsXmlFilename": "c:\\Data\\DefaultSets.xml",
"ExportUncompressed": false,
"Sets": [
{
"Name": "RS2-EX",
"Method": "EemCutoffCover",
"Precision": "Double",
"CutoffRadius": 13.0,
"CorrectCutoffTotalCharge": true,
"IgnoreWaters": false
},
{
"Name": "RS2-E",
"Method": "Eem",
"Precision": "Double",
"CutoffRadius": 0.0,
"CorrectCutoffTotalCharge": true,
"IgnoreWaters": false
}
],
"Jobs": [
{
"Id": "1tqn",
"TotalCharges": [
-6.0
]
},
{
"Id": "1e12",
"TotalCharges": [
60.0
]
}
],
"MaxFullEemAtomCount": 30000,
"MaxDegreeOfParallelism": 8
}</pre>

There has to be exactly one configuration file for each validation run. Every value, as well as settings' names, is surrounded in quotation marks (" " or ' '). Backslashes (\) have to be escaped (\\). File system paths can be absolute as well as relative (/ works as well in paths).

=== Attributes ===
* '''InputFolder''' [ String ]
: ''Path to a folder containing the input data.''

* '''SetsXmlFilename''' [ String ]
: ''Path to a file containing the parameter sets.''

* '''ExportUncompressed''' [ Boolean ]
: ''If true, the output will not be compressed in ZIP.''

* '''Sets''' [ [[#SetConfig_details|SetConfig]] ]
: ''A list of sets that will be computed.''

* '''Jobs''' [ [[#Job_details|Job]] ]
: ''A list of job that need to be computed.''

* '''MaxFullEemAtomCount''' [ Int32 ], Default value = 30000
: ''A maximum number of atoms a molecule can have to be eligible for the 'Eem' method. 30000 atoms molecule consumes about 8GB of memory using the Double precision.''

* '''MaxDegreeOfParallelism''' [ Int32 ], Default value = 8
: ''Maximum number of a parallel tasks that can be executed simultaneously. Recommended to be set to the number of cores your system has.''

=== Descriptions ===
===== SetConfig =====
* '''Name''' [ String ]
: ''The name of the set.''

* '''Method''' [ ChargeComputationMethod ]
: ''Computation method.''
: ''Available values are: Eem, EemCutoff, EemCutoffCoalesceH, EemCutoffCover, Reference.''

* '''Precision''' [ ChargeComputationPrecision ]
: ''Precision (Double is 64bit, Single is 32bit).''
: ''Available values are: Double, Single.''

* '''CutoffRadius''' [ Double ]
: ''Cutoff radius parameter for methods that require it.''

* '''CorrectCutoffTotalCharge''' [ Boolean ], Default value = true
: ''Determines whether to adjust the total charge during the cutoff computations.''

* '''IgnoreWaters''' [ Boolean ]
: ''Determines whether to ignore water atoms or not.''

===== Job =====
* '''Id''' [ String ]
: ''Id of the job is the filename of the molecule without extension.''

* '''TotalCharges''' [ Double[] ]
: ''A list of total charges that need to be computed.''

== Output Description ==

=== General Structure ===
* '''[WorkingDirectory]''' - ''Working directory of the application.''
:* '''result''' - ''Contains the result of the computation.''
:: log.txt - ''Contains the console output of the application.''
:: status.json - ''Contains general information of the computation (running time, version, etc.).''

=== Charges Specific Structure ===
* '''result''' - ''Folder with computation result.''
:* '''charges''' - ''Folder with computed charges''
::* '''<source>''' - ''A folder for each charge source''
:::* '''mol2''' - ''Folder with structures in MOL2 format''
:::* '''pqr''' - ''Folder with structures in PQR format''
:::* '''wprop''' - ''Folder with results in WPROP format - a list of pairs of atom serial numbers and values of atomic charges <Atom Id> <Charge>''
:::* '''computation_setup.json''' - ''File describing the setup of the calculation''
::: <molecule>_allcharges.csv - ''CSV file for each molecule with all computed charges''
:* '''statistics''' - ''Folder with statistics about the computed charges''
::* '''Atoms''' - ''Statistics data for each molecule, calculated at atomic level resolution]''
:::* '''mol2''' - ''Folder with structures in MOL2 format''
:::* '''csv''' - ''Folder - for each molecule, a CSV file with all computed atomic charges''
:::* '''correlations''' - ''Folder - for each molecule, a CSV file with correlation statistics between all computed atomic charges''
:::* '''properties''' - ''Folder with statistics based on several specific properties of atoms''
::* '''Residues''' - ''Statistics data for each molecule, calculated at the residue level resolution - only present if the input file contained relevant residue information''
:::* '''mol2''' - ''Folder with mock structures in MOL2 format, where each atom represents a single residue''
:::* '''csv''' - ''Folder - for each molecule, a CSV file with all computed residue charges''
:::* '''correlations''' - ''Folder - for each molecule, a CSV file with correlation statistics between all computed residue charges''
:::* '''properties''' - ''Folder with statistics based on several specific properties of residues''
:* '''json''' - ''All data for each molecule in JSON format''
::: <molecule>.json - ''Entry for each molecule''
:* '''logs/''' - ''Folder with computation logs''
::: <molecule>_log.csv - ''A log entry for each molecule that includes execution time, warnings, etc.''
:: Sets.xml - ''Parameter sets used for the computation''
:: Summary_<date:year-month-day>_<time:hour-minute>.json - ''Summary information about the entire computation, date/time is in universal time''

=== Specific File Descriptions ===
This section contains detailed descriptions of selected specific files.
==== json folder ====
JSON files from this folder can be deserialized to the type `WebChemistry.Charges.Service.DataModel.ChargesServiceStructureData` available in the .NET library WebChemistry.Charges.Service.DataModel.dll included with the program.

← Older revision		Revision as of 15:49, 8 December 2014
Line 1:		Line 1:
	This is help for version 1.0.14.11.28 or newer. The help text for other versions be viewed using the --help command when running the application.		This is help for version 1.0.14.11.28 or newer. The help text for other versions can be viewed using the --help command when running the application.
	== Running the Service ==		== Running the Service ==
	The service can be executed using the command (latest .NET Framework required):		The service can be executed using the command (latest .NET Framework required):
Line 6:		Line 6:
	<pre>mono WebChemistry.Charges.Service.exe workingFolder configuration.json</pre>		<pre>mono WebChemistry.Charges.Service.exe workingFolder configuration.json</pre>
	Alternatively, on Linux and MacOS, an official version of .NET Framework should become available during 2015.		Alternatively, on Linux and MacOS, an official version of .NET Framework should become available during 2015.
	In Linux and MacOS, specific version of the Intel MKL library must be ~~provider~~ in order for the computation to run fast. See http://numerics.mathdotnet.com/ for more info.		In Linux and MacOS, specific version of the Intel MKL library must be provided in order for the computation to run fast. See http://numerics.mathdotnet.com/ for more info.

	== Configuration ==		== Configuration ==
Line 75:		Line 75:

	* '''MaxDegreeOfParallelism''' [ Int32 ], Default value = 8		* '''MaxDegreeOfParallelism''' [ Int32 ], Default value = 8
	: ''Maximum number of a parallel tasks that can be executed simultaneously. Recommended to be set to the number of cores your system has.''		: ''Maximum number of parallel tasks that can be executed simultaneously. Recommended to be set to the number of cores your system has.''

	=== Descriptions ===		=== Descriptions ===
Line 113:		Line 113:
	* '''[WorkingDirectory]''' - ''Working directory of the application.''		* '''[WorkingDirectory]''' - ''Working directory of the application.''
	:* '''result''' - ''Contains the result of the computation.''		:* '''result''' - ''Contains the result of the computation.''
	:: log.txt - ''Contains the console output of the application.''		:: '''log.txt''' - ''Contains the console output of the application.''
	:: status.json - ''Contains general information of the computation (running time, version, etc.).''		:: '''status.json''' - ''Contains general information of the computation (running time, version, etc.).''

	=== Charges Specific Structure ===		=== Charges Specific Structure ===
Line 124:		Line 124:
	:::* '''wprop''' - ''Folder with results in WPROP format - a list of pairs of atom serial numbers and values of atomic charges <Atom Id> <Charge>''		:::* '''wprop''' - ''Folder with results in WPROP format - a list of pairs of atom serial numbers and values of atomic charges <Atom Id> <Charge>''
	:::* '''computation_setup.json''' - ''File describing the setup of the calculation''		:::* '''computation_setup.json''' - ''File describing the setup of the calculation''
	::: <molecule>_allcharges.csv - ''CSV file for each molecule with all computed charges''		::: '''<molecule>_allcharges.csv''' - ''CSV file for each molecule with all computed charges''
	:* '''statistics''' - ''Folder with statistics about the computed charges''		:* '''statistics''' - ''Folder with statistics about the computed charges''
	::* '''Atoms''' - ''Statistics data for each molecule, calculated at atomic level resolution]''		::* '''Atoms''' - ''Statistics data for each molecule, calculated at atomic level resolution''
	:::* '''mol2''' - ''Folder with structures in MOL2 format''		:::* '''mol2''' - ''Folder with structures in MOL2 format''
	:::* '''csv''' - ''Folder - for each molecule, a CSV file with all computed atomic charges''		:::* '''csv''' - ''Folder - for each molecule, a CSV file with all computed atomic charges''
Line 137:		Line 137:
	:::* '''properties''' - ''Folder with statistics based on several specific properties of residues''		:::* '''properties''' - ''Folder with statistics based on several specific properties of residues''
	:* '''json''' - ''All data for each molecule in JSON format''		:* '''json''' - ''All data for each molecule in JSON format''
	::: <molecule>.json - ''Entry for each molecule''		::: '''<molecule>.json''' - ''Entry for each molecule''
	:* '''logs/''' - ''Folder with computation logs''		:* '''logs''' - ''Folder with computation logs''
	::: <molecule>_log.csv - ''A log entry for each molecule that includes execution time, warnings, etc.''		::: '''<molecule>_log.csv ''' - ''A log entry for each molecule that includes execution time, warnings, etc.''
	:: Sets.xml - ''Parameter sets used for the computation''		:: '''Sets.xml''' - ''Parameter sets used for the computation''
	:: Summary_<date:year-month-day>_<time:hour-minute>.json - ''Summary information about the entire computation, date/time is in universal time''		:: '''Summary_<date:year-month-day>_<time:hour-minute>.json''' - ''Summary information about the entire computation, date/time is in universal time''

	=== Specific File Descriptions ===		=== Specific File Descriptions ===