From 20a927aff55b12ca9518912e89b68e2999155433 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Mon, 4 Dec 2023 11:19:06 +0100 Subject: [PATCH 1/7] Update README.md --- README.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/README.md b/README.md index 5b553a9..4164d7a 100644 --- a/README.md +++ b/README.md @@ -106,18 +106,6 @@ docker pull ghcr.io/jku-vds-lab/reaction-cime:develop docker run -d -p 9000:9000 --name cime4r --detach jkuvdslab/cime ``` -To **update** CIME4R: -```bash -docker rm --force cime4r -docker pull jkuvdslab/cime -docker run -d -p 8080:8080 --name cime4r --detach jkuvdslab/cime -``` - -To **uninstall** CIME4R: -```bash -docker rm --force cime4r -``` - ## Option 3 - Build and run CIME4R from source (for development) From 39898009bb54643dcee56c2bbec7de508a845eb6 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Fri, 22 Dec 2023 09:07:10 +0100 Subject: [PATCH 2/7] update add preprint, citation etc --- README.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 4164d7a..6a8a1a9 100644 --- a/README.md +++ b/README.md @@ -1,24 +1,23 @@ -# ChemInformatics Model Explorer for Reaction Optimization (CIME4R): TODO… -This is the repository for CIME4R (as discussed in the paper). It builds upon the [Projection Space Explorer library](https://github.com/jku-vds-lab/projection-space-explorer). +# CIME4R: Exploring iterative, AI-guided chemical reaction optimization campaigns in their parameter space +This is the repository for CIME4R. It builds upon the [Projection Space Explorer library](https://github.com/jku-vds-lab/projection-space-explorer). -#### Published in: TODO #### -#### DOI: TODO ### +#### Submitted to: Journal of Cheminformatics #### +#### Preprint: https://doi.org/10.26434/chemrxiv-2023-218lq #### +#### DOI: 10.26434/chemrxiv-2023-218lq ### This repository includes: * The implementation of CIME4R - * [Front-end](Application/) web application written in TypeScript using React - * [Back-end](Application/reaction_cime/) python server + * Front-end web application written in TypeScript using React + * [Back-end](reaction_cime/) python server * [Documentation](#documentation) * [Installation](#installation) * [How to cite?](#how-to-cite) -Check out our [paper](TODO url) for further details about the implementation and use cases of CIME4R. +Check out our [paper](https://doi.org/10.26434/chemrxiv-2023-218lq) for further details about the implementation and use cases of CIME4R. Check out the [DEMO website](https://reaction-optimization.jku-vds-lab.at) of CIME4R, which includes the datasets used in the use cases. -Check out the [dataset generation examples](TODO add examples) if you want to try CIME4R with your own dataset. - -Check out the [example datasets](TODO upload to osf) from the paper's use cases. +Check out the [example datasets and generation scripts](https://osf.io/vda72/) used in the paper. # Documentation CIME4R The ChemInformatics Model Explorer for Reaction Optimization (short CIME4R) extension of the [Projection Space Explorer library](https://github.com/jku-vds-lab/projection-space-explorer/tree/develop) allows users to interactively explore the parameter space of chemical reactions and information about the iterative optimization process. The application allows users to understand how a machine learning model arrives at its decision on which experiments to perform next in retrospect (e.g., as proposed in [EDBO](https://www.nature.com/articles/s41586-021-03213-y)). It also facilitates interactive human-AI collaboration for reaction optimization to combine the advantages of both worlds for final decision-making: AI precision and human/expert intuition. @@ -215,13 +214,14 @@ You can cite CIME4R using the following bibtex: ```bibtex @article{humer2023cime4r, - author={TODO}, - journal={TODO}, - title={TODO}, + author={Humer, Christina and Nicholls, Rachel and Heberle, Henry and Heckmann, Moritz and Pühringer, Michael and Wolf, Thomas and Lübbesmeyer, Maximilian and Heinrich, Julian and Hillenbrand, Julius and Volpin, Giulio and Streit, Marc}, + journal={ChemRxiv}, + title={{CIME4R}: {Exploring} iterative, {AI}-guided chemical reaction optimization campaigns in their parameter space}, + shorttitle = {{CIME4R}}, year={2023}, - doi={TODO}, - volume={TODO}, - number={TODO}, + month = dec, + doi={10.26434/chemrxiv-2023-218lq}, + note={This content is a preprint and has not been peer-reviewed.} } ``` From 3635be39709b68e57c0e0b9d35a02902dca7ff80 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Fri, 22 Dec 2023 09:08:05 +0100 Subject: [PATCH 3/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 6a8a1a9..1cfae74 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ This repository includes: * The implementation of CIME4R * Front-end web application written in TypeScript using React * [Back-end](reaction_cime/) python server -* [Documentation](#documentation) +* [Documentation](#documentation-cime4r) * [Installation](#installation) * [How to cite?](#how-to-cite) From 29c6e414d684d8787081a0ffdb4a6101c35a2a15 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Fri, 22 Dec 2023 09:10:22 +0100 Subject: [PATCH 4/7] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1cfae74..f9ece93 100644 --- a/README.md +++ b/README.md @@ -65,7 +65,7 @@ The following describes a list of controls: ## Tab Documentation -[Dataset documentation](src/Readme/Dataset_README.md) +[Dataset](src/Readme/Dataset_README.md) [Projection documentation](src/Readme/Projection_README.md) From 2485527e92025ee3d527d569c3e5b3647f3f4db0 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Fri, 22 Dec 2023 09:10:55 +0100 Subject: [PATCH 5/7] Update README.md --- README.md | 13 +------------ 1 file changed, 1 insertion(+), 12 deletions(-) diff --git a/README.md b/README.md index f9ece93..946ec38 100644 --- a/README.md +++ b/README.md @@ -26,17 +26,6 @@ Since parameter spaces of chemical reactions can be huge, users can apply filter Users can interactively select data points (note: each data point represents one experiment configuration and will be called “experiment” in this documentation) in a 2D scatter plot and show summary statistics of features of all selected experiments in a summary visualization. Instructions for installing the application are provided at the end of this documentation. -##### Table of Contents -[General/Controls](#generalcontrols) -[Dataset](#dataset) -[Projection](#projection) -[Filter](#filter) -[Aggregate](#aggregate) -[Encoding](#encoding) -[Selection Info](#selection-info) -[Groups](#groups) -[Tabular view](#tabular-view) - ## General/Controls This section explains the general layout of the tool and the basic controls with which you can interact with the tool. @@ -65,7 +54,7 @@ The following describes a list of controls: ## Tab Documentation -[Dataset](src/Readme/Dataset_README.md) +[Dataset documentation](src/Readme/Dataset_README.md) [Projection documentation](src/Readme/Projection_README.md) From 754196f42869fa7a35da25d89fbebc892c3ae250 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Fri, 22 Dec 2023 09:29:08 +0100 Subject: [PATCH 6/7] Update README.md --- README.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 946ec38..93a0a99 100644 --- a/README.md +++ b/README.md @@ -83,15 +83,15 @@ Simply copy the `docker-compose-demo.yml` from this repository (or checkout this docker compose -f ./docker-compose-demo.yml up ``` -This will start the server and a corresponding postgres for the datasets. You can the navigate to http://localhost:9000/ and use the application. +This will start the server and a corresponding postgreSQL database for the datasets. You can then navigate to http://localhost:9000/ and use the application. ## Option 2 - Run CIME4R with Docker -If you don't want to use Docker Compose, you need to bring your own postgres. Make sure it is installed locally or override it with the env variable (REACTION_CIME__DBURL=postgresql://admin:admin@db_postgres:5432/db). +If you don't want to use Docker Compose, you need to bring your own postgreSQL database. Make sure it is installed locally or override the environment variable (REACTION_CIME__DBURL=postgresql://admin:admin@db_postgres:5432/db) to link a remote database. To **install** the latest version of CIME4R: ```bash docker pull ghcr.io/jku-vds-lab/reaction-cime:develop -docker run -d -p 9000:9000 --name cime4r --detach jkuvdslab/cime +docker run -d -p 9000:9000 --name cime4r --detach ghcr.io/jku-vds-lab/reaction-cime:develop ``` @@ -141,13 +141,15 @@ and launch the webpack-dev-server via yarn start ``` -Now, if a login screen pops up, you can use admin:admin to login. If you want to disable the login screen and go directly to the application, create a `reaction_cime/.env` with the following contents. After restarting the server, you will be automatically logged in. +Now, if a login screen pops up, you can use admin:admin to login. If you want to disable the login screen and go directly to the application, create a `reaction_cime/.env` with the following contents. ``` VISYN_CORE__SECURITY__STORE__NO_SECURITY_STORE__ENABLE=true VISYN_CORE__SECURITY__STORE__NO_SECURITY_STORE__USER=admin ``` +After restarting the server, you will be automatically logged in. + ### Link PSE If you want to make changes to PSE and view the changes without having to push to the repo and reinstalling dependencies, the recommended way is to use the yarn link/portal and/or our webpack resolveAliases feature. @@ -176,7 +178,7 @@ To now include `projection-space-explorer` to your webpack build, add a `.yo-rc- With that, you can now edit all files of `projection-space-explorer`, including auto-completion (as the node_modules of the application will be used as main lookup), and get hot-reloading. -## Option 3 - Run Application with Docker from Source +## Option 4 - Run Application with Docker from Source ```bash yarn install ``` @@ -193,7 +195,7 @@ docker build -f Dockerfile -t reaction_cime . docker run --rm -it --network host reaction_cime ``` -Beware that you will need a Postgres to run the image. By default, it will use the connection string in `settings.py`, which you can override via ENV variables. For example, you can set `REACTION_CIME__DBURL=postgresql://...` and use any database of your liking. +Beware that you will need a Postgres to run the image. By default, it will use the connection string in `settings.py`, which you can override via environment variables. For example, you can set `REACTION_CIME__DBURL=postgresql://...` and use any database of your liking. From 536dbc6db74ff2c6aa5f04306bdf31264e5ca753 Mon Sep 17 00:00:00 2001 From: ginihumer <45741696+ginihumer@users.noreply.github.com> Date: Fri, 22 Dec 2023 11:31:52 +0100 Subject: [PATCH 7/7] Update README.md --- README.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 93a0a99..386763c 100644 --- a/README.md +++ b/README.md @@ -13,9 +13,13 @@ This repository includes: * [Installation](#installation) * [How to cite?](#how-to-cite) +Check out our [project website](https://jku-vds-lab.at/publications/2024_cime4r/). + Check out our [paper](https://doi.org/10.26434/chemrxiv-2023-218lq) for further details about the implementation and use cases of CIME4R. -Check out the [DEMO website](https://reaction-optimization.jku-vds-lab.at) of CIME4R, which includes the datasets used in the use cases. +Check out the [Demo website](https://reaction-optimization.jku-vds-lab.at) of CIME4R, which includes the datasets used in the use cases. + +Check out the [Demo video](https://www.youtube.com/watch?v=feqZWesf5Ws) of CIME4R. Check out the [example datasets and generation scripts](https://osf.io/vda72/) used in the paper.