This script provides the ability to connect directly to ScienceCloud, download data from libraries or saved queries of your choice and return the results directly into StarDrop. The script was updated in July 2022 to add the ability to access saved queries.

The installer file and instructions for how to install and use the script are provided in the following pages…

Version

Please note: These scripts are compatible with StarDrop 7.3, or earlier versions, for either Windows® or Mac®. To find out which version you have installed, start StarDrop and select the Help->About menu. If you are using an older version of StarDrop please contact [email protected] and we will be happy to provide download details.

Installation

To install this script on Windows:

• Ensure that you have saved your work and close StarDrop
• For 64-bit Windows, download the file StarDrop Script – Science Cloud (64-bit).exe
• When the download is complete, double-click the file to run it and follow the instructions (we recommend that you accept the default options provided)
• Start StarDrop

To install this script on macOS or Windows:

• Ensure that you have saved your work and close StarDrop
• For macOS, download the file StarDrop Script – Science Cloud (OSX).zip
• For 64-bit Windows, download the file StarDrop Script – Science Cloud (64-bit).zip
• In your user area, navigate to the StarDrop folder (on Windows this is in C:\Users\username\AppData\Roaming\StarDrop, on macOS this is in ~/StarDrop)
• Extract the contents of the zip file into this folder overwriting any existing files
• You should now see a folder called ScienceCloud in the py3 folder and a folder called widgetplugins
• Start StarDrop

For StarDrop 7.2 or earlier please use the following files:
On Windows – Download the file StarDrop Script – Science Cloud (64-bit)_py2.exe
On macOS – Download the file StarDrop Script – Science Cloud (OSX)_py2.zip
or Windows – Download the file StarDrop Script – Science Cloud (64-bit)_py2.zip

To use this script…

…click on the Custom Scripts->ScienceCloud menu and choose the desired option (Download from ScienceCloud or Run query from ScienceCloud). This will prompt you to enter a valid user name and password. If you do not have a valid user name, please ask your ScienceCloud contact.

If you choose Download from ScienceCloud you will be presented with a list of all the libraries to which you have access, organised by project. You may select one or more of these libraries to download. If you select more than one library, these will be combined into a single data set in StarDrop. You can also select whether to aggregate the downloaded data by compound or by batch.

If you choose Run query from ScienceCloud you will be presented with a list of all the saved queries to which you have access. You may select one of these queries to download. You can also select whether to aggregate the downloaded data by compound or by batch.

When the download is complete, you will see a dialog that lists all the available assays from your selected libraries or query and allows you to select those assays that you wish to include in the data set. You can also customise the way in which StarDrop treats each assay, by providing an alias to use as a column name, and adding additional columns showing more detailed information about the results. Any customisation that you perform will be remembered next time you download results for that assay.

If you want to update the data in StarDrop, you can repeat the download by selecting Refresh->All data from the DataSet menu. New and updated entries will be clearly identified in your data set.