=======================================

Codes for grid layout algorithm described in our paper "Hierarchical Fuzzy-Cluster-Aware Grid Layout for Large-Scale Data".

Also see in GitHub and OSF.

Tested on python 3.8.

This method is best used in a Windows or Mac environment; otherwise, the parallelism of QAP solver may not lead to efficiency improvements, resulting in longer runtime.

You can use pip or other tools to setup environment.

For Example:

pip install -r requirements.txt

There are several packages that need to be compiled or installed manually.

Color Package:

Please come to this repository to download and compile color packages.

Then move the compiled files (such as .pyd or .so) to backend/application/data/color/.

Linear Assignment Package:

cd backend
cd application
cd grid
cd linear_assignment
python setup.py install

Grid Layout Utils Package:

cd backend
cd application
cd grid
cd "c module_now"
python setup.py build_ext --inplace    (For MSVC environment in Windows, please use setup_win.py)

Then move the compiled files (such as .pyd or .so) to backend/application/grid/.

If you encounter issues while compiling, please try adjusting the line endings to LF or CRLF according to your system environment.

Please download datasets from google drive or osf and move the directory to backend/datasets/.

For example, backend/datasets/cifar100/.

Then unzip the .zip files in the folder, and run calc_conf.py and multiload.py (if they exist) to preprocess.

For your dataset, please:

1. prepare the xxx.json, xxx_features.npy, xxx_labels.npy, xxx_labels_gt.npy, xxx_predict_confs.npy and xxx_images folder, xxx can be the name of your dataset. The details of these files can be seen in README.md in google drive or osf.
2. Then run calc_conf.py to preprocess confidence like existing datasets.
3. For large dataset, please run multiload.py to preprocess incremental loading.
4. Add your dataset to function "load" of LabelHierarchy in backend/application/data/LabelHierarchy.py.
5. Add your dataset to data "options", "options2" and "DatasetModels" in vis/src/components/ControlView.vue.

For Backend:

Modify the "port = Port(xxx)" and "port.load_dataset(xxx)" statements in \backend\server.py according to your requirements.

cd backend
bash run.sh    (or directly runing server.py)

For Frontend:

Modify the "BACKEND_BASE_URL" to localhost or your ip and port in \vis\build\webpack.base.conf.js according to your requirements.

cd vis
yarn
yarn start

Please come to \evaluation and follow the README.md in subfolders to setup and run evaluation code (for example, eva.py).

Note: Because of the randomness and difference of the operations, samples, and layouts, the results of the evaluation may slightly differ from the results shown in the paper.

If you have any problem about our code, feel free to contact

• HCAGridlayout@gmail.com

or describe your problem in Issues.