Jump to content

.lin file format structure


Recommended Posts

I remember looking for this before and never finding anything. However, the format is somewhat decipherable if you compare the source to the display.

 

this is a sample lin file with 3 boards:

vg|#387 Pairs Komal's Tourney for all,Bridge Base Online,P,1,3,,,,|
rs|4HN+1,,4HS=,,3NS+3,|
pw|wlodawa,Marion89,kontiki_,scoob,wlodawa,Marion89,kontiki_,scoob,wlodawa,Marion89,kontiki_,scoob|
mp|-7.2,,-6.3,,-4.1,|
bn|1,2,3|
pg||
qx|o1|pn|wlodawa,Marion89,kontiki_,scoob|st||md|3S269H2568QADTQC2T,S47AHJD3479C4567Q,S58QH479KDKAC38JA,|rh||ah|Board 1|sv|o|mb|1N|mb|p|mb|2D|mb|p|mb|3H|mb|p|mb|4H|mb|p|mb|p|mb|p|pg||pc|SJ|pc|S2|pc|SA|pc|S5|pg||pc|C4|pc|C3|pc|CK|pc|C2|pg||pc|C9|pc|CT|pc|CQ|pc|CA|pg||pc|H4|pc|H3|pc|HA|pc|HJ|pg||pc|H2|pc|C5|pc|HK|pc|HT|pg||pc|CJ|pc|D2|pc|S6|pc|C6|pg||pc|C8|pc|S3|pc|S9|pc|C7|mc|11|pg||
qx|o2|pn|wlodawa,Marion89,kontiki_,scoob|st||md|4S9JH579QAD8KAC39Q,S5QKH24TD35TQC56K,S268AH3KD27C247TJ,|rh||ah|Board 2|sv|n|mb|p|mb|1H|mb|p|mb|1S|mb|p|mb|2N|mb|p|mb|3H|mb|p|mb|4D|mb|p|mb|4H|mb|p|mb|p|mb|p|pg||pc|D3|pc|D2|pc|DJ|pc|DA|pg||pc|DK|pc|D5|pc|D7|pc|D4|pg||pc|D8|pc|DT|pc|H3|pc|D6|pg||pc|HK|pc|H6|pc|H5|pc|H2|pg||pc|C2|pc|C8|pc|C9|pc|CK|pg||pc|SK|pc|SA|pc|S3|pc|S9|pg||pc|C4|pc|CA|pc|CQ|pc|C6|pg||pc|S7|pc|SJ|pc|SQ|pc|S2|pg||pc|DQ|pc|S6|pc|D9|pc|H7|pg||pc|HQ|pc|H4|pc|S8|pc|H8|pg||pc|HA|pc|HT|pc|C7|pc|HJ|pg||pc|H9|pc|S5|pc|CT|pc|S4|pg||pc|C3|pc|C5|pc|CJ|pc|ST|pg||
qx|o3|pn|wlodawa,Marion89,kontiki_,scoob|st||md|1SJKH35TQKDJAC245K,S2457H479JD9QC39A,S39TAH2AD23TC68TQ,|rh||ah|Board 3|sv|e|mb|1H|mb|p|mb|1S|mb|p|mb|2N|mb|p|mb|3N|mb|p|mb|p|mb|p|pg||pc|S7|pc|S3|pc|SQ|pc|SK|pg||pc|C2|pc|C3|pc|CQ|pc|C7|pg||pc|C6|pc|CJ|pc|CK|pc|CA|pg||pc|DQ|pc|D2|pc|D4|pc|DA|pg||pc|C5|pc|C9|pc|CT|pc|H6|pg||pc|C8|pc|H8|pc|C4|pc|S2|pg||pc|SA|pc|S6|pc|SJ|pc|S4|pg||pc|ST|pc|S8|pc|H3|pc|S5|pg||pc|S9|pc|D5|pc|DJ|pc|H4|pg||pc|HA|pc|D6|pc|H5|pc|H7|pg||pc|H2|pc|D7|pc|HQ|pc|H9|pg||pc|HK|pc|HJ|pc|D3|pc|D8|pg||pc|HT|pc|D9|pc|DT|pc|DK|pg||

 

the file seems to be made up of a series of key/value pairs, many of the values consisting of arrays of information related to the key. the format seems to be:

key|array,of,values,are,comma,separated|

 

this is what i've come up with thus far...

 

 

 

vg|#387 Pairs Komal's Tourney for all,Bridge Base Online,P,1,3,,,,|

vugraph info: two values of text, scoring format, ?, number of boards, team1, carryover, team2, carryover

rs|4HN+1,,4HS=,,3NS+3,|

array of final contracts for each board, open room first then closed room - since this isn't teams, the closed room values are null

pw|wlodawa,Marion89,kontiki_,scoob,wlodawa,Marion89,kontiki_,scoob,wlodawa,Marion89,kontiki_,scoob|

array of player names. 4 entries per board, starting with South. in a team environment, the "pw" tag is replaced by the "pn" tag:

pn|nfmfl,BobHam,dianas,PaulSo,SYKwok2,precision0,feblok,oliverc|

8 players, starting at South of team 1

mp|-7.2,,-6.3,,-4.1,|

array of scores - again, two entries per board - first NS then EW

bn|1,2,3|

array of board numbers

 

i believe that all the above fields are optional and only used for multi-board situations. individual hands are then stored in a single line, with a variety of values

 

full hand:

qx|o1|pn|wlodawa,Marion89,kontiki_,scoob|st||md|3S269H2568QADTQC2T,S47AHJD3479C4567Q,S58QH479KDKAC38JA,|rh||ah|Board 1|sv|o|mb|1N|mb|p|mb|2D|mb|p|mb|3H|mb|p|mb|4H|mb|p|mb|p|mb|p|pg||pc|SJ|pc|S2|pc|SA|pc|S5|pg||pc|C4|pc|C3|pc|CK|pc|C2|pg||pc|C9|pc|CT|pc|CQ|pc|CA|pg||pc|H4|pc|H3|pc|HA|pc|HJ|pg||pc|H2|pc|C5|pc|HK|pc|HT|pg||pc|CJ|pc|D2|pc|S6|pc|C6|pg||pc|C8|pc|S3|pc|S9|pc|C7|mc|11|pg||

 

qx|o1|

index ref. the first letter refers to open/closed room when teams. the number is the board number

pn|wlodawa,Marion89,kontiki_,scoob|

player names, starting with South. in a team environment, the closed room player names will be preceded by 4 null values (ie. pn|,,,,SYKwok2,precision0,feblok,oliverc|)

md|3S269H2568QADTQC2T,S47AHJD3479C4567Q,S58QH479KDKAC38JA,|

the deal. the first number indicates which hand dealt, starting with South as 1. following are the first three hands - the fourth left to deduction.

ah|Board 1|

description/name of board - appears at the centre of the compass in BBO

sv|o|

vulnerability. o = none, n = north/south, e = east/west, b = both

mb|1N|mb|p|mb|2D|mb|p|mb|3H|mb|p|mb|4H|mb|p|mb|p|mb|p|

bidding. each bid preceded by the "mb" tag.

an|10-12 (semi)balanced, no

alerts appear in-line directly after the alerted bid - the value is the description

|pc|SJ|pc|S2|pc|SA|pc|S5|pg||pc|C4|pc|C3|pc|CK|pc|C2|pg||pc|C9|pc|CT|pc|CQ|pc|CA|pg||pc|H4|pc|H3|pc|HA|pc|HJ|pg||pc|H2|pc|C5|pc|HK|pc|HT|pg||pc|CJ|pc|D2|pc|S6|pc|C6|pg||pc|C8|pc|S3|pc|S9|pc|C7|

playout. each card preceded by the "pc" tag. each trick seems to be separated by a null "pg" tag?

mc|11|

a claim is made, 11 tricks total

 

i'm unsure what these each signify, but in this sample they only appear as null values:

pg||
st||
rh||

 

maybe fred or uday will happen along and add some info for you(us)

 

(edited some errors noticed while browsing a team format lin)

Link to comment
Share on other sites

however, i dont think u should continue posting the results of your backward engineering here ( i am through it with a dotw) . that u didnt find a manual in the net might have a reason, namely that lin is not an open source software. it has about 600 tags and i have heard u can buy a license including an editor if u want to use all of its functions. i guess some people have to try to make a living somehow :). the basic functions and tags u mentioned are quite obvious and all the teachers and users can use them (to generate deals, etc.) but i think the tags shouldnt be published.
Link to comment
Share on other sites

The full blown "LIN" format is used by programs like Bridge Master and the other CDs published by BBI (Fred's original company, the one that spun off BBO).

 

BBO uses a tiny subset of LIN for hands, etc.

 

There are a couple of posts lying around with some basic lin tags usable for things like Tourney Conditions of Contest, etc.

 

The full LIN format is documented, and there is a LIN editor etc, but BBO doesn't own it. Contact fred@ if you need a copy. I'll warn you in advance that if the project you need this for is commercial, or if you come across as someone who needs a ton of tech support, it probably won't be free. Fred has occasionally given it away, mostly to people who seem like they won't abuse it

 

Now, about some of those basic tags:

 

This link might help

 

http://forums.bridgebase.com/index.php?showtopic=2583

 

 

BBO uses lin files for

 

single hand records (example, myhands results )

collections of hands ( vugraph archives, logs on your pc)

specifying deals to be used for tourneys

 

pg|| means wait for user input before continuing to render

 

Dunno about the others.

 

There is at least one LIN->PBN converter out there somewhere.

Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
×
×
  • Create New...