Python command: Data DMS

Syntax

Example

Description/Remarks

New or changed in GainSeeker version

datadms.autocreatedefects

datadms.autocreatedefects = True

If True, defects that do not exist in the master defect list are created and added to the list when a defect is set using datadms.setdefect. Defaults to False. Possible values are True or False.

datadms.autosumncu

datadms.autosumncu = True

If True, the value of datadms.ncu is set to datadms.sumdefects, The default is determined in configuration settings.

datadms.clear()

datadms.clear()

Clears all fields. It does not affect database records that are already stored.

datadms.createdefect(name, cost=None)

datadms.createdefect("My new defect", 3.5)

Creates a defect with the specified name and cost (optional). The defect is not added to any Process. Returns True if the defect is created successfully. The cost must be a number, it cannot have any currency symbols.

datadms.datetime

datadms.datetime = "4/10/1991 14:51:05"

datadms.datetime = hsidate.dbdatetimestr()

Gets/Sets the DateTime (either in GainSeeker database format or international format). Defaults to an empty string. Will be set to the current date and time if left blank.

datadms.defectexists(name)

if datadms.defectexists("My existing defect"):

    print "Defect exists"

Returns True if the defect with the specified name exists.

datadms.eventdms

datadms.eventdms = "my event"

Gets/Sets the Event field. You must specify the Event description, not the 1-digit short code for the Event.

When setting this field the value must already exist in the Event list or it is ignored.

Defaults to an empty string.

datadms.getdefect(index)

defect = datadms.getdefect(2)

Gets the defect description for the given index. The index must be from 1 through 20.

datadms.getdefectcnt(index)

count = datadms.getdefectcnt(2)

Gets the defect count for the given index. The index must be from 1 through 20.

datadms.gettrace(index)

shift = datadms.gettrace(2)

Gets the traceability field. The index must be from 1 through 48.

datadms.hadgatefailures

datadms.hadgatefailures = True

Sets the DMS data record to indicate that a gate failure occurred.

Sets/Gets the gate failure flag for the DMS data record.

True indicates that a gate failure occurred. Defaults to False (no gate failure occurred).

Use this command to set or clear the gate failure flag based on your own criteria. It will not be automatically set by other Python commands or built-in data collection features in PC Collect.

datadms.incrementdt()

datadms.incrementdt()

Increments the datadms.datetime by the minimum allowable time difference between records as determined by configuration settings. Used to bulk store records that do not have a predetermined datetime.

datadms.ncu

datadms.ncu = 2

Gets/Sets the NCU field. Defaults to zero and cannot be greater than the sample size. Automatically set to datadms.sumdefects if datadms.autosumncu is True.

datadms.note

datadms.note = "my note"

Gets/Sets the note for a record. Defaults to an empty string.

datadms.partno

datadms.partno = "My part"

Gets/Sets the PartNumber field. Defaults to an empty string.

datadms.partnoexists()

datadms.partnoexists()

If True, the value of dmsdata.partno and datadms.process exists as a standard. Possible values are True or False.

datadms.process

datadms.process = "My proc"

Gets/Sets the Process field. Defaults to an empty string.

datadms.samplesize

datadms.samplesize = 4

Gets/Sets the SampleSize field. Defaults to zero.

datadms.setdefect(index, defect)

datadms.setdefect(2, "Scratch")

For the defect at index 2, this sets the defect description to "Scratch" (master defect list ID number 53).

Sets the defect description. (If you prefer to use the defect ID number instead of the defect description, use datadms.setdefectid() instead.)

The index must be from 1 through 20.

The descriptions must exist in the master defect list, or datadms.autocreatedefects must be True.

Use datadms.setdefectcnt() with the same index to set the count for this defect.

datadms.setdefectcnt(index, count)

datadms.setdefectcnt(2, 3)

For the defect at index 2, this sets the defect count to 3.

Sets the defect count for the defect with the corresponding index.

The index must be from 1 through 20.

The default count is 0.

datadms.setdefectid(index, defectid)

datadms.setdefect(2, 53)

For the defect at index 2, this sets the defect ID number to 53 (master defect list description "Scratch").

Sets the defect ID number. (If you prefer to use the defect description instead of the defect ID number, use datadms.setdefect() instead.)

The index must be from 1 through 20.

The ID numbers must exist in the master defect list.

Use datadms.setdefectcnt() with the same index to set the count for this defect.

9.3.2

datadms.settrace(index, value)

datadms.settrace(1, "56348")

Sets the traceability field. Traceability fields are empty by default. The index must be between 1 and 48.

datadms.store()

datadms.store()

Store the fields as a database record. This fails if the dmsdata.process is not set. Trims any leading and trailing spaces from traceability fields (datadms.gettrace / datadms.settrace) before storing. Duplicate date/times are automatically incremented.

Returns True if it is successful. Possible return values are True or False.

Clears the following fields in preparation for the next record to be built:

• datadms.getdefect / datadms.setdefect

• datadms.getdefectcnt / datadms.setdefectcnt

• datadms.sumdefects

• datadms.ncu

• datadms.note

• datadms.eventdms

9.3

datadms.sumdefects

sum = datadms.sumdefects

Gets the sum of all defect counts.