Как интерпретировать простые алгоритмы ObservableHq как фрагменты кода многократного использования? - PullRequest
1 голос
/ 20 марта 2020

Основным источником решений D3 js является observableHq.com, но кажется невозможным (?) Для повторного использования алгоритмов путем копирования / вставки ... Это так? Даже проверяя учебные пособия , как это , не существует простого способа (с меньшим количеством плагинов или программистского времени!) Для проверки и повторного использования .

Пример: мне нужен алгоритм fre sh 2020 D3 js v5 для визуализации с отступом дерева, и есть хорошее решение: observableHq.com/@d3/indented-tree. Загрузка не является полезной, поскольку основана на complex Runtime class ...

Но, похоже, простой алгоритм построения диаграмм,

chart = {  // the indented-tree algorithm
  const nodes = root.descendants();
  const svg = d3.create("svg")// ...
  // ...
  return svg.node();
}

Могу ли я простым человеком пошагово преобразовать его в простой HTML, без сложных адаптаций, который начинается с <script src="https://d3js.org/d3.v5.min.js"></script> и заканчивается без Runtime class use?


Более подробная информация в качестве примера

Представляю мой шаг за шагом для приведенного процитированного алгоритма дерева с отступами , что я не могу оштрафовать sh и мне нужна ваша help:

Предположим начать с чистого шаблона HTML5. Например:

<!DOCTYPE html>
<head>
    <meta charset="utf-8">
    <title>Indented Tree</title>
    <script src="https://d3js.org/d3.v5.min.js"></script>
    <script>
    function onLOAD() {
        console.log("Hello onLoad!")
        // all copy-paste and adaptations HERE.
        console.log("!Bye!")
    } // \onLOAD
    </script>
</head>
<body onload="onLOAD()">
  <script>
    console.log("Hello!")
    // global INITIALIZATIONS HERE.
  </script>
</body>
</html>
  1. Подготовка глобальных переменных, кажется root, nodeSize=17 и width

  2. Подготовка данных. .. JSON данные в уродливом ./files/e6537420..., я перешел в проект root с его настоящим именем, flare-2.json.

  3. Простой и классический D3 js способ читать JSON данные: d3.json("./flare-2.json").then( data=> console.log(data) ); Необходимо проверить и проверить отсутствие ошибки CORS и т. Д. c.

  4. Подготовить данные как переменную root. Все в блок data => {}, чтобы избежать проблем с syn c ... Похоже, что root основан на function(d3,data) { let i = 0; return d3.hierarchy(data).eachBefore(d => d.index = i++); }.

  5. Копировать-вставить chart =, как указано выше, после root инициализации с данными.

  6. ...


FAQ

Ответы на вопросы и ответы:

@ Mehdi - Не могли бы вы объяснить, в чем проблема с включением тега сценария D3 и использованием библиотеки времени выполнения в коде?

Когда оригинальный алгоритм ObservableHq прост, мне нужен другой способ, простой способ , чтобы повторно использовать его, с помощью копирования / вставки и минимальной адаптации.

@ Mehdi - Неужели вы прочитайте учебник Загрузка и встраивание блокнотов ?

Да, новостей там нет: нет "человеческих инструкций" о том, как повторно использовать код ... Только "установить его" и "установить это". Никаких инструкций о «копировании / вставке и минимальных адаптациях», которые я объяснил выше.

(@ nobody) - Что вам нужно в качестве ответа?

Как я покажу выше, простая понятная человеку пошаговая процедура для преобразования ... В идеале конечный результат может быть проверен, доказательство того, что он работает, например, на JSFiddle, с кодом копирования / вставки и некоторыми другими строками адаптации, чтобы показать ваш точка.

Ответы [ 2 ]

3 голосов
/ 23 марта 2020

Здесь приведен пошаговый процесс переноса связанной наблюдаемой диаграммы в самодостаточную веб-страницу путем копирования кода и без необходимости использования библиотеки observable runtime .

Начиная со страницы HTML и файла JavaScript, указанного на странице HTML. Предполагается, что веб-сервер работает и настроен соответствующим образом.

  1. Получите данные.
    • Если вы хотите использовать собственные данные вместо данных, используемых в записной книжке, сделайте файлы данных доступными в каталоге на вашем веб-сервере.
    • в противном случае загрузите каждый входной набор данных, прикрепленный к блокноту, используя ссылку Download JSON из меню data каждой ячейки.

screenshot of an observable notebook cell menu

Загрузить каждый набор данных на странице, используя d3-fetch
d3.json("/path/to/data.json").then(function(data) {
  console.log(data); // [{"Hello": "world"}, …]
});

Получите содержимое каждой ячейки, содержащей переменную или функцию в записной книжке, и поместите ее в функцию .then из предыдущего шага. Этот ноутбук визуализатор может быть полезен для идентификации соответствующих ячеек.

Адаптируйте синтаксис только что скопированных функций, как нужно. Например, следующую ячейку записной книжки:

root = { let i = 0; return d3.hierarchy(data).eachBefore(d => d.index = i++); }

можно преобразовать в:

function getRoot(){
   let i = 0;
    return d3.hierarchy(data).eachBefore(d => d.index = i++);
}

root = getRoot()

При необходимости какой-либо функции из записной книжки определите переменную width и инициализируйте ее требуемым значением.

адаптируйте код манипуляции DOM для добавляйте элементы в DOM, а не полагайтесь на неявное выполнение с помощью наблюдаемой среды выполнения.

Демонстрация приведена ниже:

d3.json("https://rawcdn.githack.com/d3/d3-hierarchy/46f9e8bf1a5a55e94c40158c23025f405adf0be5/test/data/flare.json").then(function(data) {

  const width = 800
    , nodeSize = 17
    , format = d3.format(",")
    , getRoot = function(){
       let i = 0;
        return d3.hierarchy(data).eachBefore(d => d.index = i++);
    }
    , columns = [
      {
        label: "Size", 
        value: d => d.value, 
        format, 
        x: 280
      },
      {
        label: "Count", 
        value: d => d.children ? 0 : 1, 
        format: (value, d) => d.children ? format(value) : "-", 
        x: 340
      }
    ]
    , root = getRoot()
    , chart = function() {
      const nodes = root.descendants();

      const svg = d3.select('#chart')
          .attr("viewBox", [-nodeSize / 2, -nodeSize * 3 / 2, width, (nodes.length + 1) * nodeSize])
          .attr("font-family", "sans-serif")
          .attr("font-size", 10)
          .style("overflow", "visible");


  const link = svg.append("g")
      .attr("fill", "none")
      .attr("stroke", "#999")
    .selectAll("path")
    .data(root.links())
    .join("path")
      .attr("d", d => `
        M${d.source.depth * nodeSize},${d.source.index * nodeSize}
        V${d.target.index * nodeSize}
        h${nodeSize}
      `);

      const node = svg.append("g")
        .selectAll("g")
        .data(nodes)
        .join("g")
          .attr("transform", d => `translate(0,${d.index * nodeSize})`);

      node.append("circle")
          .attr("cx", d => d.depth * nodeSize)
          .attr("r", 2.5)
          .attr("fill", d => d.children ? null : "#999");

      node.append("text")
          .attr("dy", "0.32em")
          .attr("x", d => d.depth * nodeSize + 6)
          .text(d => d.data.name);

      node.append("title")
          .text(d => d.ancestors().reverse().map(d => d.data.name).join("/"));

      for (const {label, value, format, x} of columns) {
        svg.append("text")
            .attr("dy", "0.32em")
            .attr("y", -nodeSize)
            .attr("x", x)
            .attr("text-anchor", "end")
            .attr("font-weight", "bold")
            .text(label);

        node.append("text")
            .attr("dy", "0.32em")
            .attr("x", x)
            .attr("text-anchor", "end")
            .attr("fill", d => d.children ? null : "#555")
          .data(root.copy().sum(value).descendants())
            .text(d => format(d.value, d));
      }

  }

  chart()
    
}).catch(function(err) {
  console.log('error processing data', err)
})
<script src="https://cdnjs.cloudflare.com/ajax/libs/d3/5.8.0/d3.min.js"></script>
<svg id = 'chart'></svg>
1 голос
/ 24 марта 2020

Очень простой способ - использовать их версию для встраивания. Вот очень похожий способ повторного использования записной книжки в шаблоне HTML5.

Вы также можете загрузить среду выполнения и записную книжку js для размещения на своем сервере.

Хитрость здесь использовать среду выполнения для связи с наблюдаемыми реактивными ячейками.

В этом примере я использую d3. json для извлечения новых данных json и переопределения ячейки data из исходной тетрадь .

<div id="observablehq-e970adfb"></div>
<script src="https://d3js.org/d3.v5.min.js"></script>
<script type="module">

//Import Observable Runtime

import {Runtime, Inspector} from "https://cdn.jsdelivr.net/npm/@observablehq/runtime@4/dist/runtime.js";
import define from "https://api.observablehq.com/@d3/indented-tree.js?v=3";
const inspect = Inspector.into("#observablehq-e970adfb");

// Notebook instance
const notebook =(new Runtime).module(define, name => (name === "chart") && inspect());


// Using D3.json to load new Json Data

d3.json("https://gist.githubusercontent.com/radames/9018398d6e63bcaae86a0bf125dc6973/raw/33f19a49e1123a36e172cfc7483f0a444caf6ae3/newdata.json").then((newdata) =>{
  
  // When data is loaded you can use notebook to redefine a cell
  // In this case the data cell, where in the notebook it's using a FileAtachent
  // Here you can redefine with any structure hierarchy structure like
  
  notebook.redefine("data", newdata);
})


</script>

Редактирование для добавления шагов с использованием проекта Северо

Использование Визуализатор для ноутбука Severo Вы можете понять поток данных вашего ноутбука и переписать свой автономный код. Имейте в виду, что переписывание с нуля может стать очень сложным, поскольку ваш код использует наблюдаемые функции, такие как реактивность и управление состоянием. В этом случае я рекомендую вам использовать Observable runtime после моего ответа выше.

Теперь, помня об этом, давайте посмотрим на визуализатор и следуем инструкциям Severo

enter image description here

  • Зеленые ячейки соответствуют внешнему коду, импортированному в записную книжку: библиотека импортирована с require (например, d3 = require ("d3@5 ")): обычно вы устанавливаете его в своем проекте с установкой npm, а
    затем импортируете его как импортированный блокнот модуля ES (например, импорт {radio} из" @ jashkenas / input "): вам придется повторите этот же процесс в
    этой записной книжке, изучив собственный график зависимостей.
  • Серые ячейки являются анонимными (неименованными) ячейками и, как правило, не переносятся. Они часто содержат тексты объяснений, и никакая другая ячейка не может зависеть от них, поэтому они не должны нарушать код, если
    удалено. Но будьте осторожны: если ваша основная ячейка диаграммы не названа, вы
    все равно захотите скопировать ее код.
  • Черные ячейки - это фактический код записной книжки, написанный пользователем, и вы захотите скопировать его в свой проект.
  • Фиолетовые клетки - самые жесткие. Они соответствуют функциям Observable, которые, как правило, часто используются автором записной книжки (см. Стандартную библиотеку), и их перенос в автономное приложение может быть самой сложной частью переписывания с нуля, особенно изменяемых и представляемых ячеек, поскольку они управлять внутренним состоянием.

Вот код, преобразованный в соответствии с этими инструкциями

<!--- Green Cells / Imports --->
<script src="https://d3js.org/d3.v5.min.js"></script>

<!--- Char Container --->

<div class="chart"></div>
<script>
  // Run main function
  main();

  // async main so we can run our code like Observable cell by cell
  async function main() {
    // as in Observable each cell runs as an async function
    // so here you can await the output to continue
    const data = await d3.json("https://gist.githubusercontent.com/radames/9018398d6e63bcaae86a0bf125dc6973/raw/33f19a49e1123a36e172cfc7483f0a444caf6ae3/newdata.json");

    // run complex code as inline await / async
    const root = await (async() => {
      let i = 0;
      return d3.hierarchy(data).eachBefore(d => d.index = i++);
    })()

    // easy constant
    const nodeSize = 17;

    // easy constant function
    const format = d3.format(",");

    // easy constant
    const columns = [{
        label: "Size",
        value: d => d.value,
        format,
        x: 280
      },
      {
        label: "Count",
        value: d => d.children ? 0 : 1,
        format: (value, d) => d.children ? format(value) : "-",
        x: 340
      }
    ];
    // on Observable width is reactive, here we have to do it manually
    const width = window.innerHTML;

    window.addEventListener('resize', updateWidth);

    function updateWidth() {
      // update your chart on resize event
    }
    // inline function gets chart svg node
    const chart = (() => {
      const nodes = root.descendants();

      const svg = d3.create("svg")
        .attr("viewBox", [-nodeSize / 2, -nodeSize * 3 / 2, width, (nodes.length + 1) * nodeSize])
        .attr("font-family", "sans-serif")
        .attr("font-size", 10)
        .style("overflow", "visible");

      const link = svg.append("g")
        .attr("fill", "none")
        .attr("stroke", "#999")
        .selectAll("path")
        .data(root.links())
        .join("path")
        .attr("d", d => `
          M${d.source.depth * nodeSize},${d.source.index * nodeSize}
          V${d.target.index * nodeSize}
          h${nodeSize}
        `);

      const node = svg.append("g")
        .selectAll("g")
        .data(nodes)
        .join("g")
        .attr("transform", d => `translate(0,${d.index * nodeSize})`);

      node.append("circle")
        .attr("cx", d => d.depth * nodeSize)
        .attr("r", 2.5)
        .attr("fill", d => d.children ? null : "#999");

      node.append("text")
        .attr("dy", "0.32em")
        .attr("x", d => d.depth * nodeSize + 6)
        .text(d => d.data.name);

      node.append("title")
        .text(d => d.ancestors().reverse().map(d => d.data.name).join("/"));

      for (const {
          label,
          value,
          format,
          x
        } of columns) {
        svg.append("text")
          .attr("dy", "0.32em")
          .attr("y", -nodeSize)
          .attr("x", x)
          .attr("text-anchor", "end")
          .attr("font-weight", "bold")
          .text(label);

        node.append("text")
          .attr("dy", "0.32em")
          .attr("x", x)
          .attr("text-anchor", "end")
          .attr("fill", d => d.children ? null : "#555")
          .data(root.copy().sum(value).descendants())
          .text(d => format(d.value, d));
      }

      return svg.node();
    })()

    // select element container append chart
    const container = document.querySelector(".chart")
    container.appendChild(chart);

  }
</script>
...