Woori BNC
닫기
고객센터

면역진단 분석 프로그램 개발: 연구자 알고리즘 구현

2021.01.08 조회 2579

우리비엔씨가 면역진단 기술을 연구하는 바이오 스타트업을 위해 개발한 면역진단 분석 프로그램 사례입니다. 검진센터 장비에서 나온 면역검사 결과를 엑셀로 불러와 고객사가 정한 알고리즘으로 계산하고, 차트번호별 검사 리포트로 출력하는 Windows 프로그램입니다. 알고리즘은 고객사가 직접 연구해 만든 것이고, 우리비엔씨는 그 계산식을 프로그램 안으로 옮겨 입력부터 출력까지 한 흐름으로 묶었습니다.

면역진단 분석 프로그램이 출력한 기본면역 진단검사 리포트 1페이지: 면역나이와 면역노화 비교 막대, 면역력 스코어와 면역노화 지수, 8개 검사항목 스코어 막대 그래프

프로그램이 출력하는 검사 리포트 1페이지(샘플 데이터). 피검자 정보와 로고는 가렸습니다.

면역진단 분석 프로그램 의뢰 내용

고객사는 직접 연구한 면역진단 알고리즘을 시제품 성격의 프로그램으로 만들고 싶어 했습니다. 의뢰서와 과업지시서를 펼쳐 보니 프로그램의 재료가 될 자료가 네 가지 있었고, 각각을 프로그램에서 어떻게 다룰지부터 정리했습니다.

고객사 자료내용프로그램에서 할 일
검사 원자료검진센터 장비에서 항목별로 정리되어 나오는 엑셀 파일엑셀·CSV 불러오기, 직접 입력·붙여넣기
엑셀 참고 파일데이터 시트와 출력 시트로 나뉘고, 차트번호를 넣으면 결과지가 바뀌는 구조차트번호로 조회해 리포트 출력
알고리즘 수식틀은 잡혀 있고, 검사를 더 진행하며 다듬을 예정계산 로직으로 구현, 상수가 바뀔 수 있음을 전제
결과지 모형고객사가 직접 그린 1페이지 도안협의를 거쳐 그래픽 결과지로 구성

결과지 모형은 고객사가 손수 디자인한 것이었는데, 의뢰서에는 “이렇게 만들 필요는 없다”는 말과 함께 꼭 들어가야 할 값이 정리되어 있었습니다. 처음 도안에 있던 온도계 그림은 고객사 요청에 따라 바뀌었고, 완성된 결과지는 위 이미지처럼 젊은 인물과 나이 든 인물 그림 사이에 막대를 놓는 방식으로 정리됐습니다. 그림 하나 고르는 일도 결국 “일반인이 한눈에 이해할 수 있느냐”는 고객사의 기준을 따른 셈입니다.

고객사와 우리비엔씨의 역할 분담

이런 프로젝트에서 가장 먼저 분명히 해야 하는 것은 역할입니다. 과업지시서에는 결과값 계산에 필요한 수식과 알고리즘을 고객사가 제공한다고 적혀 있었습니다. 어떤 값을 낼지, 그 값이 무엇을 뜻하는지, 결과지에 어떤 문장을 쓸지는 모두 고객사가 정했습니다.

우리비엔씨가 맡은 일은 받은 계산식을 그대로 프로그램 안에 구현하고, 피검자 정보 입력부터 결과지 출력까지가 한 프로그램 안에서 이어지게 만드는 것이었습니다. 수식의 의학적 해석이나 판정 기준은 개발 범위에 넣지 않았습니다.

고객사가 정한 것(알고리즘 계산식과 상수, 결과값의 종류와 의미, 결과지 도안, 요약 문구)과 우리비엔씨가 만든 것(데이터 입력과 저장, 엑셀·CSV 불러오기, 수식의 계산 로직 구현, 리포트·그래프 출력)을 나눈 구조 설명 도식

구조 설명용 도식: 기준은 고객사가 정하고, 프로그램은 그 기준대로 계산하고 출력합니다.

프로그램 주요 기능 4가지

완성된 프로그램의 기능은 네 가지입니다. 고객사가 엑셀에서 하던 일을 순서대로 프로그램 화면으로 옮겼다고 보면 됩니다.

면역진단 분석 프로그램의 데이터 흐름 도식: 피검자 기본정보와 면역검사 원자료가 검사 데이터 시트로 들어가고, 고객사 알고리즘으로 면역나이·면역노화·면역력 스코어·면역노화 지수·8개 항목 스코어가 계산되어 차트번호별 리포트와 분석 그래프로 출력

구조 설명용 도식: 입력에서 결과지까지의 데이터 흐름

1. 피검자 정보 관리

첫 화면에서 차트번호, 날짜, 이름, ID, 성별 같은 기본정보를 직접 입력하거나 엑셀에서 복사해 붙여넣습니다. 차트번호는 검사자가 쌓이는 순서대로 자동으로 매겨지고, 검사 결과와 리포트, 그래프는 모두 이 차트번호를 기준으로 찾습니다.

2. 검사 결과 업로드와 알고리즘 적용

검사 결과는 엑셀처럼 행과 열로 된 시트에 직접 입력하거나, 엑셀 파일 또는 CSV 파일을 읽어 불러옵니다. 입력이 끝나면 고객사가 제공한 알고리즘으로 결과값이 계산되어 각 행과 열에 표시됩니다. 고객사가 쓰던 엑셀 참고 파일의 ‘데이터 시트’를 프로그램 화면으로 옮긴 부분입니다.

3. 차트번호별 리포트 출력

차트번호를 고르면 그 피검자의 결과지가 만들어지고, 출력해서 피검자에게 전달합니다. 결과지에 나오는 값은 아래 다섯 가지이며, 모두 고객사 알고리즘이 계산한 값입니다.

결과값결과지에서 보이는 방식
면역나이출생나이와 나란히 놓고, 두 나이의 차이를 함께 표시
면역노화(%)0~100% 사이 값, 기대 값과 실제 값을 나란히 표시
면역력 스코어구간별 색 막대 위에 실제 값과 기대 값의 위치 표시
면역노화 지수숫자로 표시
8개 검사항목 스코어-2~2 사이로 바꾼 값을 항목별 막대 그래프로 표시, 범위를 넘는 값은 그래프 끝에 맞춰 표시

결과 요약 문구도 자동으로 들어갑니다. 예를 들어 면역나이는 출생나이와 같거나, 많거나, 적은 세 가지 경우가 있으므로 경우마다 정해진 문장이 들어가는 식입니다. 문장의 내용 역시 고객사가 정한 것입니다.

4. 차트번호별 분석 그래프 조회

리포트와 별도로, 차트번호별로 8개 검사항목의 결과를 그래프로 볼 수 있습니다. 항목마다 평균값(고정값)과 해당 검사자의 결과값을 나란히 보여주고, -2~2 사이로 바꾼 항목별 스코어와 면역력 스코어도 함께 확인합니다.

수식 변경 대비 요구사항

의뢰서에는 “현재 알고리즘 수식은 틀은 잡혀 있으나 아직 완성된 것은 아니다”라는 문장이 있었습니다. 과업지시서에도 개발이 끝난 뒤 임상 결과가 쌓이면 수식의 상수 같은 숫자가 바뀔 수 있으니, 그때 신속하게 업그레이드할 수 있어야 한다는 요구가 들어 있었습니다.

이 프로그램은 기본면역진단용 시제품이었고, 고객사는 이후 표준·정밀 면역진단처럼 검사 항목과 결과물, 그래픽이 늘어나는 확장을 계획하고 있었습니다. 나중에는 서버를 두고 웹이나 스마트폰 앱으로 결과를 확인하는 방식도 염두에 두고 있었습니다.

연구 단계의 알고리즘을 프로그램으로 만들 때는 이 부분이 늘 따라옵니다. 수식이 확정될 때까지 기다리면 일정이 밀리고, 수식이 바뀔 때마다 프로그램 전체를 손봐야 한다면 비용이 되풀이됩니다. 그래서 계산 부분은 입력 화면이나 결과지와 떼어 한곳에 모아 두는 것이 이런 프로그램의 기본 설계 방향입니다.

프로젝트 개요

항목내용
의뢰 고객면역진단 기술을 연구하는 바이오 스타트업
개발 기간2020.08 ~ 2020.12
프로그램면역진단 솔루션 Magicien (Windows 설치형)
개발 환경C#, .NET Framework 4.0, DevExpress WinForms
데이터베이스SQLite
주요 기능피검자 정보 관리, 검사 결과 업로드와 알고리즘 적용, 차트번호별 리포트 출력, 차트번호별 분석 그래프 조회
역할 분담알고리즘·결과지 도안: 고객사 / 프로그램 개발: 우리비엔씨

의뢰 전 준비 자료

  • 장비가 내보내는 결과 파일 샘플(엑셀·CSV). 피검자 정보는 가명으로 바꿔 주셔도 충분합니다.
  • 계산식이 들어 있는 엑셀 파일이나 수식을 정리한 문서
  • 입력값과 그때 나와야 하는 결과값 예시 몇 건. 프로그램 계산이 맞는지 맞춰 보는 기준이 됩니다.
  • 결과지 도안. 손그림이나 엑셀 화면이어도 괜찮습니다.
  • 요약 문구를 나누는 경우와 경우별 문장
  • 앞으로 늘릴 검사 항목이나 웹·앱 계획이 있다면 그 방향

자주 묻는 질문

Q. 알고리즘이 아직 완성되지 않았는데 개발을 시작해도 되나요?

이 사례도 의뢰 당시에는 수식의 틀만 잡혀 있는 상태였습니다. 결과값의 종류와 결과지 구성, 입력 데이터 형식을 먼저 정하면 계산식이 다듬어지는 동안에도 나머지 부분을 만들어 갈 수 있습니다. 다만 수식이 바뀌었을 때 프로그램을 어떻게 갱신할지는 처음에 함께 정해 두는 것이 좋습니다.

Q. 프로그램이 검사 결과를 판정해 주나요?

아닙니다. 판정 기준과 계산식은 의뢰한 쪽이 정하고, 프로그램은 그 기준대로 계산해 결과지로 보여주는 도구입니다. 우리비엔씨는 수식의 의학적 해석에는 관여하지 않고, 받은 수식이 프로그램 안에서 그대로 계산되도록 구현하는 일을 맡습니다.

Q. 검사 장비가 내보내는 엑셀 양식이 다르면 어떻게 하나요?

이 프로그램은 엑셀·CSV 불러오기와 함께, 시트에 직접 입력하거나 붙여넣는 방법도 두었습니다. 그래서 파일 형식이 맞지 않더라도 데이터를 옮겨 넣을 수 있습니다. 장비나 양식이 여러 가지라면 개발 전에 샘플을 모두 받아 항목을 어떻게 맞출지 먼저 정합니다.

Q. 피검자 정보는 어디에 저장되나요?

이 프로그램은 PC에 설치해 쓰는 Windows 프로그램이고, 데이터는 SQLite 파일 데이터베이스에 저장됩니다. 상담이나 개발 단계에서 주고받는 샘플은 실제 피검자 정보 대신 가명 데이터로 충분합니다.

함께 보면 좋은 개발 사례


작성: 우리비엔씨 대표 이완종 (KOSA 특급기술자)

홈페이지: https://www.wooribnc.com

연락처: 070-4809-7769 // 0 1 0 - 5 1 7 7 - 8 0 5 5

이메일: admin@wooribnc.com // lwjvegas@gmail.com

  • KOSA 소프트웨어사업자 등록업체
  • KOSA 소프트웨어기술자경력 특급기술자, 정보처리기사
  • 가천대학교 가족회사 협약업체

Tags: #면역진단분석프로그램 #면역진단 #검사결과리포트 #알고리즘프로그램개발 #바이오소프트웨어 #의료데이터 #윈도우프로그램 #CSharp #우리비엔씨

수정 삭제 목록