A DICOM (https://docs.fileformat.com/image/dicom/) formátumú orvosi képek JPG formátumba konvertálása gyakori feladat, amikor a radiológiai alkalmazásoknak tanulmányokat kell megjeleníteniük webportálokon vagy mobil nézőkben. Az Aspose.HTML Cloud SDK for Python robusztus könyvtárat biztosít, amely a szerveroldali nehéz munkát elvégzi. Ebben az útmutatóban lépésről lépésre megtanulja, hogyan valósítsa meg a DICOM‑ról JPG‑re konverziót Pythonban, felfedezheti a több szálas lehetőségeket, és megtekintheti, hogyan hívható meg ugyanaz a szolgáltatás cURL‑lel REST‑alapú munkafolyamatokhoz.
A DICOM-ből JPG-re konvertálás követelményei
A radiológiai munkaállomások gyakran kapnak DICOM fájlokat, amelyeket könnyű JPG bélyegképekké kell renderelni a gyors előnézet érdekében. A fejlesztőknek olyan megoldásra van szükségük, amely:
- Bináris DICOM adatokat olvas be anélkül, hogy külső képalkotó könyvtárakra támaszkodna.
- A képet széles körben támogatott formátumba, például JPG-be konvertálja, miközben megőrzi a diagnosztikai minőséget.
- Nagy mennyiségű fájlt hatékonyan kezel, lehetőleg párhuzamos feldolgozással.
A kézi átalakítás asztali eszközökkel időigényes, és nem skálázható a szerveroldali csővezetékekhez, ami elengedhetetlenné teszi az automatizált API-t a modern radiológiai szoftverek számára.
A megközelítés: optimalizált felhőalapú konverziós munkafolyamat
Az Aspose.HTML Cloud SDK for Python felhőalapú API-t kínál, amely elvonja a konverziós logikát. A szolgáltatás:
- Elfogadja a nyers DICOM bájtokat, és JPG bájtfolyamot ad vissza.
- Az Aspose felhőben fut, így nincs szükség helyi DICOM elemzőkre.
- Konfigurációs lehetőségeket biztosít a képek minősége, felbontása és a több szálon történő végrehajtás számára.
Tekintse meg a hivatalos dokumentációt a hitelesítési részletekért, és az API referenciát a tutorialban használt ConvertDocumentRequest osztályhoz.
DICOM JPG konverzió megvalósítása Pythonban
Az alábbiakban egy gyakorlati, lépésről‑lépésre megvalósítást talál, amelyet bármely radiológiai háttérrendszerbe integrálhat.
Telepítés Aspose.HTML Cloud SDK for Python
pip install asposehtmlcloud
API kliens konfigurálása a hitelesítő adataival
from asposehtmlcloud import HtmlApi, Configuration
config = Configuration()
config.api_key['api_key'] = api_key # Replace with your actual API key
config.host = "https://api.aspose.cloud"
html_api = HtmlApi(config)
DICOM-fájl betöltése memóriába
with open(input_file, "rb") as f:
dicom_bytes = f.read()
Konverziós kérés létrehozása JPG kimenethez
from asposehtmlcloud import ConvertDocumentRequest
request = ConvertDocumentRequest(
file=dicom_bytes,
format="jpg"
)
JPG bájtok írása lemezre
jpg_bytes = html_api.convert_document(request)
with open(output_file, "wb") as out_f:
out_f.write(jpg_bytes)
Ezekkel a lépésekkel a DICOM‑ról JPG‑re konvertálási munkafolyamat befejeződött, és most már beillesztheti az eszközt nagyobb csővezetékekbe, vagy meghívhatja parancssori szkriptekből.
DICOM to JPG konvertáló segédprogram - Teljes kódpélda
Az alábbi példa bemutatja a teljes vég‑ponttól‑végig folyamatot.
import os
from asposehtmlcloud import HtmlApi, Configuration, ConvertDocumentRequest
def dicom_to_jpg(input_file: str, output_file: str, api_key: str):
# Configure Aspose.HTML Cloud SDK
config = Configuration()
config.api_key['api_key'] = api_key # Replace with your actual API key
config.host = "https://api.aspose.cloud"
# Initialize the API client
html_api = HtmlApi(config)
# Read the DICOM file into memory
with open(input_file, "rb") as f:
dicom_bytes = f.read()
# Build the conversion request (target format: jpg)
request = ConvertDocumentRequest(
file=dicom_bytes,
format="jpg"
)
# Perform conversion – the response is a binary stream of the JPG image
jpg_bytes = html_api.convert_document(request)
# Write the resulting JPG to disk
with open(output_file, "wb") as out_f:
out_f.write(jpg_bytes)
if __name__ == "__main__":
# Example usage
INPUT_DICOM = "sample.dcm" # Path to your source DICOM file
OUTPUT_JPG = "sample_converted.jpg" # Desired output path
API_KEY = "YOUR_ASPOSE_CLOUD_API_KEY"
dicom_to_jpg(INPUT_DICOM, OUTPUT_JPG, API_KEY)
Megjegyzés: Ez a kódrészlet bemutatja a fő funkciót. Mielőtt a projektjében használná, győződjön meg róla, hogy frissíti a fájlutakat és a konfigurációs értékeket a tényleges környezetnek megfelelően, ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztői környezetben. Ha problémába ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy vegye fel a kapcsolatot a támogatási csapattal segítségért.
Többszálú konvertálás REST API-n keresztül cURL használatával
Ha inkább tiszta REST megközelítést részesít előnyben, ugyanaz a konverzió végrehajtható cURL parancsokkal. Ez hasznos a parancssori automatizáláshoz vagy a CI csővezetékek integrálásához.
- Szerezzen hozzáférési tokent
curl -X POST "https://api.aspose.cloud/connect/token" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Töltse fel a DICOM fájlt
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/sample.dcm" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/dicom" \
--data-binary "@sample.dcm"
- Kérje a konvertálást JPG formátumba
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"FileName":"sample.dcm"}' \
-o sample_converted.jpg
- Töltse le a konvertált JPG-t (ha nem mentették közvetlenül)
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/sample_converted.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o sample_converted.jpg
Ezek a parancsok egy többszálú konverziós munkafolyamatot szemléltetnek, ahol több fájl is párhuzamosan feldolgozható több feltöltés/konvertálás pár egyszerre történő kiadásával. A teljes API részletekért tekintse meg a hivatalos API dokumentációt.
A DICOM JPG-re konvertálásának beállításainak konfigurálása
Az SDK lehetővé teszi a kimenet finomhangolását. A gyakori beállítások a következők:
- Képminőség - Állítsa be a JPEG tömörítési szintet (0‑100).
- Felbontás - Állítsa be a DPI-t a nagy felbontású kimenethez.
- Színmód - Válasszon a szürkeárnyalat és a színes között, ha a DICOM színes adatot tartalmaz.
Átadhatja ezeket a beállításokat a kérés payload-jában. Például a minőség beállításához:
request = ConvertDocumentRequest(
file=dicom_bytes,
format="jpg",
options={"quality": 90}
)
Minden támogatott paraméter le van írva az API-referencia oldalon. Kísérletezzen ezekkel a beállításokkal, hogy a legjobb egyensúlyt érje el a fájlméret és a diagnosztikai tisztaság között, különösen nagy DICOM adathalmazokkal dolgozva.
Összegzés
DICOM → JPG konvertálás Pythonban egyszerűvé válik az Aspose.HTML Cloud SDK for Python használatával. A könyvtár elvégzi a nehéz munkát, több szálon futtatást kínál nagy áteresztőképességű környezetekhez, és részletes vezérlést biztosít a képminőség felett. Ne felejtse el biztosítani a megfelelő kereskedelmi licencet a termelési környezetben; az árak részletei a termékoldalon érhetők el, és egy ideiglenes licencet a ideiglenes licenc oldal szerezhet be. A fenti kóddal és cURL példákkal ma már beépítheti a megbízható DICOM → JPG konvertálást bármely radiológiai alkalmazásba.
GYIK
Milyen fájlformátumokat tud az Aspose.HTML Cloud SDK konvertálni a DICOM-on kívül?
Az SDK számos formátumot támogat, többek között a PDF, PNG, BMP, GIF, TIFF, és az SVG. Tekintse meg a dokumentációt a teljes listáért.
Lehetséges a konverzió futtatása külső eszközök telepítése nélkül?
Igen. A konverzió teljes mértékben a felhőben történik, így nincs szükség helyi DICOM könyvtárakra vagy képfeldolgozó eszközökre.
Hogyan javítja a több szálas konverzió a teljesítményt?
Több konverziós kérést párhuzamosan indítva kihasználhatja az Aspose szerverek több CPU magját, ezáltal csökkentve a nagy mennyiségű DICOM fájlok feldolgozási idejét.
Használhatom az SDK-t parancssori szkriptben?
Teljesen. A megadott cURL példák parancssori munkafolyamatot mutatnak be, és a Python szkript közvetlenül egy terminálból vagy ütemezett feladatból futtatható.