Giới thiệu về NGS-pipe

NGS-pipe là một công cụ phân tích chuyên dụng cho các thí nghiệm giải trình tự DNA và RNA quy mô lớn. Công cụ này hỗ trợ nhiều chức năng quan trọng, bao gồm phát hiện biến dị di truyền, xác định các biến dị thể soma (SNV), nhận dạng các đoạn chèn và xóa (InDel), phát hiện các sự kiện thay đổi số bản sao (copy number) và phân tích biểu hiện khác biệt. NGS-pipe cung cấp các quy trình phân tích được cấu hình sẵn, giúp người dùng có thể nhanh chóng tạo ra thông tin đột biến, báo cáo chất lượng và tất cả các kết quả trung gian, ngay cả với những người dùng ít kinh nghiệm. Hơn nữa, quy trình này có thể được triển khai trên cả máy tính đơn lẻ hoặc môi trường cụm, với các bước riêng lẻ có thể thực thi song song. Nếu một bước trong quy trình gặp sự cố, tất cả các phép tính phụ thuộc vào bước đó sẽ dừng lại và hiển thị thông báo lỗi. Sau khi vấn đề được giải quyết, quy trình có thể tiếp tục phân tích một cách độc lập mà không cần chạy lại toàn bộ phân tích hoặc xóa thủ công các tệp lỗi.

Các vấn đề phổ biến và cách khắc phục

Vấn đề 1: Cài đặt NGS-pipe

Mô tả vấn đề: Người dùng mới có thể gặp khó khăn trong việc cài đặt NGS-pipe.

Cách giải quyết:

1. Đảm bảo hệ thống của bạn đã cài đặt Python và Git.
2. Sao chép (clone) dự án về môi trường cục bộ của bạn:

   git clone https://github.com/cbg-ethz/NGS-pipe.git

3. Di chuyển vào thư mục dự án và cài đặt các thư viện phụ thuộc:

   cd NGS-pipe
   pip install -r requirements.txt

Vấn đề 2: Chạy các quy trình làm việc đã cấu hình

Mô tả vấn đề: Người dùng có thể không rõ cách khởi động và chạy các quy trình làm việc đã được cấu hình sẵn trong dự án.

Cách giải quyết:

1. Tìm hiểu trong tài liệu của dự án về vị trí của các tệp cấu hình và tham số cho các quy trình khác nhau.
2. Sử dụng lệnh sau để chạy quy trình làm việc (giả sử tệp cấu hình quy trình là `workflow_config.yaml`):

   python execute_workflow.py -c workflow_config.yaml

Vấn đề 3: Xử lý trường hợp quy trình gặp lỗi

Mô tả vấn đề: Trong quá trình chạy quy trình, có thể xảy ra lỗi ở một bước nào đó, và người dùng cần biết cách xử lý.

Cách giải quyết:

1. Xem thông báo lỗi để xác định bước đã thất bại.
2. Khắc phục sự cố đã gây ra lỗi (có thể là vấn đề dữ liệu, lỗi cấu hình, v.v.).
3. Chạy lại bước thất bại hoặc toàn bộ quy trình. Nếu chỉ chạy lại bước thất bại, bạn có thể sử dụng lệnh sau:

   python execute_workflow.py -c workflow_config.yaml --resume-at ten_buoc_that_bai

   Trong đó `ten_buoc_that_bai` là tên của bước đã thất bại.