mmColorTarget v3.1

This location is for Registered Users Only.
Perhaps you need to login or register.

Contributor: Marco Meyer

Matches colors of two input images or neutralizes to a reference colorspace target using one of the common color charts (eg. MacBeth ColorChecker)

Requirements:
13.1, 12.2, 12.1, 12.0, 11.3, 11.2, 11.1, 11.0, 10 or later
Linux, Mac, Windows

06 Jun 2021

6717

Description
Older Versions

Useful Nukepedia Tool #8. Explore this video:

Usage:

- Make sure you have Numpy installed, compatible and accessible with your Nuke version. (see Blogpost with additional Information )

- Plug two images showing a MacBeth Colorchecker into the source and target inputs.

- Corner Pin the source and target sampler to its corresponding ColorChecker and adjust the sampler Size

- (Switch inputs using the 'currentView' dropdown)

- Hit the 'Calculate Matrix' Button to get the output ColorMatrix.

Demo Video

Change Log:

v3.1
- FIX: Chromatic adaptation was not performed. This caused the reference values to be slightly off for colorspaces with non-D65 whitepoints. An updated JSON file with additional data is provided that is required for this fix.

v3.0
- BREAKING: Using colorspace transforms to retrieve the reference values instead of the hardcoded patch values. This allows easier addition of future colorcharts by only adding their sRGB reference values. This change will deprecate the use of the mmColorTarget_colorspaces.json file and will start using mmColorTarget_colorspace_transforms.json instead.

- Support for colorcharts:
- ColorChecker24 - Before November 2014 (ColorChecker2005)
- ColorChecker24 - After November 2014
- SpyderCHECKR 24
- ColorChecker Passport Video
- Python 3 support
- Added normalization option

v2.0:
- More intutive UI with callbacks
- Fixed a problem introduced in Nuke 9.0v8 that broke the entire functionality
- The reference target now comes with a dynamic colorspace selection instead of fixed sRGB Values. (generously provided by Thomas Mansencal at colour-science.org)
- Additional sampling method 'no clip' (EXPERIMENTAL!)
- More stability due to no more expression-based-sampling in the background

Tested successfully on Windows 7/10 (Nuke 7-9) and CentOS 6/7/8 (Nuke 7-13)

Mac Users: The Gizmo should also work on Mac, but you need to find/compile a compatible version of numpy yourself, since i don't have a Mac. Check the UNT Video for an example installation.

screenshot

Please login in order to download these files.

Comments

# Jason Huang 2014-05-06 10:11

Thanks so much!!! I am screaming if it is what I think it is that can save me from buying HDR Shop 3.0 for $200 and just for this particular feature....

# Manuel Flemming 2014-05-06 17:29

Thanks a lot! That's very useful!!

# Daniel Brylka 2014-06-21 10:42

Failed to try this on Nuke8 OSX, I found NumPy (not the latest version as a .DMG), installed it, Python 2.77 itself on the system can import "NumPy", but inside of Nuke I get just an error that it is not finding it. Can someone tell me what else I need to do?
Thanks

Daniel

# Marco Meyer 2014-07-01 10:03

the easiest way to test would be to copy the numpy folder that's located in your python site-packages (on OSX it should be something like "/Library/Pytho n/2.7/site-pack ages") to your "/Users/YOURNAM E/.nuke" folder and try "import numpy" again.

the other way would be to add the following to your init.py file:
import sys
sys.path.append("/Library/Pytho n/2.7/site-pack ages")

It's still possible that you'll get an error if the compiler version doesn't match, which is the point where i can't help any further, since I didn't get enough feedback from Mac users yet. But it should at least find the module now and tell you what's going on.

I hope it helps, and please share your information if you suceeed.
Marco

# guillem ramisa 2014-09-20 16:31

Hi Marco,

I've found the NumPy installer (1.6.1) for Python 2.7 for Mac. I'm running a mac osx 10.6.3 with NukeX 8.0.3.

http://stackoverflow.com/questions/7338051/install-numpy-on-mac-os-x-lion-10-7

It works fine with osx 10.6

I've checked in the OSx command line if the package got installed and yes, it worked and found all the files

I found the folders inside "/Library/Pytho n/2.7/site-pack ages" and copied to: .nuke/Framework s/Python.framew ork/Versions/2, 7/lib/python2.7 /site-packages" I'v copied there the numpy folder.

When I load the gizmo, it works well but when I try to calculate the matrix there it appears an error: " .../site-packag es/numpy/core/m ultiarray.so: no matching architecture in universal wrapper "

I've tried importing with the init.py command but it does not work.
import sys
sys.path.append("/Library/Pytho n/2.7/site-pack ages")

Is there any way I can fix it??or I'm doing something wrong..?
I would appreciate any help.

Thanks Marco and amazing gizmo!

- Guillem R.

# Marco Meyer 2014-09-23 20:27

Looks like there's a 32bit/64bit-pro blem. Your numpy has to be 64bit to run with nuke, i guess.
You might wanna check any of those solutions:
http://stackoverflow.com/questions/4527338/how-to-install-numpy-and-scipy-on-os-x

Have you already tried any of the official installers for osx10.6? For example:
http://sourceforge.net/projects/numpy/files/NumPy/1.7.2/numpy-1.7.2-py2.7-python.org-macosx10.6.dmg/download

Providing google help is really the best i can do right now :(

# guillem ramisa 2014-09-25 16:27

Yeah! It worked perfectly!

Very thanks Marco! I've been searching for this for a long time!
I'm the first Mac user to get this working??

I've just added the new site-packages created on the /Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages

Never underestimate google help :-)

Thanks again!!

# Marco Meyer 2014-09-26 16:55

Awesome, glad to hear that :)
Well you're not necessarily the first Mac user ever to get it working, but you sure are the first to give me some positive feedback.
So thanks a lot for sharing!

# Dani Kei 2014-10-08 12:07

Hey, would you mind uploading the "site packages" that works on mac? I'd love to get numpy working and mmcolortarget !!! Or writing a small explanation on how you got it to work!

# Iván Martínez 2015-05-18 17:03

Awesome Marco Meyer.
Could you give us a tip for work with spydercheckr 24 without hide 2 rows ( it are inverted in this color card) :sad:

(second color and grey)
Thank you!!

# Thomas Mansencal 2016-01-14 04:31

Well, you could still manually crop and flip the offending rows to match XRite / GretagMacbeth colour rendition charts, however I would not do that because there is no guarantee that the samples between the two brands have the same colours. This need to be checked before doing any colour fitting.

# Dennis Serras 2015-07-10 23:24

Thanks for the tool, it is a good design and well made. I tested it by taking a color chart, messing up the colors, then bringing it back into Nuke. I found two issues worth addressing:

1. It does not manage levels well - I would look at adding an exposure, levels, or some other way of balancing brightness before applying the chart. I fixed that by manually adjusting levels first.

2. It crashes in Nuke 9.0.3. Numpy works in 9 OK - I was able to test it - so something else isn't working.

Thanks again!

# Jed Smith 2020-01-25 18:03

Quoting Dennis Serras:

1. It does not manage levels well - I would look at adding an exposure, levels, or some other way of balancing brightness before applying the chart. I fixed that by manually adjusting levels first.

I was running into the same need - I created a new version of the tool that allows chrominance calibration without affecting luminance if you're curious to try it out:
https://gist.github.com/jedypod/798b365ea64e8121999e7036ae7e0217

# Tigran Stepanyan 2016-04-19 16:48

How can i fix this problem?
Quote:

/usr/local/Nuke9.0v8/libgcc_s.so.1: version `GCC_4.2.0' not found (required by /lib64/libgfortran.so.3)

# Daniel Brylka 2016-05-22 10:11

Hi,

I found this morning the new video. Thanks for making it. I followed along on OS X 10.11.5 with Nuke 10.0v1 Non-Commercial.
I still can't make it work.

The gizmo is coming with a .json file, is that also belonging in the gizmos folder?

When I hit "calculate" I get the following error:
'NoneType' object has no attribute 'knob'

Did I install it okay? Is there a way to check inside of Nuke?
And what does this error message means?

Thanks in advance,

Best regards

Daniel (toodee)

# Frank Rueter 2016-05-22 23:01

Sounds to me like the Non-Commercial restrictions in the python interpreter are causing this.

# Daniel Brylka 2016-05-23 08:48

Thanks Frank,

you are right, in the normal licensed version it works fine.
Thanks.
It would be nice that the Foundry would actually give the user some hints, that a restriction causing an error in the NON-COM. version.

# Jason Freets 2016-09-03 07:56

I'm using Nuke10 Non-Commercial and can't get this to work in either Linux or Windows:

Current problem is:

'NoneType' object has no attribute 'knob'.

# Brendan Coyle 2016-12-18 05:03

awesome gizmo! only wish was that it would work when matching an upside down chart. seems to get funky. otherwise i just flip the image and match the chart and it works! thanks

# kasiflaco guyi 2017-03-14 16:45

Thanks so much from Venezuela

# Pedro Andrade 2017-06-06 13:01

Hey Marco! This seems pretty nice. Can you please share the documentation for the math behind the transform matrix? Thanks

# Thomas Mansencal 2017-06-06 19:52

Quoting Pedro Andrade:

Can you please share the documentation for the math behind the transform matrix? Thanks

It is a Multivariate Linear Regression: https://en.wikipedia.org/wiki/General_linear_model and uses numpy.linalg.ls tsq: https://docs.scipy.org/doc/numpy/reference/generated/numpy.linalg.lstsq.html

# Pedro Andrade 2017-06-07 10:03

Thanks a lot Thomas.

One thing that seems to have always some discrepancy when comparing different documentations are the RGB values on the Macbeth chart. For example, here on Nukepdia the values used on mmColorTarget tool are different to the ones of V_ColorRenditio nChart... Also different documents seems to have different information on the normalized values of RGB for the same illuminant:

http://www.babelcolor.com/index_htm_files/RGB%20Coordinates%20of%20the%20Macbeth%20ColorChecker.pdf

https://www.cs.utah.edu/~aek/classes/cs7650/part03.html

http://xritephoto.com/ph_product_overview.aspx?ID=824&Action=Support&SupportID=5159

Can anyone expand on this differences and how / where these values of this tool were obtained?

# Thomas Mansencal 2017-06-07 10:13

Quoting Pedro Andrade:

Thanks a lot Thomas.
Can anyone expand on this differences and how / where this values of this tool were obtained?

Absolutely :) As explained in the description they were generated by myself, the file that yielded the value is there: https://github.com/colour-science/colour-nuke/blob/master/colour_nuke/notebooks/mmColorTarget_dependencies.ipynb

They are based on XRite ColorChecker 2005 values as described here: https://github.com/colour-science/colour/blob/cdbffd063b0c44bb32d752b01647137871434851/colour/characterisation/dataset/colour_checkers/chromaticity_coordinates.py#L114-L114

Now colour rendition charts are never produced equal, so it is normal to find discrepancies between them, not only that but there are also differences in the various RGB colourspaces / whitepoints values depending where you source your data.

This reminds me that I should regenerate the Notebook/JSON file with the latest values content from Colour.

# Alex Grau 2017-12-19 15:27

Hi guys, anybody tried with Nuke 10 on win7 ? Thanks

# Andrew Rea 2018-01-08 18:25

Quoting Alex Grau:

Hi guys, anybody tried with Nuke 10 on win7 ? Thanks

Have it working in Nuke 10.5 in Windows 7 at work, I got the numpy build from the link in Marco's blog above

# APURVA KISHORE 2017-12-30 07:10

Thanks so much

# Michael Kennedy 2018-03-21 23:40

Anyone had any luck with this on 11.1v2? Running on win7, i know, i know...

It drops in just fine and functions well. When I save and open the script again i get a slew of "no such knob" errors and the property window looks like an empty node. Any ideas?

Thanks,
Michael

# IDontWant ToRegister 2018-06-08 13:08

Hello, in Nuke 11.1v3 when clicking on button "Calculate Matrix" I get this error: 'NoneType' object has no attribute 'knob'

Please do you know what could be the problem?

# Tobias Pfeiffer 2019-01-15 07:24

Hi,
thank you for this very useful tool.
Is there any way to keep the lumincance untouched? Often I would like to just get it neutrlized without the patches hitting absoloute value (like .18 for middle grey).

Usualy I am going with the "no clip" choice instead of direct, because the direct mode tend to do funky stuff to overbrights. Is this recommended?
Thanks,
Tobi

# Tobias Pfeiffer 2019-01-15 07:24

# Jorge Garcia 2019-06-23 04:47

Hi! this is a really wonderful tool!
I've been struggle trying to make it work on windows.
Theres is a step by step installation for this OS?
I just installed gizmo, phyton, numpy; modify init.py
I can bring the node but can't calculate matrix because it says: This gizmo requires the Python module 'NumPy'.Please install it first and make sure Nuke can import it.
But it is installed.

Any help please?

Thanks before hand.

+1 # Marco Meyer 2019-07-04 13:54

Instead of installing python and numpy, have you tried just unzipping this https://www.marcomeyer-vfx.de/wp-content/uploads/numpy_py27_win64_vs2010.zip
into your ".nuke" directory?

+1 # Jorge Garcia 2019-09-27 00:20

Quoting Marco Meyer:

Instead of installing python and numpy, have you tried just unzipping this https://www.marcomeyer-vfx.de/wp-content/uploads/numpy_py27_win64_vs2010.zip
into your ".nuke" directory?

Thanks sir!!!

Finally I stumbled with a very useful post that helped me to make it work in a easy way

Quoting dapoer vfx:

Quoting Jorge Garcia:
Hi! this is a really wonderful tool!
I've been struggle trying to make it work on windows.
Theres is a step by step installation for this OS?
I just installed gizmo, phyton, numpy; modify init.py
I can bring the node but can't calculate matrix because it says: This gizmo requires the Python module 'NumPy'.Please install it first and make sure Nuke can import it.
But it is installed.

Any help please?

Thanks before hand.

Same situation here..! Tried on Win 10. I hope someone else here can give solution. Thanks

This is a trick:
1.Install las Houdini Version
2. Go to: C:\Program Files\Side Effects Software\Houdin i 17.5.293\python27\lib\site-packages
3.Copy all content to: C:\Program Files\Nuke10.0v3\pythonextensions\site-packages
4. WhOA LA!!

Thanks to:
https://jurajtomori.wordpress.com/2018/11/28/nuke-tip-installing-numpy-for-nuke-python-on-windows/

Hope it helps!

# dapoer vfx 2019-09-25 15:18

Quoting Jorge Garcia:

Hi! this is a really wonderful tool!
I've been struggle trying to make it work on windows.
Theres is a step by step installation for this OS?
I just installed gizmo, phyton, numpy; modify init.py
I can bring the node but can't calculate matrix because it says: This gizmo requires the Python module 'NumPy'.Please install it first and make sure Nuke can import it.
But it is installed.

Any help please?

Thanks before hand.

Same situation here..! Tried on Win 10. I hope someone else here can give solution. Thanks

# rodrigo guerechit 2019-06-25 06:24

Thanks Jason for sharing this amazing tool!!!!! Works perfect.

# dapoer vfx 2019-09-27 10:40

Quoting Jorge Garcia:

Quoting Marco Meyer:
Instead of installing python and numpy, have you tried just unzipping this https://www.marcomeyer-vfx.de/wp-content/uploads/numpy_py27_win64_vs2010.zip
into your ".nuke" directory?

Thanks sir!!!

Finally I stumbled with a very useful post that helped me to make it work in a easy way

Quoting dapoer vfx:
Quoting Jorge Garcia:
Hi! this is a really wonderful tool!
I've been struggle trying to make it work on windows.
Theres is a step by step installation for this OS?
I just installed gizmo, phyton, numpy; modify init.py
I can bring the node but can't calculate matrix because it says: This gizmo requires the Python module 'NumPy'.Please install it first and make sure Nuke can import it.
But it is installed.

Any help please?

Thanks before hand.

Same situation here..! Tried on Win 10. I hope someone else here can give solution. Thanks

This is a trick:
1.Install las Houdini Version
2. Go to: C:\Program Files\Side Effects Software\Houdini 17.5.293\python27\lib\site-packages
3.Copy all content to: C:\Program Files\Nuke10.0v3\pythonextensions\site-packages
4. WhOA LA!!

Thanks to:
https://jurajtomori.wordpress.com/2018/11/28/nuke-tip-installing-numpy-for-nuke-python-on-windows/

Hope it helps!

WHOOO...HOOOOOO ..Thank a tons ..Obrigadooo... Rodrigo !! ...Works like a champ !!

# Thomas Mansencal 2020-02-04 09:30

Hi,

It was long overdue but I have updated the JSON file to use the "ColorChecker24 - After November 2014" formulation: https://github.com/colour-science/colour-nuke/blob/master/colour_nuke/resources/mmColorTarget_colorspaces.json and the notebook to generate those is here: https://github.com/colour-science/colour-nuke/blob/master/colour_nuke/notebooks/mmColorTarget_dependencies.ipynb

Cheers,

Thomas

# David Wahlberg 2020-03-03 15:44

Hi Thomas,
It's great to see that you are keeping this project alive! It's great, thanks again! :)

Now to a question. We've run into plates shot with the "new" ColorChecker Passport Video edition, that obviously doesn't work with the current version. Any plans on making it compatible with this color checker version as well since it seems to be used more and more?

Cheers,
David

# Thomas Mansencal 2020-03-04 08:09

Hi David,

You are the second person this week to ask me about the ColorChecker Passport Video! So I haven't spent too long looking for them, but I could not find the colour specification for the samples.

That being said, one issue I see with that particular model is that it is extremely biased toward grays and skin tones which will be detrimental to all other colours if you were to do a 3x3 matrix-based colour correction.

Technically, when captured under uncontrolled lighting conditions, colour checkers should only be used to perform white balance, the reference colours are assuming a particular illuminant, e.g. D65 and if you were correcting a shot lit with tungsten, you would most likely do worse than good.

Cheers,

Thomas

# David Wahlberg 2020-03-09 13:35

Hi again Thomas,
We have received the full colour specifications for the ColorChecker Passport Video directly from X-Rite. Would you be interested in having a look at them, and see what you could do with them at all? Or is that not interesting to you because of what you stated above?
Cheers, David

# Thomas Mansencal 2020-03-12 05:54

Hi David,

I don't have any objections to generate the data however what are the usage conditions for that X-Rite data?

We should probably continue that convo via Email anyway :)

[email protected]

Cheers,

Thomas

+1 # pancho lopez 2020-03-04 00:14

Help

Hi, I've done everything to make the gizmo work with nuke 12.0 v4

I have downloaded numpy from this link
https://www.marcomeyer-vfx.de/posts/2014-04-11-mmcolortarget-nuke-gizmo/
and I copied it C: \ Program Files \ Nuke12.0v4 \ pythonextension s \ site-packages

but at the time of calculating matrix

I get a message that says
'NoneType' object has no attribute 'knob'

+2 # pancho lopez 2020-03-04 00:14

# jamal amh 2020-11-05 11:53

me like you the same problem i stopped trying :sad:

# Thomas Mansencal 2020-11-14 20:26

To anyone trying to install Numpy with Nuke, you need to make sure that the Numpy version you are pulling is compatible with the shipped Nuke interpreter, e.g. compiled with the same toolchain.

# Nick Shaw 2021-02-02 10:25

Quoting Thomas Mansencal:

To anyone trying to install Numpy with Nuke, you need to make sure that the Numpy version you are pulling is compatible with the shipped Nuke interpreter, e.g. compiled with the same toolchain.

Thanks to some help from @Thomas, I have found that the version of Numpy that ships with Houdini is compatible with Nuke 12.2v4 (macOS). Previously the Apple shipped Numpy worked fine with Nuke 11.

# Thomas Mansencal 2021-02-03 01:32

Numpy-macOS-Hou dini-18.5-GCC4. 2.1-LLVM10.0.1- Clang-1001.0.46 .4.zip: https://drive.google.com/open?id=1rvfoVT-n5ZAD21kzenmUz19qZfpvGEr8

# Adrien Delecroix 2020-11-03 14:36

Hey,

If anyone could just say the complete workflow to install this good script correctly, it would be awesome!
Thanks a lot.

# H Hakim 2020-11-14 20:21

Quoting Adrien Delecroix:

Hey,

If anyone could just say the complete workflow to install this good script correctly, it would be awesome!
Thanks a lot.

I think you need to have "numpy" library in your .nuke folder.

# H Hakim 2020-11-14 20:23

I think this gizmo is not compatible with ACES colorspace...No?
I can't have correct values in ACES workflow.

# Thomas Mansencal 2020-11-14 20:27

It should work without any problems with ACES.

# Nico Wieseneder 2021-01-16 18:21

Does anyone know if this gizmo works with NukeIndie too? Or is there too much Python code as NukeIndie is limited to 10 command lines only? Thanks!

# Marco Meyer 2021-01-18 20:35

nope, sorry... this has way more than 10 lines of code :-)

# Marco Meyer 2021-03-17 17:48

Before anyone starts asking: I'm just finishing up a Python 3 compatible version that will also run on Nuke 13.
It contains some additional features so it requires some more testing, so please bear with me ;)

# Charlie Armstrong 2021-03-19 04:57

all good

# Jens Lindgren 2021-06-03 12:45

I'm trying out the new v3 but I can't see that you're doing any chromatic adaptation when you're converting between color spaces, so the white point is shifting quite a lot. Is this by design or simply overlooked?

# Marco Meyer 2021-06-04 12:53

Thanks for pointing that out, I must have neglected that. I will look into it for the next release.

# Marco Meyer 2021-06-06 13:38

This is fixed in v3.1

# Jens Lindgren 2021-06-09 08:39

Yeah seems to be working as expected now. Thanks :)

# David Sanchez 2021-08-13 20:57

Could someone help me with getting this to work on windows 10 with nuke 13.v3?

I'm getting a numpy error.

Thanks

# Marco Meyer 2021-08-14 09:09

I'm assuming your numpy might be a python 2.7 version, while nuke 13 requires 3.7. Otherwise please post the full error traceback, because "a numpy error" can be many things.
I have recently updated the installation instructions on my website. Make sure you try using the python3 numpy that comes with one of the houdini-py3 installers.
https://www.marcomeyer-vfx.de/posts/mmcolortarget-nuke-gizmo/

# David Sanchez 2021-08-14 17:01

Hi Marco,

here is the error I get. I install the latest houdini and copied the numpy and then added to nuke.

I will have to check to see if the Houdini version I have has python 3. Do you know a Houdini version that has that?

ImportError:
Importing the multiarray numpy extension module failed. Most
likely you are trying to import a failed build of numpy.
If you're working with a numpy git repo, try `git clean -xdf` (removes all
files not under version control). Otherwise reinstall numpy.

Original error was: DLL load failed: The specified module could not be found.

Thanks,
David

# Marco Meyer 2021-08-15 09:39

All of the latest versions have python3. You have to check on the houdini downloads site, they offer both python2 and python3 versions to download. Just pick the any of them that have houdini-py3 in their name.

# David Sanchez 2021-08-20 15:33

thanks that worked

# Atalow Tronatic 2021-11-08 15:14

Hi Marco,

I tried to install numpy on nuke... but in each time i have a new error.
My protocol :
- I installed anaconda to install numpy with the good version of python (3.7.11 MSC v1916) My nuke is v13 (Py v 3.7.7 MSC v1916)
- Next, i've copy the "numpy" folder in anacaonda environnement to nuke in pythonextension s/packages
- When i try in nuke "import numpy" i've this error : DLL Load failed...

Can you help me ?
Thanks

Refresh comments list
RSS feed for comments to this post

You have no rights to post comments

JComments

- over 1,000 free tools for The Foundry's Nuke

Login to your account

mmColorTarget v3.1

Comments