{"about":{"site":"https://codewithpapers.app","non_affiliation":"Code with Papers and Syntology are not affiliated with, endorsed by, or sponsored by Papers with Code, Meta, or the pwc-archive mirror.","licence":"CC BY-SA 4.0","licence_url":"https://creativecommons.org/licenses/by-sa/4.0/legalcode","attribution":"https://codewithpapers.app/attribution","modified":"archive material modified by Syntology; see the attribution page"},"url":"/paper/arxiv-2602-18064","title":"3DMedAgent: Unified Perception-to-Understanding for 3D Medical Analysis","arxiv_id":"2602.18064","date":"2026-02-20","proceeding":"ICML","authors":["Ziyue Wang","Linghan Cai","Chang Han Low","Haofeng Liu","Junde Wu","Jingyu Wang","Rui Wang","Lei Song","Jiang Bian","Jingjing Fu","Yueming Jin"],"abstract":"3D CT analysis spans a continuum from low-level perception to high-level clinical understanding. Existing 3D-oriented analysis methods adopt either isolated task-specific modeling or task-agnostic end-to-end paradigms to produce one-hop outputs, impeding the systematic accumulation of perceptual evidence for downstream reasoning. In parallel, recent multimodal large language models (MLLMs) exhibit improved visual perception and can integrate visual and textual information effectively, yet their predominantly 2D-oriented designs fundamentally limit their ability to perceive and analyze volumetric medical data. To bridge this gap, we propose 3DMedAgent, a unified agent that enables 2D MLLMs to perform general 3D CT analysis without 3D-specific fine-tuning. 3DMedAgent coordinates heterogeneous visual and textual tools through a flexible MLLM agent, progressively decomposing complex 3D analysis into tractable subtasks that transition from global to regional views, from 3D volumes to informative 2D slices, and from visual evidence to structured textual representations. Central to this design, 3DMedAgent maintains a long-term structured memory that aggregates intermediate tool outputs and supports query-adaptive, evidence-driven multi-step reasoning. We further introduce the DeepChestVQA benchmark for evaluating unified perception-to-understanding capabilities in 3D thoracic imaging. Experiments across over 40 tasks demonstrate that 3DMedAgent consistently outperforms general, medical, and 3D-specific MLLMs, highlighting a scalable path toward general-purpose 3D clinical assistants.Code and data are available at \\href{https://github.com/jinlab-imvr/3DMedAgent}{https://github.com/jinlab-imvr/3DMedAgent}.","url_abs":"https://arxiv.org/abs/2602.18064","url_pdf":"https://arxiv.org/pdf/2602.18064","source":{"archive":null,"snapshot":"2025-07-28","note":"not in the Papers with Code archive (frozen at the snapshot)","row_kind":"graph","title_abstract_authors_date":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)"},"code_links":[],"tasks":[],"methods":[],"datasets_introduced":[],"methods_introduced":[],"results":[],"syntology":{"atlas_url":"https://app.syntology.ai/?focus=2602.18064","mcp":{"get_harvested_code_for_paper":{"arxiv_id":"2602.18064"}},"developers":"https://syntology.ai/developers","read_at":"2026-09-24T18:15:14+00:00","read_at_is":"when the build read Syntology's graph, not when any sample ran","claim":"Per-sample execution status on synthesized fixtures; not a correctness claim about the paper. Samples come from repositories linked to the paper, official or community; repo_kind says which.","repos":[{"mentioned_in_github":null,"is_official":null,"provenance":"deterministic:regex_extraction","mentioned_in_paper":null,"url":"https://github.com/jinlab-imvr/3DMedAgent","reach":null}],"summary":{"unverified":27},"by_repo_kind":{"found_in_text":{"samples":27,"ran":0,"repositories":1}},"repo_kind_vocabulary":{"official":"The archive marks this repository official for the paper","named_in_paper":"The archive records that the paper mentions this repository; it is not marked official","listed":"In the archive's code links for this paper, not marked official and not recorded as mentioned in the paper","found_in_text":"Syntology found this repository in the paper's own text; whether it is the authors' implementation is not asserted","community":"Not in the archive's code links for this paper; a community repository Syntology harvested"},"n_pointer_only_for_licence":27,"samples":[{"code_sha256_prefix":"0586c9dbb390ceee","entry":"apply_text_answer_prompt_overrides","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/GPT_memory_t1s.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/GPT_memory_t1s.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"0586c9dbb390ceee"}},{"code_sha256_prefix":"63afebc93e21a64d","entry":"as_str","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/config.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/config.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"63afebc93e21a64d"}},{"code_sha256_prefix":"365885e2f100694d","entry":"build_summary","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_classify.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_classify.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"365885e2f100694d"}},{"code_sha256_prefix":"0830c0921ec03b85","entry":"canonicalize_organ_name","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_utils.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"0830c0921ec03b85"}},{"code_sha256_prefix":"2e38cae858dad0a6","entry":"get_report_organ_heading","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/tools.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/tools.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"2e38cae858dad0a6"}},{"code_sha256_prefix":"7108ded1ec4567ec","entry":"iter_unique_cases","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_classify.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_classify.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"7108ded1ec4567ec"}},{"code_sha256_prefix":"1e081d59c3953a04","entry":"load_embedding","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_encode.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_encode.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"1e081d59c3953a04"}},{"code_sha256_prefix":"c1c21c6581e9b402","entry":"load_precomputed_embedding","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_utils.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"c1c21c6581e9b402"}},{"code_sha256_prefix":"824dddaa9fb40981","entry":"map_organs_to_backend_prompt","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"segmentation.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/segmentation.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"824dddaa9fb40981"}},{"code_sha256_prefix":"ff00826f29795093","entry":"normalize_lesion_type","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/tools.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/tools.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"ff00826f29795093"}},{"code_sha256_prefix":"eef9187da38365af","entry":"normalize_location_label","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/runtime_tools.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/runtime_tools.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"eef9187da38365af"}},{"code_sha256_prefix":"b0825f197a97911b","entry":"normalize_organ_choice","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/memory.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/memory.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"b0825f197a97911b"}},{"code_sha256_prefix":"4ef64ba3b56669c1","entry":"normalize_organ_name","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/tools.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/tools.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"4ef64ba3b56669c1"}},{"code_sha256_prefix":"d2d53639487fa15a","entry":"parse_lesion_types","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_utils.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"d2d53639487fa15a"}},{"code_sha256_prefix":"de7cabba3aefdcdc","entry":"parse_numeric_options","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/runtime_tools.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/runtime_tools.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"de7cabba3aefdcdc"}},{"code_sha256_prefix":"90eed5b261265365","entry":"parse_option_texts","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/runtime_tools.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/runtime_tools.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"90eed5b261265365"}},{"code_sha256_prefix":"1fce18ef8f9b163e","entry":"parse_target_subtypes","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/pipeline_utils.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/pipeline_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"1fce18ef8f9b163e"}},{"code_sha256_prefix":"406c94d59157f847","entry":"patch_area_grid","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/precompute_organ_scores.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/precompute_organ_scores.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"406c94d59157f847"}},{"code_sha256_prefix":"038caf67087da5e3","entry":"read_json","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/memory.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/memory.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"038caf67087da5e3"}},{"code_sha256_prefix":"5b494e2f48c8b101","entry":"row_get","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/memory.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/memory.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"5b494e2f48c8b101"}},{"code_sha256_prefix":"a9b6d294ce66f64b","entry":"save_case_json","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/clip_classify.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/clip_classify.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"a9b6d294ce66f64b"}},{"code_sha256_prefix":"399f72c014121f56","entry":"score_sections","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/precompute_organ_scores.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/precompute_organ_scores.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"399f72c014121f56"}},{"code_sha256_prefix":"7a78201e746c418b","entry":"score_slices","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/precompute_clip_detail.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/precompute_clip_detail.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"7a78201e746c418b"}},{"code_sha256_prefix":"2ee53f45d108f2f1","entry":"section_ranges","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/precompute_organ_scores.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/precompute_organ_scores.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"2ee53f45d108f2f1"}},{"code_sha256_prefix":"7a4835cc88cfc51b","entry":"select_target_rows","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"Final_Test/pipeline_utils.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/Final_Test/pipeline_utils.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"7a4835cc88cfc51b"}},{"code_sha256_prefix":"04d986faa0452e28","entry":"slice_patch_area_grid","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/precompute_clip_detail.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/precompute_clip_detail.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"04d986faa0452e28"}},{"code_sha256_prefix":"0a3dd4281a057215","entry":"slice_percent","repo":"jinlab-imvr/3DMedAgent","repo_kind":"found_in_text","path":"CT_Clip/precompute_clip_detail.py","file_url":"https://github.com/jinlab-imvr/3DMedAgent/blob/HEAD/CT_Clip/precompute_clip_detail.py","link_basis":"first_harvest_node","language":"python","status":"unverified","verification_level":0,"contract_check":null,"metamorphic_tier":null,"behaviour_fingerprint":false,"licence":"NONE","inline_ok":false,"mcp_get_code":{"code_sha256":"0a3dd4281a057215"}}]},"arxiv_metadata":{"licence":"arXiv metadata, CC0 1.0 (https://info.arxiv.org/help/license)","fields":["title","abstract","authors","date"],"primary_category":"cs.CV","source":"arxiv_2026.jsonl"},"syntology_extracted_results":null}