API documentation?

[Fil]

Hello,

I've tried to upgrade my older notebook from 0.3.5 to 0.7.1, and several of the methods break (FASTMAP, PCA, etc). I'm not sure where to find the new API documentation so I can fix this? Thanks!

[saehm]

Hey,

the documentation for FASTMAP is here: https://saehm.github.io/DruidJS/FASTMAP.html

I hope this helps!

[saehm]

I checked your notebook, and the druid code.

For me, the notebook works for the iterative methods with this:

result = Generators.observe(
  worker(
    function dr({ dr_method, data }) {
      return druid[dr_method].generator(data, {});
    },
    { dr_method, data },
    `
importScripts(${JSON.stringify(
      await require.resolve("@saehrimnir/druidjs@^0.7.1") // note: version 0.7 changes the API, breaking FASTMAP to PCA in this notebook. See https://observablehq.com/@saehrimnir/hello-druidjs/2
    )});
`
  )
)

The generator function just calls the transform function and returns its results, maybe i need to use yield instead?

All the methods work for me with the transform function return druid[dr_method].transform(data, {});.

The second parameter {} is (as a workaround) needed for the DR methods which have a neighbors parameter.

[Fil]

I see. So we need one of:

 yield druid[dr_method].transform(data, {});
 yield* druid[dr_method].generator(data, {});

How can I distinguish the methods that have a working generator? (I think it's the same question as #13 (comment) :) )

[saehm]

I fixed the issue of the methods which need a neighbor parameter.
I already added the generator function for all DR methods when you were talking about this here: #13 (comment).
But they did not work yet. With version 0.7.3, your notebook works for all DR techniques with your code, but also with this code:

result = Generators.observe(
  worker(
    function dr({ dr_method, data }) {
      return druid[dr_method].generator(data); // show the steps
    },
    { dr_method, data },
    `
importScripts(${JSON.stringify(
      await require.resolve("@saehrimnir/druidjs@^0.7.3")
    )});
`
  )
)