# CRTC Toolkit
Toolkit for CRTC data visualization and analysis
The CRTC Toolkit provides a series of applications which allow for annotating and collecting individual cells from microscopy images, segmenting those cells into nuclear and cytoplasmic regions, and performing data analysis using the relative expression levels of CRTC in each region. The toolkit is provided as a set of compiled MATLAB apps, with source code available for modification and further scripting of the pipeline and workflows.
### Installation
The toolkit can be installed on Windows and MacOS, although the Windows version is more stable and thoroughly tested. Access installers from the [Releases](https://github.com/HattoriLabUTSW/CRTCtoolkit/releases) section. On MacOS, the ResNet used for cytoplasmic/nuclear segmentation (`crtcUbwonkoNet_resnet50.mat`) must be downloaded separately and supplied as a path in the `Segment Cells` portion of the workflow.
The MATLAB Runtime is required to run the toolkit, and the correct version should be automatically downloaded by the installer if not already present on your computer. If your network is restricted (e.g., behind an institutional proxy), click the `Connection Settings` button in the first step of the installer and supply the appropriate information.
### Usage
The process of analyzing raw CRTC data using the toolkit is divided into two steps in the GUI, the core workflow and the data analysis portion. The former involves extracting cells images from CZI files and segmenting them into nuclear vs. cytoplasmic regions. The latter step uses the segmented cell data to calculate nuclear localization indices of each cell, aggregate by experimental group, generate figures, and optionally conduct basic statistical analyses.
##### Core workflow
Begin with all CZI files in a single directory. Use the `Get Cells` app to capture cell bodies from each CZI file:
- Navigate to the optimal z-slice (generally the middle) for each cell, and click `Draw Rectangle` to create a tightly bound region in which the cell is contained.
- Click `Done with rect` when satisfied, and review the cell image in the top right box.
- If the image contains a single identifiable cell, click `Done with cell`, and move to the next cell in the z-stack.
- When all cells in an image have been marked, use the `Save data` button to export the cell locations to a `.mat` file.
Next, use the `Segment Cells` app to note the cytoplasmic and nuclear components of each cell image:
- If the `ResNet` file is not pre-filled (e.g., on MacOS), browse to and select the location of the downloaded `crtcUbwonkoNet_resnet50.mat` file.
- Browse to and select the data folder, which contains the `data4*.mat` files generated by the `Get Cells` app.
- Click the `Process` button to use the ResNet to automatically generate cytoplasmic/nuclear segmentations and update the data files.
Finally, use the `Check and Correct Cells` app to verify and fix automatic segmentations:
- Select the folder containing the `data4*.mat` files which have been updated with segmentation values. Use the `Next` and `Prev` buttons for images and cells to navigate through the automatic segmentations.
- If an incorrect segmentation is seen, use the `Draw Nuc ROI` and `Draw Cell ROI` buttons to manually annotate the nucleus and cell, respectively.
- Click the `Save Data` button to generate `corr_data4*.mat` files which incorporate the manually corrected data where appropriate, and use the automatic segmentation values where corrections were not made.
##### Data analysis
Reorganize `corr_data4*.mat` files and `data4*.mat` files into an experimental structure, ensuring that no images are represented twice (e.g., for each image, there must be only one `.mat` file. An experimental structure will look like:
- Experiment directory
- Condition 1
- FLY01
- FLY02
- FLY...
- Condition 2
- FLY01
- FLY02
- FLY...
- Condition ...
Then, you can use the `Per Condition Analysis App` to analyze only a single experimental condition:
- Include the condition name in the appropriate box. Use the `Save data` checkbox if you'd like for output to be saved as an Excel file and a `.fig` file.
- Select colors for the plots to be generated.
- Browse to and select the appropriate condition folder, which should contain subfolders named in the format `FLYnn`, as shown above.
- Click the `Start analysis` button to generate and save figures as specified.
Or, you can use the `Cross-Group Analysis App` to analyze and compare multiple experimental conditions, outputting statistical results as a part of the process:
- Provide the experiment name in the topmost textbox. Use the `Save data` checkbox if you'd like for output to be saved as an Excel file and a `.fig` file.
- Select colors for each experimental group to be plotted, up to eight.
- Optionally, you can modify the y-axis bounds on the NLI plots which will be generated.
- Browse to and select the experiment folder, which should follow the structure specified above.
- Click the `Start analysis` button to generate and save figures/data as specified.
##### Convenience tools
A handful of tools are provided as a part of the toolkit.
The `Manual Annotation App` combines the `Get Cells App` and the `Check and Correct Cells App` in cases where the network-based automatic segmentation is not desired:
- Select a CZI file.
- Scroll through the z-stack to find a slice which contains a cell body.
- Mark the cell body with a rectangle as described in the `Get Cells App` section.
- Optionally, use the `Auto ROI` button to generate a segmentation for the cell using k-means clustering.
- Use the `Draw Cell ROI` and `Draw Nuc ROI` buttons to manually segment the cell.
- Click `Done With Cell` when satisfied with the segmentation.
- Click the `Save Data` button when done with the CZI file.
The `MIP from CZI App` generates maximum intensity projections from a directory containing CZI files. This tool will create a subfolder per CZI file, saving `.png` images of MIP per channel as well as merged MIP:
- Browse to and select a folder containing `.CZI` files.
- Update the channel options if necessary to map each channel to the desired color.
- Click `Create MIP` to generate the aforementioned output.
The `Open .fig File App` provides a simple convenience tool to reopen saved `.fig` files from previous sections of the toolkit:
- Browse to and select a `.fig` file.
- Click open to re-open the file in the MATLAB GUI.
### Extending from source code
If you have access to a MATLAB license, the raw source code provides a powerful interface to modify the toolkit to optimally fit your workflow. The CRTC toolkit has been created and tested using MATLAB version R2021b. Necessary add-ons and packages are listed in the `analyzeCRTC.m` file, which also provides a well-documented guide to scripting the different components of the toolkit.
Many intermediate steps of the toolkit generate `.mat` files, which can be examined and interacted with using MATLAB.
没有合适的资源?快使用搜索试试~ 我知道了~
CRTC数据可视化和分析工具包.zip
共35个文件
m:22个
mlapp:9个
png:2个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 79 浏览量
2024-05-12
11:20:25
上传
评论
收藏 39.42MB ZIP 举报
温馨提示
1.版本:matlab2014/2019a/2021a 2.附赠案例数据可直接运行matlab程序。 3.代码特点:参数化编程、参数可方便更改、代码编程思路清晰、注释明细。 4.适用对象:计算机,电子信息工程、数学等专业的大学生课程设计、期末大作业和毕业设计。
资源推荐
资源详情
资源评论
收起资源包目录
CRTC数据可视化和分析工具包.zip (35个子文件)
CRTC数据可视化和分析工具包
CRTCtoolkit-main
crtc_toolkit_app.mlapp 84KB
loadcolors.m 1KB
crtc_per_condition_analysis_f.m 7KB
crtc_mip_from_czi_app.mlapp 21KB
crtc_analyze_across_groups_f.m 4KB
crtc_correct_cells_app.mlapp 85KB
crtc_manual_annotation_app.mlapp 92KB
make_mip_from_czi_f.m 3KB
crtc_per_condition_analysis_app.mlapp 31KB
padImageCenter_f.m 336B
splash.png 16KB
crtc_batch_process_by_ubwonkonet.m 4KB
readme.md 7KB
analyzeCRTC.m 7KB
crtc_segment_cells_app.mlapp 29KB
bfmatlab
bfGetPlane.m 4KB
createMinimalOMEXMLMetadata.m 4KB
bioformats_package.jar 40.99MB
bfUpgradeCheck.m 3KB
bfsave.m 6KB
bfopen.m 8KB
bfOpen3DVolume.m 2KB
bfGetFileExtensions.m 3KB
bfInitLogging.m 2KB
bfCheckJavaPath.m 3KB
bfTestInRange.m 2KB
bfGetReader.m 3KB
bfCheckJavaMemory.m 2KB
private
is_octave.m 2KB
bfGetPlaneAtZCT.m 3KB
crtc_analyze_across_groups_app.mlapp 44KB
crtc_open_fig_file_app.mlapp 15KB
icon.png 28KB
readczi_f.m 2KB
crtc_get_cells_app.mlapp 209KB
共 35 条
- 1
资源评论
matlab科研助手
- 粉丝: 1w+
- 资源: 2054
下载权益
C知道特权
VIP文章
课程特权
开通VIP
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功