algorithm-archivists / algorithm-archive

A collaborative book on algorithms
https://www.algorithm-archive.org
MIT License
2.37k stars 358 forks source link

Unintuitive Directory Scheme #57

Closed leios closed 6 years ago

leios commented 6 years ago

Currently, the Algorithm Archive is divided into large algorithmic "domains" of computational_physics, computational_mathematics and so on. I wrote it this way so that readers could easily learn about that topic of interest when it was sufficiently filled with algorithms. For example, if someone wanted to learn about computational physics, they just go to that section.

The problem here is that many of the algorithms in computational_physics could easily belong in computational_mathematics or other areas, so instead of providing large overarching directories, it might be better to divide those sections up into individual components (like ODE_solvers or something), and then provide an "algorithmic guide to computational physics" at the start, which provides commentary through all the different algorithms and methods in computational physics (kinda like a large outline for those who want to learn the topic).

These guides would be written after we have a sufficient number of algorithms in the Archive, so it will be a while, but I wanted to create an issue to keep this in mind and see if anyone has a better idea on how to organize this project. As always, I am open to suggestions!

jiegillet commented 6 years ago

Out there suggestion: apply some unsupervised machine learning techniques to the wikipedia pages of all the algorithms to group them into 4 categories, and figure out how to call them from that :)

leios commented 6 years ago

Huh. I kinda like that idea. It would be neat to use one of the methods we eventually cover here to organize the algorithm archive.

This will take some time to do, though. So for now, I think we should do something simple.

It doesn't necessarily need to be n = 4 categories either. We can use affinity propagation (or something) to split it up more organically.

jiegillet commented 6 years ago

Agreed, that's a fun project for later :) Quick research on how people are doing it elsewhere: here, here or here

june128 commented 6 years ago

@leios Since you restructured the AAA, the issue can be closed I think.

leios commented 6 years ago

I actually left it open because it's still not quite right. I am missing the guides and am not happy with certain sections (like convolutions) just lying about in the chapters directory. This should probably go into a mathematical methods section or something.

I just feel like it's still a work in progress.

june128 commented 6 years ago

Ok

Butt4cak3 commented 6 years ago

Can this be closed now that #242 is merged?