Package: kc-hits
kc-hitsDescriptionInstalling and running the applicationIf python (v3.8+) is already installed on the systemIf python is not installed on the systemCreating a development environmentBuilding a standalone executableReleasesStandalone executablesScreenshots of elements of the applicationReferencesDescriptionThe software "key characteristics of carcinogens - high throughput screening discovery tool" orkc-hitsis a tool useful in the process of evaluating and classifying chemicals for their carcinogenicity [^1].It was developed by a team at the International Agency for Research on Cancer (IARC) to help automate the workflow involved in related results from high throughput assays, such as those generated under the ToxCast/Tox21 program [^2], with the Key Characteristics of Carcinogens [^3].It is a Python application with a graphical user interface.Installing and running the applicationNOTE: The application makes use of a database of chemical and assay data. The process of loading the database can be relatively slow on some platforms. So, there may be a significant lag between the time the application is launched and the graphical user interface appears. However, once started, the software should run relatively quickly.If python (v3.8+) is already installed on the systemInstallkc-hitsusingpip:$ pip install kc-hitsThe application creates a launchable executable that should be runnable using the following (or some variation, depending on the operating system):$ kc-hits_vxxx.exewhere xxx is the version number (e.g.,kc-hits_v0.6.0.exe).If python is not installed on the systemMake use of one of the standalone executables listed below. No further dependencies should be required. The executable should be launchable as any other application on the system.Creating a development environmentThere are several dependencies that must be installed. These are listed inenvironment.yml.It is recommended that users create a virtual environment to run or work
with the application.The commands below reflect the use of thecondatool for managing virtual environments.After cloning the repository and navigating into the main directory, create the environment with the dependencies and activate the environment:$ conda env create -f environment.yml

$ conda activate kc_hitsThe application may then be run using$ python kc_hits.pyBuilding a standalone executableTo build a standalone executable, make sure the virtual environment is active and that thepyinstallerexecutable is in your path. Then use the following:$ pyinstaller -wF --clean kc_hits.specThe executable will be created in thedistsubdirectory.ReleasesVersionNotes0.5.4Used in the workflow for IARC Volume 1300.6.0Incorporates information from the ToxCast/Tox21 data release v3.4Standalone executablesVersionPlatformurl0.6MS Windowshttps://doi.org/10.5281/zenodo.5831533Screenshots of elements of the applicationThe chemical selection pane:The two panes with summary results shown:The two panes with detailed results shown:One of the worksheets of the saved report spreadsheet:References[^1]: Samet,J.M. et al. (2020) The IARC Monographs: Updated Procedures for Modern and Transparent Evidence Synthesis in Cancer Hazard Identification. J. Natl. Cancer Inst., 112, 30–37.
[^2]: Richard,A.M. et al. (2016) ToxCast Chemical Landscape: Paving the Road to 21st Century Toxicology. Chem. Res. Toxicol., 29, 1225–1251.
[^3]: Smith,M.T. et al. (2016) Key Characteristics of Carcinogens as a Basis for Organizing Data on Mechanisms of Carcinogenesis. Environ. Health Perspect., 124, 713–721.