Human2opspec.m - Revision history

Kuprov: sync with Spinach main f053e432: add master syntax line, Parameters heading

2026-08-30T05:52:36Z

sync with Spinach main f053e432: add master syntax line, Parameters heading

Kuprov: Update function See also links and function index membership

2026-06-06T18:37:45Z

Update function See also links and function index membership

Kuprov: Spot-update function page against current Spinach source

2026-06-05T14:53:49Z

Spot-update function page against current Spinach source

Kuprov: Normalise sequential blank lines

2026-04-25T11:26:15Z

Normalise sequential blank lines

Kuprov: Restore pre-bulk-edit wiki content

2026-04-05T14:49:04Z

Restore pre-bulk-edit wiki content

Kuprov: Sync syntax/arguments/outputs with current Spinach source

2026-04-05T14:03:23Z

Sync syntax/arguments/outputs with current Spinach source

Kuprov at 14:34, 28 July 2023

2023-07-28T14:34:03Z

Kuprov: /* See also */

2023-07-28T14:24:55Z

‎See also

Kuprov at 14:24, 28 July 2023

2023-07-28T14:24:27Z

Kuprov: /* Syntax */

2018-08-17T13:26:27Z

‎Syntax

← Older revision		Revision as of 05:52, 30 August 2026
Line 3:		Line 3:

	==Syntax==		==Syntax==
		+
		+	[opspecs,coeffs]=human2opspec(spin_system,operators,spins)
		+
		+	==Parameters==
	The function supports three types of syntax:		The function supports three types of syntax:

@@ Line 36: / Line 36: @@
 ==See also==
-[[operator.m]], [[state.m]], [[equilibrium.m]], [[coherence.m]], [[correlation.m]], [[singlet.m]]
+[[operator.m]], [[state.m]], [[equilibrium.m]], [[coherence.m]], [[correlation.m]], [[singlet.m]], [[adelim.m]], [[dfpt.m]], [[homospoil.m]], [[lin2lm.m]], [[lin2lmn.m]], [[lm2lin.m]], [[lmn2lin.m]], [[path_trace.m]], [[scomponents.m]], [[sinkhole.m]], [[sparse2csr.m]], [[sphten2zeeman.m]], [[stitch.m]], [[zte.m]], [[Kernel_utilities]], [[Kernel_functions]]
 ''Version 2.8, authors: [[Luke Edwards]], [[Ilya Kuprov]]''

@@ Line 9: / Line 9: @@
         [opspecs,coeffs]=human2opspec(spin_system,'Lz','13C')
-the function returns a list of single-spin opspecs for all spins with the specified name. In the example above, the list of Lz operator specifications for all 13C nuclei in the system would be returned. Valid labels for operators in this type of call are 'E' (identity), 'Lz', 'Lx', 'Ly', 'L+', 'L-', and 'Tl,m' (irreducible spherical tensor, l and m are integers). Valid labels for the spins are standard isotope names as well as 'electrons', 'nuclei', and 'all'.
+the function returns a list of single-spin opspecs for all spins with the specified name. In the example above, the list of Lz operator specifications for all 13C nuclei in the system would be returned. Valid labels for operators in this type of call are 'E' (identity), 'Lz', 'Lx', 'Ly', 'L+', 'L-', 'Tl,m' (irreducible spherical tensor, l and m are integers), 'CTx', 'CTy', 'CTz', 'CT+', and 'CT-' (central transition operators in the Zeeman basis). Valid labels for the spins are standard isotope names as well as 'electrons', 'nuclei', and 'all'.
 '''2. If one input is a string and the other is a vector'''

← Older revision		Revision as of 11:26, 25 April 2026
Line 41:		Line 41:

	[[Kernel_functions#Elementary_states\|Elementary states]]		[[Kernel_functions#Elementary_states\|Elementary states]]
−

	''Version 2.8, authors: [[Luke Edwards]], [[Ilya Kuprov]]''		''Version 2.8, authors: [[Luke Edwards]], [[Ilya Kuprov]]''

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:human2opspec.m}} __NOTOC__
 Converts user-friendly descriptions of spin states and operators into the formal operator and state description used by ''Spinach'' kernel.
 ==Syntax==
-[opspecs,coeffs]=human2opspec(spin_system,operators,spins)
+'''2. If one input is a string and the other is a vector'''
 ==Outputs==
-opspecs    - Spinach operator specification: a cell array of
+    opspecs    - Spinach operator specification: a cell array of
                   row vectors specifying which operator enters the
                   Kronecker product for which spin.
@@ Line 17: / Line 33: @@
 ==Notes==
 Direct calls to this function should not be necessary, use [[operator.m]] and [[state.m]] functions instead.
 ==See also==
 [[operator.m]], [[state.m]], [[equilibrium.m]], [[coherence.m]], [[correlation.m]], [[singlet.m]]

@@ Line 5: / Line 5: @@
 The function supports three types of syntax:
-. If both inputs are strings, ''e.g.''
+'''1. If both inputs are strings'''
         [opspecs,coeffs]=human2opspec(spin_system,'Lz','13C')
-the function returns a list of single-spin opspecs for all spins with the specified name. In the example above, the list of Lz operator specifications for all 13C nuclei in the system would be returned. Valid labels for operators in this type of call are 'E', 'Lz', 'L+', 'L-' and 'Tl,m'. In the latter case, l and m are integers. Valid labels for the spins are standard isotope names as well as 'electrons', 'nuclei', 'all'.
+the function returns a list of single-spin opspecs for all spins with the specified name. In the example above, the list of Lz operator specifications for all 13C nuclei in the system would be returned. Valid labels for operators in this type of call are 'E' (identity), 'Lz', 'Lx', 'Ly', 'L+', 'L-', and 'Tl,m' (irreducible spherical tensor, l and m are integers). Valid labels for the spins are standard isotope names as well as 'electrons', 'nuclei', and 'all'.
-. If one input is a string and the other is a vector, ''e.g.''
+'''2. If one input is a string and the other is a vector'''
         [opspecs,coeffs]=human2opspec(spin_system,'Lz',[1 2 4])
-the function returns a list of single-spin opspecs for all spins with the specified number. In the example above, the list of Lz operator specifications for all 13C nuclei in the system would be returned. Valid labels for operators in this type of call are 'E', 'Lz', 'L+', 'L-' and 'Tl,m'. In the latter case, l and m are integers.
+the function returns a list of single-spin opspecs for all spins with the specified number. In the example above, the list of Lz operator specifications for all 13C nuclei in the system would be returned. Valid labels for operators are the same as in Item 1 above.
-. If the two inputs are a cell array of strings and a cell array of numbers respectively, a product operator specification is produced, ''e.g.''
+'''3. If the two inputs are a cell array of strings and a cell array of numbers'''
-        [opspecs,coeffs]=human2opspec(spin_system,{'Lz','L+'},{1,2})
+        [opspecs,coeffs]=human2opspec(spin_system,{'Lz','Ly'},{1,2})
-would return the Lz(x)L+ product operator specification with Lz on spin 1 and L+ on spin 2. Valid labels for operators in the cell array are 'E', 'Lz', 'L+', 'L-' and 'Tl,m'. In the latter case, l and m are integers.
+would return the Lz(x)Ly product operator specification with Lz on spin 1 and Ly on spin 2. Valid labels for operators are the same as in Item 1.
 ==Outputs==
-     opspecs    - ''Spinach'' operator specification: a cell array of
+     opspecs    - Spinach operator specification: a cell array of
                   row vectors specifying which operator enters the
                   Kronecker product for which spin.

← Older revision		Revision as of 14:24, 28 July 2023
Line 38:		Line 38:
	[[operator.m]], [[state.m]], [[equilibrium.m]], [[coherence.m]], [[correlation.m]], [[singlet.m]]		[[operator.m]], [[state.m]], [[equilibrium.m]], [[coherence.m]], [[correlation.m]], [[singlet.m]]

		+	[[Kernel_functions#Elementary_operators\|Elementary operators]]

−	''Version 2.2, authors: [[Luke Edwards]], [[Ilya Kuprov]]''	+	[[Kernel_functions#Elementary_states\|Elementary states]]
		+
		+
		+	''Version 2.8, authors: [[Luke Edwards]], [[Ilya Kuprov]]''

← Older revision		Revision as of 14:24, 28 July 2023
Line 1:		Line 1:
−	{{DISPLAYTITLE:human2opspec.m}}	+	{{DISPLAYTITLE:human2opspec.m}} __NOTOC__
	Converts user-friendly descriptions of spin states and operators into the formal operator and state description used by ''Spinach'' kernel.		Converts user-friendly descriptions of spin states and operators into the formal operator and state description used by ''Spinach'' kernel.