Moscow State University

Phone: +7 095 939-5906

Fax: +7 095 932-8815

octonus@next.msu.ru

Diamond calculator : Documentation
 

Price list file format

This documents shows technical description of Price.txt file format.

Price.txt file is a text file that sets general rules for calculating price of diamonds basing on their mass, cut, color and clarity. The file is located in the folder where DiamCalc is installed.

Price.txt file does not contain price tables itself, it rather holds general rules and references to external detailed price tables for different cuts.

Let us examine the shipped version of Price.txt file line by line. Using this information, you can look at price tables to check if the price calculation is adequate to your needs. You can also modify files to correct price calculation. (You may need to modify other files too, such as System/OctBrill.txt and System/OctPear.txt.)

It is strongly recommended that you save a copy of the original files before editing them, so that you can restore a working configuration in the case something goes wrong.

 
     
 
This parameter group define DiamCalc common values

; Price list for diamonds from OctoNus Software.

This is the first line of the file. It is a comment because the line begins with ';' symbol (semicolon). Comments are ignored by the software, they are intended to make the file more readable. You can safely remove this line or add other comments anywhere in the file, putting them on a separate line and beginning the line with ';' symbol. Note that blank lines are ignored also.


Version: 1

This line sets internal version of the format, leave it intact.


Title: "Price list from OctoNus"

The name of the price list is set. You can modify the name in double quotes if you decide to edit price tables and enter your data.


SerialNumber: 6

Leave this line intact.

Top of this page

 
     
 
The next group of parameters defines color, clarity and fluorescence values
that may be assigned to a diamond

GroupMass: 1

Usually it should be left as is. The line implies that there is only one set of possible color and clarity values independent of diamond mass (it is not so in some grading systems).


Mass: 0.00 1000

The mass range for which diamond price can be estimated with price lists is from 0 to 1000 carat (1000 is taken to cover all possible stones).


Color: 10
D E F G H I K L M

The first of two lines above means there are 10 color values. The second line lists all 10 color values.


Clarity: 11
IF VVS1 VVS2 VS1 VS2 SI1 SI2 SI3 I1 I2 I3

The first of two lines above means there are 11 clarity values. The second line lists all the values.


Fluorescence: 4
None Low Medium High

The software does not really takes fluorescence into account when pricing diamonds. The lines above define 4 gradations of fluorescence for future use. Do not modify them.


Default: H VS1 None

The line above determines which values of clarity, color and fluorescence are used by default (i.e. before you specify some values for those parameters). So initially diamonds will be marked as having H color, VS1 clarity and 'None' fluorescence.


Quality: 0
CriticalMass: 0.3 0.5 1.0 5.0
DefaultPriceList: Other
Diamond: 0
FixedDiamond: 0

These lines are for internal use only. Leave them as is. One moment that in worth noticing is "DefaultPriceList: Other" line. It implies that if there is no separate price list for some cut, a price list calles "Other" will be used for that cut (see description of "Other" price list below).


PriceList: 3

There are 3 price lists. In the following lines it is specified that one price list is for Brilliant cut, the second for Pear cut and the last one ("Other") is for any other cut.

Top of this page

 
     
 

The following several lines describe the price list for Brilliant cut

Cut: Brilliant

The cut for which price list is applied is defined here.


Magnify: 1

Normally, leave this line intact. It means that all prices in the price list will be magnified by 1, i.e. left the same. If some coefficient is specified (say, 1.2) then all prices will be multiplied by 1.2.


DiscountPerCut: N/A

The discount for cut or shape quality is not present. Leave this line as is.


Source: file= System\OctBrill.txt

This is a reference to a price list for Brilliant cut. Look at the links at the end of this page to find information on format of System\OctBrill.txt file.


DiscountPerFluorescence: N/A

There is no discount for fluorescence. Leave this line as is.

Top of this page

 
     
 

The next several lines of Price.txt file is a description of Pear cut price list.
We skip it...

...several lines skipped ...

 
  /  
 

The last price list is for cuts that were not listed before

Cut: Other

The name of default price list is "Other". As it is defined further, the default price list is made of the price list for Brilliant cut by dividing all prices by 2.


Magnify: 0.5

This line means that the prices are the base prices multiplied by 0.5 (i.e. divided by two).


DiscountPerCut: N/A

Leave this line as is.


Source: cut= Brilliant

Sets the basis for price list calculation to the price list for Brilliant cut.


DiscountPerFluorescence: N/A

Leave this line as is.

 
     
 

DISCLAIMER: The price lists supplied with DiamCalc are sample ones. Although they are similar to real price lists used in the diamond industry, OctoNus Software does not guarantee that you can buy or sell diamonds at the price that was calculated by DiamCalc on the basis of the supplied price lists. OctoNus Software recommends that you verify price list data and modify it as necessary before using them for appraising diamonds for commercial purposes.