Category Archives: lesson

tinydicom + rawprocessor lesson #2

Now it’s time to next step for using my open sources,  And here I like to introduce how loads DCM and what it contains inside tags.

Just read my example code to read DICOM tags from DCM file, it should help what inside.

It may compiles with libtinydicom.a linkage as well, just compile your code with -ltinydicom -L{libtinydicom.a directory from your path}. Or, just follow my way – Make an empty directory in your working directory –  I like to recommend to make a directory as like ‘projects’. Then make a new again for unique name to check for next time, or continue to more works : recommend ‘dcmtest1’ or ‘dcmtest2’. So you may now placed to {Your home directory}/projects/dcmtest1 when you had followed my recommendation. Now make a empty cpp file with any editor like vim, then copy & paste my example, then save it up and quit editor. Then copy prebuilt “libtinydicom.a” and “libdcm.h” into your current directory – if you didn’t prebuilt? just build it first. and type like this.

g++ main.cpp -ltinydicom -o test1

You may check test1 or test1.exe (on Windows).
Now you need download sample DCM file from here:


If you have wget, you can do :


Now you have SIMFIT.dcm and compiled binary with same directory. Just type your binary name. And check result. 87 items may displayed with sizes.


Then, try to next step, save raw pixel image to a new file. See my example source.

Now you need prebuilt librawprocessor.a and rawprocessor.h file in your directory with example source code. It proceeds read SIMFIT.DCM and export pixel image information, then writes to a file.

Important points is ‘Checking Window center and width’ from DICOM tag ID 0028:1050 and 0028:1051. These tags contains information of window center and width, and it must applied to exported image. So I used Get16bitThresholdedImage() method to make windowed image.

If you need more detailed? just let left a guestbook here.

Next lesson may using libPNG, and make raw image to 8bit grey scaled image to see in common image viewing programs.

tinydicom + rawprocessor lesson #1

Here I planned to write some lessons to understand what is libtinydicom (Tiny DICOM library) and librawprocessor (RAW Processing library) for most of modern compilers except M$VC – unfortunately I am sorry about supporting M$VC, but I don’t like care about distinct, banishing standard compiler.

Ok, let understand what is each library doing what it does and what it existed for.


This library was born to read and write DICOM tags in a file by myself. At a time I made this, there’s some commercial libraries and open source too – A.K.A DCMTK. I was just wanted to write simply some DICOM tags and also reads Pixel datas from any DCM files – so I have started to read NEMA’s DICOM standards. And it was about 2011.

It passed years and continuously made it works well with many different DCM files, and now it availed to as an open source on

Anyone can clone or download source code and use it for freely with small license MIT. Just Ok for announcing what you used it your project or product.

Supported compilers are most of modern C++ compiler supporting Makefile. It made with MinGW-W64 and Code::Blocks IDE, but now supporting Mac OS-X and Linux too because it made only with C++ STL.

How to use it ?

Simply you can download source code as ZIP compression from here. And you may need already know how I can extract ZIP file to somewhere, and plus more you must know what I have to use compiler with this library – If don’t know? Just, please, don’t try to use it, It may difficult to understand next jobs.

Now choose one of Makefiles that have extensions – gcc and llvm.  Just copy one Makefile.{your compiler to use} to Makefile as like cp Makefile.gcc Makefile and then, just type to make.   If it succeed to build all sources, you can see a lib directroy, and there’s two files : libtinydicom.a and libdcm.h

And now you may understand how it be used, and this lesson may continued to next.



librawprocessor born to doing something for most of medical RAW images. It supports read and write, rotating, flip, convert to 8 bit image and more features.

You can download or clone source codes here.

“librawprocessor” supports OpenMP for processing image quickly if your compiler supports this feature. Most of processing features are optized for OpenMP and AVX instruction.


  • Load from File, Memory.
  • Save as a new RAW image.
  • Flip vertical, horizontal
  • Fast Rotate 90, 180, 270 degrees
  • Free Rotate in 0 to 359.99 degrees
  • Change width and height in size of height, to recognize what resolution is right.
    ( Most medical RAW images has no information about sizes )
  • Invert
  • Rescale with many filters : Bilinear, Bicubic, B-Spline, Lanzcos
  • Kernel matrix filtering : sharpen, blur or customized
  • Brightness, Contrast, Gamma adjustment
  • Tone mapping with Drago and Reinhard
  • Generate low frequency image and anisotropic filtered image from source
  • Advanced edge enhace
  • Automatic weight calculation ( window width )
  • Get down scaled pixel ranged data from source ( thresholding to any bits, 8 or 16bits )

How to use it ?

Simply you can download or clone from here. You may need prepared to understand what is your compiler and how to build with Makefile. ( M$VC not an option, sorry about this but no plan to future, too ) Tested almost of GCC environments : Windows, Mac OS-X, Linux.

After you got source code on your system, copy your right Makefile.{compiler type you have} to Makefile as like this : cp Makefile.gcc Makefile , then proceed simply make. And you can decide to use OpenMP option with appends a word openmp to make.

Required OpenMP is at least 3.0 or above. lower version may reason of compile failure.

And now you may understand how it be used, and this lesson may continued to next, too.