> [Wiki](Home) ? [[API--中文手冊]] ? [[布局]] ? **弦布局**
* 如發現翻譯不當或有其他問題可以通過以下方式聯系譯者:
* 郵箱：zhang_tianxu@sina.com
* QQ群：[D3數據可視化](http://jq.qq.com/?_wv=1027&k=ZGcqYF)205076374，[大數據可視化](http://jq.qq.com/?_wv=1027&k=S8wGMe)436442115
弦圖所示內容為一組實體之間的關系。例如，假定有一組不同發色的人：黑色、金色、棕色和紅色。該組每個人都為約會對象準備了中意的發色；在所有29630個（假設）黑發人群中， 40%的人（11975）傾向于同具有相同發色的對象進行約會。但這種傾向是非對稱的：例如，只有10%的金發人會選擇黑發人群作為約會對象，而20%的黑發人會將金發人作為約會對象。
通過在不同的弧線之間畫出二次貝塞爾曲線，將上述關系表示在一張弦圖中。源弧線和目標弧線分別代表總人口的兩個鏡像子集，如喜歡金發的黑發人口數量，以及喜歡黑發的金發人口數量。另一個例子，我們看這個軟件依賴弦圖的例子：http://bl.ocks.org/mbostock/1046712。
弦布局同弦形和弧形協同工作，用于生成數據對象。該對象作為弦形狀的輸入，對弦進行描述。同時，該布局還能生成對不同群組的描述，用作弧形的輸入。
# d3.layout.chord()
構建新的弦布局。在默認情況下，輸入數據并未分類，并且各群組之間沒有填充。和其他布局不同，該弦布局并不是應用于數據的函數；相反，數據通過設置關聯矩陣來指定，通過chords和groups訪問器檢索。
# chord.matrix([matrix])
指定矩陣之后，設定該布局用到的輸入數據矩陣。如果沒有指定矩陣，返回當前數據矩陣，默認為未定義。輸入矩陣的數字必須為“方形矩陣”
(http://en.wikipedia.org/wiki/Matrix_(mathematics\)#Square_matrices)例如：
[[11975,5871,8916,2868],
[1951,10048,2060,6171],
[8010,16145,8090,8045],
[1013,990,940,6907]]
矩陣的每一行對應一個特定分組，如上文所述某個發色。矩陣中每一列i同第i行相對應；每個單元格ij對應表示第i組到第j組之間的關系。
# chord.padding([padding])
If padding is specified, sets the angular padding between groups to the specified value inradians. If padding is not specified, returns the current padding, which defaults to zero. You may wish to compute the padding as a function of the number of groups (the number of rows or columns in the associated matrix).
指定填充之后，在不同組之間設定角度填充，為指定的值（弧度為單位）。如果沒有指定填充，返回當前填充，默認值為0。你可能希望計算填充是分組數量（關聯矩陣中行和列的數量）的函數。
# chord.sortGroups([comparator])
如果已經指定comparator，使用指定comparator函數為布局設定分組（行）的排列順序。為每兩行調用comparator函數，傳遞的入參是行i和行j的總和。通常，需要將comparator按照d3.ascending或d3.descending進行指定。如果沒有指定comparator，則返回當前分組排列順序，該順序默認值為空。
# chord.sortSubgroups([comparator])
如果已經指定comparator，使用指定comparator函數為布局設定分組（行內各列）的排列順序。為每對單元格調用comparator函數，值為各單元格的值。通常，需要將comparator以升序或降序進行指定。如果沒有指定comparator，則回當前子分組排列順序，該順序默認值為空。
# chord.sortChords([comparator])
如果已經指定comparator，運用指定comparator函數為弦布局設定弦（Z順序）的排列順序。為每兩條弦調用comparator函數，入參為源單元格和目標單元格的最小值。通常，要將comparator以升序或降序進行指定。如果沒有指定comparator，返回當前chord排列順序，默認值為空。
# chord.chords()
給定布局的當前配置和關聯矩陣，返回計算過的弦對象。如果弦對象已計算完畢，本方法返回緩存值。如果布局屬性有任何改變，則清空之前計算的弦。此時，如果下次調用該方法，需要對布局進行重新計算。返回對象具有下列屬性：
? source -描述源對象。
? target -描述目標對象。
這兩個對象描述下列實體：
? index -行索引，i。
? subindex索引-列索引，j。
? startAngle-弧的起始角，在radians內。
? endAngle-弧的終止角，在radians內。
? value -關聯單元格ij的數值。
需要注意的是，這些對象同弦很方便為弦生成器匹配默認的訪問器；但仍可以對訪問器進行重寫或者修改返回對象，實現布局微調。
# chord.groups()
給定布局的當前配置和關聯矩陣，返回計算過的分組對象。如果分組對象已計算完畢，本方法返回緩存值。如果布局屬性有任何改變，則清空之前計算的分組。此時，如果下次調用該方法，需要對布局進行重新計算。返回對象具有下列屬性：
? index -行索引，i。
? startAngle -弧的起始角，在radians內。
? endAngle -弧的終止角，在radians內。
? value -相關行 i的值的總和。
需要注意的是，這些對象同弧度生成器的默認訪問器具有較好的吻合度；但仍可以對訪問器進行重寫或者修改返回對象，實現布局微調。
* 張爍譯 20140428
* 咕嚕校對 2014-11-30 09:39:57
