Tham số `e` được chuyển tới hàm gọi lại đánh dấu lực d3.js là gì?

Question

dưới đây là một ví dụ bình thường của chức năng đánh dấu:

function tick(e) { 
    nodes 
     .each(cluster(10 * e.alpha * e.alpha)); 
} 

những người có thể cho tôi biết định nghĩa của "e"? Những đặc tính nào nó có? Tôi không thể tìm thấy bất kỳ mô tả nào về "e" và ý nghĩa của e.alpha là gì. Có, tôi đã sử dụng google nhưng không có kết quả.

---

Cảm ơn sự trợ giúp bạn đã cung cấp bên dưới.

Tôi đang sao chép một số mã, trong đó sử dụng

var force = d3.layout.force() 
     .nodes(nodes) 
     .size([width, height]) 
     .charge(-70) 
     .gravity(0.1) 
     .on("tick", tick) 
     .start(); 

do đó, nó chỉ là trường hợp bạn đoán. Tôi mới đến d3, một skim của API force.layout đã không cho tôi bất kỳ đầu mối. Cảm ơn thời gian quý báu của bạn!

Answer 1

Nếu không có điều kiện đầy đủ các chức năng "bình thường" của bạn, đây là một chút của một đoán, nhưng ở đây đi:

tick được sử dụng trong nhiều ngữ cảnh trong d3. Việc inlcusion của alpha cho thấy rằng đây là một force layout tick function, được gọi bởi đối tượng bố trí lực trên một sự kiện đánh dấu, trong trường hợp này e sẽ là đối tượng sự kiện đánh dấu.

Không có nhiều tài liệu về sự kiện đánh dấu, vì hầu hết các ví dụ đều không sử dụng nó. Nếu bạn kiểm tra việc source code, bạn sẽ thấy

// A rudimentary force layout using Gauss-Seidel. 
d3.layout.force = function() {      //line 11 
    var force = {}, 
     event = d3.dispatch("start", "tick", "end"); 
    /* ... */ 
    force.tick = function() {      //line 58 
     // simulated annealing, basically 
     if ((alpha *= .99) < .005) { 
      event.end({type: "end", alpha: alpha = 0}); 
      return true; 
     } 
     /* code to implement default force layout adjustments */ 
     event.tick({type: "tick", alpha: alpha}); //line 128 
    }; 
    /* ... */ 
    return d3.rebind(force, event, "on");   //line 305 
}; 

Nói cách khác, sự kiện đánh dấu là một trong ba loại sự kiện tùy chỉnh được tạo ra bên trong mã nguồn d3 sử dụng quá trình d3.dispatch. Sự kiện tick đặc biệt được gửi đi ở cuối hàm đánh dấu nội bộ và chỉ chứa một thuộc tính tùy chỉnh: thông số alpha hiện tại trong bố cục lực. Để các sự kiện này thực sự đi bất cứ đâu, phương thức on của đối tượng điều phối sự kiện là rebound đối với đối tượng bố trí lực, để người dùng có thể đăng ký các chức năng nghe cho các sự kiện tùy chỉnh.

Nếu tất cả những gì là quá nhiều internals d3 cho bạn, chỉ cần tập trung vào những chi tiết này:

• e là một đối tượng sự kiện tùy chỉnh thông qua với chức năng đánh dấu của bạn mỗi khi nó được gọi là

• e.alpha được giá trị alpha hiện tại của bố cục lực, theo mặc định bắt đầu ở mức 0,1 và được giảm (theo thông số friction) tại mỗi đánh dấu cho đến khi giảm xuống dưới 0,005 và bố cục đóng băng:

  Nội bộ, bố cục sử dụng thông số làm mát alpha điều khiển nhiệt độ bố cục: khi mô phỏng vật lý hội tụ trên bố cục ổn định, nhiệt độ giảm xuống, khiến các nút di chuyển chậm hơn. Cuối cùng, alpha giảm xuống dưới ngưỡng và mô phỏng dừng hoàn toàn, giải phóng CPU và tránh xả pin. (From the API wiki for force.start)