Package: vampireanalysis
VAMPIRE (Visually Aided Morpho-Phenotyping Image Recognition)A robust method to quantify cell morphological heterogeneity1. System requirementsOS : Windows 10 (64 bit) Version 1909Software is not compatible with older versions of Windows.Mac OS is not officially supported, but it may work when installed using pip.Non-standard hardware is not required.2. Installation GuideExecutable file option:No installation required. Download the executable file fromhttps://github.com/kukionfr/VAMPIRE_open/releases/download/executable/vampire.exeOpen the executable file to launch the graphic user interface (GUI) of the software\PIP installation option:Type the following into command prompt window to install vampireanlysis on PYPI (the Python package index) using pip installerpip install vampireanalysisTo launch the GUI, type "vampire" into command prompt window.3. DemoInstructions to run on data can be found in the Procedure section of the manuscript.Sample images to run VAMPIRE can be found in Supplementary Data:https://github.com/kukionfr/VAMPIRE_open/tree/master/Supplementary%20DataBigger dataset is also available in these two repositories:1.https://github.com/kukionfr/Aging_human_dermal_fibroblast_nucleus2.https://github.com/kukionfr/Micropattern_MEF_LMNA_ImageExpected output of the procedure is provided in the Figure 5 of the manuscript and also in the supplementary files.Expected run time for demo :Step 1-2, Segment cells or nuclei, 5~10 minsStep 3, Create a list of images to build the shape-analysis model, 1-3 minsSteps 4-9, Build shape-analysis model in VAMPIRE, 1-5 minsSteps 10-12, Application of the model to analyze shapes across conditions, 1-5 minsTotal, steps 1-12, complete VAMPIRE analysis, 8-23 mins4. Instructions for useInstructions to run on data can be found in the Procedure section of the manuscript.By following the Procedure section, the users can reproduce the expected output data provided in the supplementary files.5. Code functionalityThe source code can be installed using pip: “pip install vampireanalysis” for Python 3.6 or later.After installation using pip, type “vampire” in the command window prompt to launch the GUI.\•	vampire.py : launch Tk interface for VAMPIRE GUI.•	mainbody.py : read the boundaries of cells or nuclei and process them through three key functions of VAMPIRE analysis: 1. Registration 2. PCA 3. Cluster.•	collect_selected_bstack.py : read the boundaries of cells or nuclei based on the CSV files that contains list of image sets to build or apply the VAMPIRE model.•	bdreg.py: register boundaries of cells or nuclei to eliminate rotational variance.•	pca_bdreg.py : apply PCA to the registered boundaries.•	PCA_custom.py  : principal component analysis code.•	clusterSM.py : apply K-means clustering to PCA processed boundaries of cells or nuclei and assign the cluster number label to each cell or nuclei.•	update_csv.py : generate VAMPIRE datasheet based on the assigned cluster labelCodes that are not mentions here belongs to the codes explained. The provided explanation applies to those as well.\Python library dependenciespandas==1.1.0numpy==1.19.1scikit-learn==0.23.2matplotlib==3.3.0pillow==7.2.0opencv-python==4.3.0.36dask==2.22.0scipy==1.5.2scikit-image==0.17.2