Corrupted tip counter database?

I have run into what seems like a moving target of a tip error, not sure where to start in trying to remedy this issue since it’s tied to one of the read-only/managed sequences. I’ve seen this on both a 16ch venus 4 STAR, and a 12ch venus 6 STARlet, in simulated and non-simulated runs, and it seems to vary from run to run whether we can proceed through the rest of the steps. The tip editor window shows tip usage that does not remotely reflect what was actually used in the run, and it errors out when trying to write the tips used to the global tip counter upon abort/method exit as well.

In-run error message:
This varies somewhat as to which tip position is failing to be written

Tip editor view:
(apologies for committing the ultimate sin of taking a picture of a screenshot here, this one didn’t get saved apparently)

This is one I unfortunately do not seem to have a screenshot of, but the table of sequence positions in the layout editor also looks off. In the case of the 12ch instrument/current problem child, the position table almost looked like it was written for 16 channels even though my config was set correctly for 12. The positions dipped into the second/middle rack for four tips before cycling back up to rack 1, continuing in that same manner throughout the position table. Normally I would re-sort the sequence to be oriented to the correct labware, but since the tips are a managed sequence I could not.

Any suggestions/fixes I can try? A fully fresh install including a windows reset has seemed to fix one of the 12ch instruments so far, but I don’t know which potentially corrupted files are causing this so I’m honestly a bit worried to import any other methods without knowing what’s unhappy.

Hi @labrat,

That is an issue that can happen on older versions of STAR Tools library where the sorting of the tips does not match how it is on the deck, so the tip counter function fails with that error. It can be intermittent based on usage.

The version that is uploaded on this site should have the fix implemented:

https://download.hamiltonsupport.com/wl/?id=VQY0XAzTfcT7KY29A1YJtZVFwZ7GMOO2&path=Hamilton%20Libraries%2FSTAR%20Tools%20Demo%20240507.pkg&mode=grid&download=1

Either delete or back up the folder “C:\Program Files (x86)\HAMILTON\Library\STAR Tools” then import using recovery mode and select no to all. As long as that folder does not exist while you are importing, that will ensure the updates are successful.

Apologies for the delayed response @BrandonBare_Hamilton—that seems to have taken care of things on at least two of the affected systems, thank you so much! I don’t think I’ve ever been happy to hear about a known error before, but in this case I am super relieved to know that it’s not a novel problem. I was worried about spreading the issue to other systems currently in production, especially not knowing where it was originating in the first place.

One clarifying question, any changes to those instructions based on whether it’s running VENUS 4 vs VENUS 6? I know that the above file has to be imported in 6 using the legacy import tool regardless, but want to make sure I wasn’t missing any quirks since I have a few still on 4.

Hi @labrat ,

I’m glad to hear that solved your issue. The instructions are still the same on Venus 4 as they are on 6.

1 Like

Hey there,

im getting the same error message, on venus 6.2 after switching a few tip racks around on the carrier.

But all my sequences look fine, a also didn’t change any sorting.

Is there another way to fix this issue than a reinstall of HamiltonTools.exe (Work Laptop, requires hard to get Admin rights)?

Thanks in Advance

Hi @Cem96 ,

Updating is the only concrete way to fix. There is no install required for STAR Tools. Just delete the folder and import the pkg.

Hi @BrandonBare_Hamilton

Thanks for the super fast response :slight_smile:

I was confusing it with hamilton tools which needs an install.

I had the library from the pkg STAR Tools Demo 220421 when the error occurred.

The link provided contains a newer version, reimport of the old version didn’t fix the problem.

The import of the new version gives me a boatload of undeclared identifies when i run my method, is there a way to fix these, so i can use the new version?

Can you upload the trace of the undeclared identifiers? Did you delete the folder prior to importing?

Yes I deleted it, here is just the text from the Trace:

2026-04-03 20:26:12.052 Venus software version: 6.2.3.4706

2026-04-03 20:26:12.074 SYSTEM : Analyze method - start; Method file C:\Program Files (x86)\Hamilton\Methods\Antiepileptika\Antiepileptika.hsl

2026-04-03 20:26:13.426 Microlab Starlet : Communication - progress; Connection to instrument is created.

2026-04-03 20:26:42.433 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(25) : error 1312: cannot open include file: ‘LiquidClassLibrary\LiquidClassLibrary.hsl’

2026-04-03 20:26:42.466 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(2960) : error 1302: ‘LiquidClassLibrary::GetCorrectionCurve’ undeclared identifier

2026-04-03 20:26:42.467 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(2966) : error 1302: ‘LiquidClassLibrary::GetLiquidType’ undeclared identifier

2026-04-03 20:26:42.467 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(2969) : error 1302: ‘LiquidClassLibrary::GetLiquidClassTipType’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(2972) : error 1302: ‘LiquidClassLibrary::GetLiquidClassDispenseMode’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(2991) : error 1302: ‘LiquidClassLibrary::GetLiquidClassAspirateParameters’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(2999) : error 1302: ‘LiquidClassLibrary::GetLiquidClassDispenseParameters’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(14762) : error 1302: ‘LiquidClassLibrary::SetTadmMode’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(14773) : error 1302: ‘LiquidClassLibrary::SetTadmMode’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - progress; C:\Program Files (x86)\Hamilton\Library\STAR Tools\STAR Pipetting Tools.hsi(14791) : error 1302: ‘LiquidClassLibrary::GetTadmMode’ undeclared identifier

2026-04-03 20:26:42.468 SYSTEM : Analyze method - error; An error occurred while running Vector. The error description is: Method contains syntax errors (0x23 - 0x2 - 0x35) ,

2026-04-03 20:26:42.468 SYSTEM : Analyze method - complete with error;

Could it be that i need to install this Library :

Hi @Cem96 ,

Apologies, I forgot about the LiquidClassLibrary. That does need to be installed and would eliminate those Syntax Errors.

No worries, thanks a lot for the quick Help :sunny:

I can run my tests on the weekend without the tip counter, if IT dept is available again it will be a quick fix.

2 Likes