Microscope Commands Documentation

Microscope Control Software version 3.1.3.73

JSON command protocol
TCP/IP port: 16951
Message format: message length (4 bytes, int32) followed by JSON message, then raw data length (4 bytes, int32) followed by raw data (if any)

Field	Type/Value	Description	Required	Default
Common for all components
Common	command	Represent a command that can be executed on a source.
ComponentName	string	Name of the component to which command is addressed.	Yes
CommandName	string	Name of the command.	Yes
	response
Success	bool	Indicates if command was successful.	Yes
ErrorMessage	string	Error message describing command error.	Yes
Time	double?	Time in ms it took to execute command or null if unknown.	Yes
Data	byte array	Additional raw data returned by the command, e.g. for image data or other large binary data. This should not be serialized in the JSON message.	Yes

Ping	command	Ping to check that component is able to receive commands.
	response

Common for all devices
Connect	command	Connect microscope to the device.
	response

Disconnect	command	Disconnect microscope from device.
	response

Ping	command	Ping to check that component is able to receive commands.
	response

WaitReady	command	Wait for a device to be ready.
	response

AcquisitionController
Acquire	command	Generate acquisition controller signals.
IlluminationSettings	string	Name of the illumination settings to use.	Yes
ExposureSettings	string	Name of the exposure settings to use.	Yes
	response

GetTiltFactors	command	Get the tilt factors associated with the current objective block.
	response
Illumin1TiltFactor	double	The factor of scanner 1 to tilt the scan plane for illumination 1.	Yes
Illumin2TiltFactor	double	The factor of scanner 1 to tilt the scan plane for illumination 2.	Yes

SaveTiltFactors	command	Save the tilt factors associated with the current objective block to persistent storage.
	response

SetTiltFactors	command	Set the tilt factors associated with the current objective block.
Illumin1TiltFactor	double?	The new factor of scanner 1 to tilt the scan plane for illumination 1 or null to keep the current value.	No	null
Illumin2TiltFactor	double?	The new factor of scanner 1 to tilt the scan plane for illumination 2 or null to keep the current value.	No	null
	response

Camera
DisplayedViewSet	command	Set the displayed view in image viewer.
View	int	The index of the view to display, one based.	Yes
	response

GetMaxProjection	command	Get the maximum intensity projection of the image across a specified dimension (Z, Y, or X). Image data should be included as raw data.
ProjectionType	string	Primary axis used to compute the maximum-intensity projection ("Z", "Y", or "X").	No	"Z"
TimePoint	int?	The time point to get max projection for (1 based), null to get last time point acquired.	No	null
SettingsProfile	string	The settings profile to get max projection for, null to get last settings profile acquired.	No	null
Position	string	The position to get max projection for, null to get last position acquired.	No	null
TileId	list of 2 integers?	The tile ID to get max projection for (1 based), null to get last tile ID acquired.	No	null
ViewIndex	int	The index of the view to get max projection for (1 based).	No	1
ChannelIndex	int	The index of the channel to get max projection for (1 based).	No	1
Left	int?	For cropping: the index of the left most pixel to get (0 based), null to center.	No	null
Top	int?	For cropping: the index of the top most pixel to get (0 based), null to center.	No	null
Width	int?	For cropping: the width of the image in pixels, null to get full width.	No	null
Height	int?	For cropping: the height of the image in pixels, null to get full height.	No	null
	response

GetSensorInfo	command	Get sensor information.
	response
Width	int	Width of the sensor in pixels.	Yes
Height	int	Height of the sensor in pixels.	Yes
Temperature	double?	Current temperature of the sensor in degree Celsius if available.	No	null

ImageGet	command	Get an image from the current experiment. Image data should be included as raw data.
TimePoint	int?	The time point to get image for (1 based), null to get last time point acquired.	No	null
SettingsProfile	string	The settings profile to get image for, null to get last settings profile acquired.	No	null
Position	string	The position to get image for, null to get last position acquired.	No	null
TileId	list of 2 integers?	The tile ID to get image for (1 based), null to get last tile ID acquired.	No	null
Plane	int	The index of the plane to get image for (1 based).	No	1
ViewIndex	int	The index of the view to get image for (1 based).	No	1
ChannelIndex	int	The index of the channel to get image for (1 based).	No	1
Left	int?	For cropping: the index of the left most pixel to get (0 based), null to center.	No	null
Top	int?	For cropping: the index of the top most pixel to get (0 based), null to center.	No	null
Width	int?	For cropping: the width of the image in pixels, null to get full width.	No	null
Height	int?	For cropping: the height of the image in pixels, null to get full height.	No	null
	response
Width	int	Width of the image.	Yes
Height	int	Height of the image.	Yes

ImageInfoGet	command	Get info on imaging setup.
	response
Width	int	Width of the image in pixels.	Yes
Height	int	Height of the image in pixels.	Yes
Planes	int	Number of planes.	Yes
Channels	int	Number of channels.	Yes
Views	int	Number of views.	Yes
Position	string	Name of position (or null if not known).	Yes
Settings	string	Name of settings.	Yes
TimePoint	int?	Time point starting at 1.	Yes
VoxelX	double?	Size of Voxel X in um.	Yes
VoxelY	double?	Size of Voxel Y in um.	Yes
VoxelZ	double?	Size of Voxel Z in um (or null if no stack).	Yes
NumericalAperture	double	Numerical aperture of objective.	Yes

OffsetGet	command	Get offset between camera views.
	response
OffsetX	int	The offset between views along X-axis.	Yes
OffsetY	int	The offset between views along Y-axis.	Yes

OffsetSet	command	Set the offset between camera views.
OffsetX	int	The offset between views along X-axis.	Yes
OffsetY	int	The offset between views along Y-axis.	Yes
	response

FilterWheel
Move	command	Move filter wheel to specified filter.
FilterName	string	Name of the filter settings to move device to.	Yes
Force	bool	Whether to force the filter wheel to move (even if already at correct position).	No	false
	response

MoveTo	command	Move filter wheel to specified position.
Position	int	Position to move the device to.	Yes
Force	bool	Whether to force the filter wheel to move (even if already at correct position).	No	false
	response

IlluminationModule
ClearRotationRange	command	Clear the rotation range associated with the current immersion medium. The modified alignment are not persistent, unless the update command is also sent.
Name	string	Name of the illumination settings to set.	Yes
	response

CurrentIlluminationGet	command	Get values currently applied on the hardware.
	response
Name	string	Name of illumination settings.	Yes
TranslationX	double	The translation along X-axis in um.	Yes
RotationX	double	The rotation along X-axis in degrees.	Yes
TranslationZ	double	The translation along Z-axis in um.	Yes
RotationZ	double	The rotation along Z-axis in degrees.	Yes

GetIlluminationList	command	Get the list of illumination settings.
	response
Names	list of string	The names of the illumination settings.	Yes

GetObjectiveBlockAlignment	command	Get the objective block alignment associated with the current immersion medium.
Name	string	Name of the illumination settings to get.	Yes
	response
Name	string	Name of illumination settings.	Yes
ImmersionMedium	string	The name of the immersion medium.	Yes
TranslationX	double	The translation along X-axis in um.	Yes
RotationX	double	The rotation along X-axis in degrees.	Yes
MinRotationX	double?	The minimum rotation along X-axis in degrees for pivoting.	Yes
MaxRotationX	double?	The maximum rotation along X-axis in degrees for pivoting.	Yes
TranslationZ	double	The translation along Z-axis in um.	Yes
RotationZ	double	The rotation along Z-axis in degrees.	Yes

IlluminationGet	command	Get current illumination settings.
Name	string	Name of the illumination settings to get.	Yes
	response
Name	string	Name of illumination settings.	Yes
TranslationX	double	The translation along X-axis in um.	Yes
RotationX	double	The rotation along X-axis in degrees.	Yes
TranslationZ	double	The translation along Z-axis in um.	Yes
RotationZ	double	The rotation along Z-axis in degrees.	Yes

IlluminationSet	command	Set the illumination settings.
Name	string	Name of the illumination settings to set.	Yes
TranslationX	double?	The translation along X-axis or null to keep original value.	No	null
RotationX	double?	The rotation along X-axis or null to keep original value.	No	null
TranslationZ	double?	The translation along Z-axis or null to keep original value.	No	null
RotationZ	double?	The rotation along Z-axis or null to keep original value.	No	null
SetDevice	bool	Whether to apply the new settings on device.	No	false
	response

OffsetBaseGet	command	Get base offset values.
	response

OffsetsBaseSet	command	Set base offsets, all current settings are overwritten.
OffsetsBase	list of dict	The list of base offsets. Keys of dict listed below.	Yes
Branch	int	Unique number of illumination branch (value 1, 2 or 3).	Yes
Scanner1Offset	double	Voltage on scanner 1.	Yes
Scanner2Offset	double	Voltage on scanner 2.	Yes
Scanner3Offset	double	Voltage on scanner 3.	Yes
Scanner4Offset	double	Voltage on scanner 4.	Yes
	response

PositionAlignmentGet	command	Get position specific Z-alignment.
Name	string	Name of the position alignment settings to get.	Yes
	response
Name	string	Name of the position.	Yes
TranslationZ	double	Translation along Z-axis.	Yes
Enable	bool	Whether the alignment is applied.	Yes

PositionAlignmentSet	command	Set position specific Z-alignment and enable the position.
Name	string	Name of the position alignment settings to set.	Yes
TranslationZ	double?	Translation along Z-axis to set or null to keep original value.	No	null
Enable	bool?	Enable to set or null to keep original value.	No	null
	response

SetObjectiveBlockAlignment	command	Set the objective block alignment associated with the current immersion medium. The modified alignment are not persistent, unless the update command is also sent.
Name	string	Name of the illumination settings to set.	Yes
TranslationX	double?	The translation in X in um to apply. If null, keep the current value.	No	null
RotationX	double?	The rotation in X in degrees to apply. If null, keep the current value.	No	null
MinRotationX	double?	The minimum rotation in X in degrees to apply for pivoting. If null, keep the current value.	No	null
MaxRotationX	double?	The maximum rotation in X in degrees to apply for pivoting. If null, keep the current value.	No	null
TranslationZ	double?	The translation in Z in um to apply. If null, keep the current value.	No	null
RotationZ	double?	The rotation in Z in degrees to apply. If null, keep the current value.	No	null
	response

UpdateObjectiveBlockAlignment	command	Update the objective block alignment associated with the current immersion medium based on the current alignment of the given illumination. The updated alignment are persistent.
IlluminationName	string	Name of the illumination settings to update, if null, update all illuminations.	No	null
	response

System
Authenticate	command	Authenticate to the system with a secret key to start a session.
AuthenticationSecretKey	string	The authentication secret key. Software must have been started once to generate this key.	Yes
	response

GetComponentList	command	Get a list of names and types of components connected to the microscope.
	response
ComponentNames	list of string	List of component names.	Yes
ComponentTypes	list of string	List of component types.	Yes

GetComponentType	command	Get the type of a component.
QueryComponentName	string	The name of the component to get the type for.	Yes
	response
ComponentType	string	Type of the component.	Yes

SaveAllSettings	command	Save all settings of the application to a directory.
Directory	string	The directory to save the settings to.	Yes
	response

ObjectiveBlock
GetObjectiveBlockInfo	command	Get the current information about the objective block.
	response
ObjectiveBlock	string	The name of the objective block currently used.	Yes
Objective	string	The name of the objective used.	Yes
IsMultiImmersion	bool	Whether the objective supports multiple immersion media.	Yes
Views	enum	The available views for the current objective. Possible values listed below.	Yes
View1	string	View 1	-
View2	string	View 2	-
View1And2	string	View 1 and 2	-
IlluminationMagnification	double	The effective magnification of the illumination objective, taking into account the current immersion medium refractive index.	Yes
DetectionMagnification	double	The effective magnification of the detection objective, taking into account the current immersion medium refractive index.	Yes
DetectionNumericalAperture	double	The effective numerical aperture of the detection objective, taking into account the current immersion medium refractive index.	Yes
ImmersionMedium	string	The current immersion medium.	Yes
RefractiveIndex	double	The refractive index of the current immersion medium.	Yes

SetShading	command	Set the shading information for the current immersion medium.
ShadingCorrectionFactors	list of dict	The shading correction factors for each view. The factors allow the reconstruction of a polynomial function that maps the measured intensity to the corrected intensity. Keys of dict listed below.	Yes
C	double	The constant term.	Yes
HL	double	The horizontal linear coefficient.	Yes
VL	double	The vertical linear coefficient.	Yes
TQ	double	The tilted quadratic coefficient.	Yes
HQ	double	The horizontal quadratic coefficient.	Yes
VQ	double	The vertical quadratic coefficient.	Yes
	response

Photomanipulation
GetPosition	command	Get position settings of a photomanipulation.
Name	string	Name of the position settings.	Yes
	response
Name	string	Name of the position settings.	Yes
OffsetX	double	The offset from position center along X axis in micrometers.	Yes
OffsetY	double	The offset from position center along Y axis in micrometers.	Yes
OffsetZ	double	The offset from position center along Z axis in micrometers.	Yes
Region	string	The name of the region settings associated with the position.	Yes

GetPositionNames	command	Get the list of position names.
	response
Names	list of string	List of position names.	Yes

GetRegion	command	Get region settings.
Name	string	Name of the region settings.	Yes
	response
Name	string	Name of the region settings.	Yes
Type	enum	The region type. Possible values listed below.	Yes
Point	string	Point region.	-
Line	string	Line region.	-
Rectangle	string	Rectangle region.	-
Ellipse	string	Ellipse region.	-
Width	double	The width of the region in micrometers.	Yes
Height	double	The height of the region in micrometers.	Yes
StepSize	double	The step size for the region in micrometers.	Yes
Rotation	double	The rotation of the region in degree.	Yes
ExposureTime	int	The exposure time for the region in milliseconds.	Yes
Repetitions	int	The number of repetitions for the region.	Yes

GetRegionNames	command	Get the list of region settings names.
	response
Names	list of string	List of region names.	Yes

OffsetsBaseGet	command	Get base offset values from photomanipulation laser.
	response
OffsetsBase	dict	The base offsets. Keys of dict listed below.	Yes
Scanner1Offset	double	Voltage on scanner 1 (closest to scan lens).	Yes
Scanner2Offset	double	Voltage on scanner 2.	Yes
Scanner3Offset	double	Voltage on scanner 3.	Yes
Scanner4Offset	double	Voltage on scanner 4 (furthest from scan lens).	Yes

OffsetsBaseSet	command	Set base offsets for photomanipulation laser, all current settings are overwritten.
OffsetsBase	dict	The baser offsets. Keys of dict listed below.	Yes
Scanner1Offset	double	Voltage on scanner 1 (closest to scan lens).	Yes
Scanner2Offset	double	Voltage on scanner 2.	Yes
Scanner3Offset	double	Voltage on scanner 3.	Yes
Scanner4Offset	double	Voltage on scanner 4 (furthest from scan lens).	Yes
	response

SetPosition	command	Set position settings of a photomanipulation.
Name	string		Yes
OffsetX	double?	The offset from position center along X axis in micrometers to set or null to keep original value.	No	null
OffsetY	double?	The offset from position center along Y axis in micrometers to set or null to keep original value.	No	null
OffsetZ	double?	The offset from position center along Z axis in micrometers to set or null to keep original value.	No	null
Region	string	The name of the region settings associated with the position to set or null to keep original value.	No	null
ApplyNow	bool	Whether to apply the changes immediately. While the time-lapse is running, changes are normally applied at the next time point.	No	false
	response

SetRegion	command	Set region settings.
Name	string	The name of the region settings to update.	Yes
NewName	string	The new name of the region settings or null to keep original value.	No	null
Type	enum?	The region type to set or null to keep original value. Possible values listed below.	No	null
Point	string	Point region.	-
Line	string	Line region.	-
Rectangle	string	Rectangle region.	-
Ellipse	string	Ellipse region.	-
Width	double?	The width of the region in micrometers to set or null to keep original value.	No	null
Height	double?	The height of the region in micrometers to set or null to keep original value.	No	null
StepSize	double?	The step size for the region in micrometers to set or null to keep original value.	No	null
Rotation	double?	The rotation of the region in degree to set or null to keep original value.	No	null
ExposureTime	int?	The exposure time for the region in milliseconds to set or null to keep original value.	No	null
Repetitions	int?	The number of repetitions for the region to set or null to keep original value.	No	null
ApplyNow	bool	Whether to apply the changes immediately. While the time-lapse is running, changes are normally applied at the next time point.	No	false
	response

StageXYZ
ForgetCurrentPosition	command	Make stage forget position name on which it's located.
	response

GetCoordinates	command	Get current coordinates of the stage.
	response
Coordinates	list of 3 doubles	The current coordinates of the stage.	Yes

GetZStack	command	Get Z-Stack settings.
Name	string	Name of the Z-Stack settings.	Yes
	response
Name	string	Name of the Z-Stack settings.	Yes
Step	double	The step size in micrometer between each plane.	Yes
Planes	int	The number of planes of the stack.	Yes

GetZStackNames	command	Get a list of Z-Stack settings names.
	response
Names	list of string	List of Z-Stack names.	Yes

Move	command	Move stage to a position.
Name	string	Name of the position settings.	Yes
ZStackName	string	Name of the Z-stack settings to use or null to move to center.	No	null
Plane	int?	Plane of the Z-stack to move to or null to move to center.	No	null
Offset	list of 3 doubles?	List of relative X, Y, Z offsets to add to the position.	No	null
	response

MoveTo	command	Move stage to specified position.
Coordinates	list of 3 doubles	The target coordinates to move to.	Yes
MoveOrder	string	The order in which to move the axes (e.g., "XYZ", "XZY").	No	"XYZ"
	response

PositionGet	command	Get position settings.
Name	string	Name of the position settings.	Yes
	response
Name	string	Name of the position.	Yes
PositionX	double	Position on X-axis.	Yes
PositionY	double	Position on Y-axis.	Yes
PositionZ	double	Position on Z-axis.	Yes
SkipPosition	bool	Whether the position is skipped.	Yes

PositionNamesGet	command	Get a list of position names.
	response
Names	list of string	List of position names.	Yes

PositionSet	command	Set position settings.
Name	string	Name of the position settings to set.	Yes
NewName	string	The new name of the position settings or null to keep original value.	No	null
PositionX	double?	Position on X-axis to set or null to keep original value.	No	null
PositionY	double?	Position on Y-axis to set or null to keep original value.	No	null
PositionZ	double?	Position on Z-axis to set or null to keep original value.	No	null
SkipPosition	bool?	Whether to skip the position or null to keep original value.	No	null
	response

SetZStack	command	Set Z-Stack settings.
Name	string	Name of the Z-stack settings to set.	Yes
NewName	string	The new name of the Z-stack settings or null to keep original value.	No	null
Step	double?	The step size in micrometer between each plane to set or null to keep original value.	No	null
Planes	int?	The number of planes of the stack to set or null to keep original value.	No	null
	response

TimeLapseController
ContinueFromPause	command	Continue from pause after a position.
	response

GetAcquisitionSettings	command	Get acquisition settings.
	response
TimeInterval	double	The time interval in seconds between two time points.	Yes
Repetitions	int	The number of time points to acquire.	Yes
ExperimentName	string	The name of the experiment.	Yes
SettableDeviceSettings	dict (string => string)	The acquisition-related settable device settings to apply.	Yes

GetChannelSettings	command	Get the channel settings in a settings profile.
SettingsProfile	string	The name of the settings profile to get the channel settings from.	Yes
Name	string	The name of the channel settings to get.	Yes
	response
Name	string	The name of the channel settings.	Yes
Enabled	bool	Whether the channel should be acquired.	Yes
AcquireNthTimePoint	int	Interval at which the channel should be acquired. It is acquired at every specified number of time points.	Yes
Color	enum	The channel default color. Possible values listed below.	Yes
Red	string	Red color.	-
Green	string	Green color.	-
Blue	string	Blue color.	-
Cyan	string	Cyan color.	-
Magenta	string	Magenta color.	-
Yellow	string	Yellow color.	-
White	string	White color.	-
Illumination	string	The name of the illumination settings to apply on acquisition controller device.	Yes
Exposure	string	The name of the exposure settings to apply on acquisition controller device.	Yes
SettableDeviceSettings	dict (string => string)	The channel-related settable device settings to apply.	Yes

GetChannelSettingsNames	command	Get the list of channel settings names in a settings profile.
SettingsProfile	string	The name of the settings profile to get the channel settings names from.	Yes
	response
Names	list of string	List of channel settings names.	Yes

GetExperimentDirectory	command	Get the experiment directory.
	response
ExperimentDirectory	string	The experiment directory where images are being saved of the current/last time-lapse acquisition.	Yes

GetPhotomanipulationSettings	command	Get photomanipulation settings.
	response
IlluminationInternal	bool	Whether to use the internal illumination.	Yes
Illumination	string	Name of the illumination settings to apply on acquisition controller device.	Yes
IlluminationFilter	string	Name of the illumination filter to apply on acquisition controller device.	Yes
IlluminationIntensityExternal	double	The intensity (as a percentage of the maximum) of the external illumination.	No
Positions	list of string	The list of positions to photomanipulate. If null, all positions are photomanipulated. If empty, no positions are photomanipulated.	Yes
TimePoints	list of int	The list of time points to photomanipulate. If null, all time points are photomanipulated. If empty, no time points are photomanipulated.	Yes

GetSettingsProfile	command	Get a settings profile.
Name	string	The name of the settings profile to get.	Yes
	response
Name	string	The name of the settings profile.	Yes
Enabled	bool	Whether the settings profile should be acquired.	Yes
ZStack	string	The name of the Z-Stack settings to apply, single plane if null.	Yes
Positions	list of string	The list of positions to acquire. If null, all positions are acquired. If empty, no positions are acquired.	Yes
Views	enum	The view(s) to acquire. Possible values listed below.	Yes
View1	string	View 1	-
View2	string	View 2	-
View1And2	string	View 1 and 2	-
SettableDeviceSettings	dict (string => string)	The settings profile related settable device settings to apply.	Yes

GetSettingsProfileNames	command	Get the list of settings profile names.
	response
Names	list of string	List of settings profile names.	Yes

NoPauseAfterPositionAcquired	command	Disable pause after each position has been acquired (before photomanipulation).
	response

PauseAfterPositionAcquired	command	Ask time-lapse to pause after each position has been acquired (before photomanipulation).
	response

SetAcquisitionSettings	command	Set acquisition settings.
TimeInterval	double?	The time interval in seconds between two time points to set or null to keep original value.	No	null
Repetitions	int?	The number of time points to acquire to set or null to keep original value.	No	null
ExperimentName	string	The name of the experiment to set or null to keep original value.	No	null
SettableDeviceSettings	dict (string => string)	If not null, replace the defined settable device settings.	No	null
	response

SetChannelSettings	command	Set the channel settings in a settings profile.
SettingsProfile	string	The name of the settings profile to set the channel settings in.	Yes
Name	string	Name of the channel settings to set.	Yes
NewName	string	The new name of the settings profile or null to keep original value.	No	null
Enabled	bool?	Whether the channel settings should be acquired or null to keep original value.	No	null
AcquireNthTimePoint	int?	Interval at which the channel should be acquired or null to keep original value.	No	null
Color	enum?	The channel default color or null to keep original value. Possible values listed below.	No	null
Red	string	Red color.	-
Green	string	Green color.	-
Blue	string	Blue color.	-
Cyan	string	Cyan color.	-
Magenta	string	Magenta color.	-
Yellow	string	Yellow color.	-
White	string	White color.	-
Illumination	string	The name of the illumination settings to apply or null to keep original value.	No	null
Exposure	string	The name of the exposure settings to apply or null to keep original value.	No	null
SettableDeviceSettings	dict (string => string)	If not null, replace the defined settable device settings.	No	null
	response

SetPhotomanipulationSettings	command	Set photomanipulation settings.
IlluminationInternal	bool?	Whether to use the internal illumination to set or null to keep original value.	No	null
Illumination	string	Name of the illumination settings to apply on acquisition controller device to set or null to keep original value.	No	null
IlluminationFilter	string	Name of the illumination filter to apply on acquisition controller device to set or null to keep original value.	No	null
IlluminationIntensityExternal	double?	The intensity (as a percentage of the maximum) of the external illumination to set or null to keep original value.	No	null
Positions	list of string	The list of positions to photomanipulate or null to keep original value.	No	null
PositionsAll	bool?	Whether all positions should be photomanipulated or null to keep original value. If true, must be null. If false, must be defined.	No	null
TimePoints	list of int	The list of time points to photomanipulate or null to keep original value.	No	null
TimePointsAll	bool?	Whether all time points should be photomanipulated or null to keep original value. If true, must be null. If false, must be defined.	No	null
ApplyNow	bool	Whether to apply the changes immediately. While the time-lapse is running, changes are normally applied at the next time point.	No	false
	response

SetSettingsProfile	command	Set a settings profile.
Name	string	Name of the settings profile to set.	Yes
NewName	string	The new name of the settings profile or null to keep original value.	No	null
Enabled	bool?	Whether the settings profile should be acquired or null to keep original value.	No	null
ZStack	string	The name of the Z-Stack settings to apply or null to keep original value.	No	null
IsSinglePlane	bool?	Whether the settings profile should be acquired in single plane or null to keep original value. If false, must be defined. If true, must be null.	No	null
Positions	list of string	The list of positions to acquire or null to keep original value.	No	null
PositionsAll	bool?	Whether all positions should be acquired or null to keep original value. If true, must be null. If false, must be defined.	No	null
Views	enum?	The view(s) to acquire or null to keep original value. Possible values listed below.	No	null
View1	string	View 1	-
View2	string	View 2	-
View1And2	string	View 1 and 2	-
SettableDeviceSettings	dict (string => string)	If not null, replace the defined settable device settings.	No	null
	response

Snap	command	Snap an image.
Illumination1	bool?	If not null override user settings and enable or disable illumination 1.	No	null
Illumination2	bool?	If not null override user settings and enable or disable illumination 2.	No	null
ExposureTime	int?	If not null override user settings and set the exposure time in milliseconds.	No	null
ScanRange	int?	If not null override user settings and set the scan range in micrometers.	No	null
ScanFullFOV	bool?	If not null override user settings and set whether to scan the full field of view.	No	null
Views	enum?	If not null override user settings and set the view(s) to acquire. Possible values listed below.	No	null
View1	string	View 1	-
View2	string	View 2	-
View1And2	string	View 1 and 2	-
SettableDeviceSettings	dict (string => string)	If not null override user settings and set the defined settable device.	No	null
Fast	bool	Whether to bypass setting of settable devices (for example filter wheels will not move to defined settings).	No	false
	response

Start	command	Start a time-lapse.
	response

Stop	command	Stop time-lapse.
	response

WaitForPause	command	Wait until time-lapse controller is paused after a position.
Timeout	int	Waiting timeout in ms, -1 to wait indefinitely.	No	-1
	response
Position	string	Position which was paused.	Yes
TimePoint	int	Time point which was paused.	Yes
Timeout	bool	True if timeout, if paused false	Yes