Extract from $CADENAS_SETUP -> geomsearch.cfg.

[Cache_Local_Search]
maxOpenIndexCount=100
linIndexCacheSize=0
sampleLineListCacheSize=0
pivotDistListCacheSize=0
logFileName=

[Cache_Server_Search]
maxOpenIndexCount=100
linIndexCacheSize=150000
sampleLineListCacheSize=800000
pivotDistListCacheSize=50000
logFileName=

	Note
	The cache can be adjusted for the local search and for the search via search server separately. Caching works also with PARTdataManager, but cannot be run effectively here, because the cache is deleted with every boot procedure. That's why the values linIndexCacheSize, sampleLineListCacheSize and pivotDistListCacheSize are set on '0' for the local search.

In the following you find an explanation for the individual caches:

You can optimize the settings in 2 steps:

GeoIndexCache CacheHits 999 of 1000, 99%
GeoIndexCache Files 99 of 100, 99%

SampleLineListCache CacheHits 999 of 1000, 99%
SampleLineListCache Memory 400000 of 800000, 50%

LinIndexCache CacheHits 10617 of 10776, 98%
LinIndexCache Memory 90000 of 100000, 90%

PivotDistCache CacheHits 100 of 10000, 1%
PivotDistCache Memory 9999 of 10000, 99%

For the GeoIndexCache you need not change anything. It is set to the number of catalogs to be searched through.

For the other three caches, you must pay attention to the following rules: (Here explained as an example for SampleLineListCache. The information LinIndexCache and PivotDistCache may be transferred.)

SampleLineListCache CacheHits 900 of 1000, 90%

SampleLineListCache Memory 600000 of 800000, 75%

CacheHits is the measurement for the quality of the cache use. If this value is high, the settings are OK.

Memory gives information whether the value set in the configuration file is properly dimensioned. If you have 100% for CacheHits and 10% for Memory you can get just as many good CacheHits as with decidedly less allocations.

If the CacheHits are low (e.g. 10%) and the set cache is used completely (e.g. 100%), one should attempt to boost the hit rate by increasing the cache value.

As of version 9.08 there are some changes concerning storage location and files:

Storage location

$CADENAS_DATA\index\cat\...\

The Geo Index and the Topology Index are saved separately now.

The new Geo Index is found in the subfolder geoindexv2 (beneath the "old" geoindex), the Topo Index in the folder topoindex.

The following files are found in the directory geoindexv2:

The following files are found in the directory topoindex:

General settings under $CADENAS_SETUP/geomsearch.cfg are found in the section [settings].

Via the Migration tool under PARTadmin -> Category -> Catalog update -> Migration (see Section 1.1.3.3.4, “ Migration ”) you can migrate any number of catalogs at once. It is recommended to use the PARTadmin 64-Bit variant for this, because the conversion is much quicker then, because there is more working memory available. The Standards catalog can only be migrated as a whole. It is not possible to only migrate norm/din for example.

For the creation of indices there are three basic possibilities:

Further notes

For Geo and Topo index the are 3 different modes for performing the search for each, depending on the entry under geomsearch.cfg, section settings (see above).

Furthermore the Linear Index is also used for the sketch search as of version 9.08 in order to reduce search times.

All caching settings can be set differently for the PARTdataManager 32 Bit and 64 Bit variant.

	Important
	When setting values for the Geo search please regard the following rules: Set LinIndexCacheSize and OffsetCacheSize in a size, that they are not completely exhausted. If this is not possible, then set a smaller value for the superordinated storage SampleLineCacheSize. If there is some memory left, set SampleLineCacheSize as large as possible.

With the help of the log files (key LogFileName), mentioned above, the search settings (thus the search behavior) can be optimized for the existing data. You can learn from the log file how full the respective cache is and how often an element has really been in the cache at each access (Cache hits).

Example:

Search from Do 12. Dez 22:41:09 2013
Thread: 0xce8

Geometrical index cache: 
Capacity of the cache: 1000
In use: 18 (1.80%)
Free: 982 (98.20%)
Accesses to the cache: 6489
Cache hits: 6471 (99.72%)
Cache misses: 18 (0.28%)

Linear index cache: 
Capacity of the cache: 100000
In use: 4962 (4.96%)
Free: 95038 (95.04%)
Accesses to the cache: 1932
Cache hits: 1615 (83.59%)
Cache misses: 317 (16.41%)

Offset index cache: 
Capacity of the cache: 50000
In use: 1617 (3.23%)
Free: 48383 (96.77%)
Accesses to the cache: 7033
Cache hits: 6716 (95.49%)
Cache misses: 317 (4.51%)

Sample lines cache: 
Capacity of the cache: 100000
In use: 82785 (82.78%)
Free: 17215 (17.22%)
Accesses to the cache: 16840
Cache hits: 10985 (65.23%)
Cache misses: 5855 (34.77%)

Some notes for the interpretation of data:

You can access the Topo values in the following way:

' main class to manage topology
set topoManager = CreateObject("cnstools.topomanager")

' fetch root node of topology tree
set catalogRoot = topoManager.findCatalogRoot("cat/norm/din")
stdprint("Number of project in din: " & catalogRoot.childCount)

' fetch project node
set prjNode = topoManager.findProjectNode("cat/norm/din", "anlagenbau/armaturen/
 din_11864_1_a_asmtab.prj")
stdprint("Number of lines in anlagenbau/armaturen/din_11864_1_a_asmtab.prj: " 
 & prjNode.childCount)

' fetch line node
set lineNode = topoManager.findLineNode("cat/norm/din", "anlagenbau/armaturen/
 din_11864_1_a_asmtab.prj", 20)

' helper to recursively print all the attributes of a node
sub printAttributes(node, indent)
	stdprint(indent & node.name)
	c = node.childCount
	for j = 0 to c - 1
		printAttributes(node.child(j), indent & "  ")
	next
	a = node.attributeCount
	for j = 0 to a - 1
		set attr = node.attribute(j)
		value = attr.value
		valueAsString = ""
		set attrType = attr.type
		if attrType = "doubleVec" then
			n = value.count
			for k = 0 to n - 1
				if k > 0 then
					valueAsString = valueAsString & ", "
				end if
				valueAsString = valueAsString & value.item(k)
			next
		else
			valueAsString = value
		end if
		stdprint(indent & "  " & attr.name & ": " & valueAsString)
	next
end sub

' print all attributes for a line
stdprint("Recursive list of all attributes in line 20:")
stdprint()
printAttributes(lineNode, "")
stdprint()

' print all attributes for a stl file
stdprint("Recursive list of all attributes in stl:")
stdprint()
set stlNode = topoManager.createNodeFrom3DFile("D:/stl/1 stl/001952002.stl", "STLFILE")
printAttributes(stlNode, "")

' print all attributes for a prt file
stdprint()
stdprint("Recursive list of all attributes in prt file:")
stdprint()
set prtNode = topoManager.createNodeFrom3DFile("D:/stl/ein paar proe-Dateien/
 1202t4100_gen.prt.1", "NATWILDFIREPART 5 32 BIT")
printAttributes(prtNode, "")

' print all attributes for a line (create fingerprints on the fly)
stdprint()
stdprint("Recursive list of all attributes in line 420:")
stdprint()
set lineNode2 = topoManager.createNodeFromProject("cat/norm/din", "anlagenbau/armaturen/
 din_11864_1_a_asmtab.prj", 420)
printAttributes(lineNode2, "")

' print all attributes for a project (create fingerprints on the fly)
stdprint()
stdprint("Recursive list of all attributes in project anlagenbau/armaturen/
 din_11864_1_a_asmtab.prj:")
stdprint()
set prjNode2 = topoManager.createNodeFromProject("cat/norm/din", "anlagenbau/armaturen/
 din_11864_1_a_asmtab.prj", -1)
printAttributes(prjNode2, "")