Artisan Documentation

Visual scope for coffee roasters

Your First Roast

Install artisan and configure as described in “Installation.” This chapter will introduce the basic functions of artisan and the how to use with your roaster and data logging device.

This example is built on an Omega HH506RA datalogger connected to a HotTop KN-8828B roaster with artisan running on a PC with Windows 7 (64 bit).

Roasting with HotTop, Omega HH506RA and Artisan

Artisan Screen

This is the screen when artisan is started.

Artican Starting Screen - click for details

The two areas of interest for the first roast are the events buttons (green, orange, red and yellow at the bottom) and the File, Roast, Conf and Help menu at the top.

1. Entering the Roast Properties

Click on Roast / Roast Properties…

In the General tab enter the details of the beans to be roasted.

The Notes tab can be used for roasting and cupping notes.

The Events tab is used to viewing non-standard events such as power or fan settings.

Click OK to close.

All information about the roast is stored in a text (.txt) file referred to in artisan as the “Profile.” Click on File / Save As… and save the file. Now that the Profile is saved to a file, it can be updated by clicking Ctrl+S at any time.

2. Start Recording

Start the roaster and digital interface.

Event Buttons - click for details

Click on green ON button in the events area to start recording temperatures from the roaster. Click on the appropriate event buttons as they happen. At a minimum you need ON, CHARGE, DROP and OFF.

Standard events include:

  • ON – Start recording temperatures
  • CHARGE – Charging (loading) the roaster with green beans
  • DRY END – Beans are dry
  • FC START – First Crack Start
  • FC END – First Crack End
  • SC START – Second Crack Start
  • SC END – Second Crack End
  • DROP – Drop roasted beans into cooling tray
  • OFF – Stop recording temperatures
  • EVENT – Add a non-standard event

EVENT is used to add other events such as power (heat) changes and fan setting changes.

On the graph the Y-axis on the left is the temperature, the X-axis on the bottom the time and the two lines in the graph the Environment Temperature (ET – RED) and Bean Temperature (BT – Blue). As the bean temperature is almost always cooler than the environment temperature, the hotter temp (ET) is red and the cooler (BT) blue.

Down to Earth Select 1 Final Screen

Once you click OFF to stop recording, either click on FILE / SAVE or Ctrl+S to save the results.

If you want to have an image of the final result click on the diskette (Save Figure) icon. You will be prompted for a file name and location. The image is saved in PNG format.

Save Figure (Diskette) Icon

Congratulations. You have recorded your first roast and saved the results in an artisan profile.

Adding Cupping Profile

Usually the cupping profile is added later. Start artisan and with File / Open… or File / Open Recent load the profile again.

Click on Roast / Cupping Profile…

Cup Profile V0.5.0

The Axis value can be changed and the sliders set to match your cupping results. The results will appear.

Cup Profile V 0.5.0

As of version 0.5.0 a selection of profiles are offered including: Artisan, SCCA, CQI, Sweet Marias, C, D.

When the Cup Profile window is closed the screen will revert to the temperature graph. To view the graph as well as the cupping profile select File / Create HTML Report. The files:

  • artisan-flavor.png
  • artisan-graph.png
  • Artisanreport.html

are created in the program folder.

Click to see the HTML Report

[Note: Random values were used for cupping profile example.]

Click on FILE / SAVE or Ctrl+S to save the final results.

Tip: Click the event button in artisan then do the actual event. If you click in the program first the delay time will be consistent.

Tags: , , , , , , , , , , , ,

14 Responses to “Your First Roast”

  • sdelgran says:

    >>The Events tab is used to adding non-standard events such as power or fan settings.

    I think you can’t add events in that tab. You add them as you describe later on. Maybe “view” is more correct.

    • RichHelms says:

      Changed adding to viewing. I will do a roast and add other events then try it later this week.

  • sdelgran says:

    One way I test the program features without having to actually roast or even connect to the temperature probe is by using the NONE device (new option in the list). This way you can run the executable on any machine and simulate a roasting session (temperature are entered manually as you signal an event).

    Actually it would probably be a good idea to have a section on roasting without any temperature device as many users out there would probably love starting to use the software without having to buy extra hardware. Does that make sense?

  • SimonCHAN says:

    The cup profile adopted is neither SCAA, CQI nor C of E style.
    It would be more user friendly if different cup profile systems could be adopted.

  • RichHelms says:


    In the cup profile dialog you can change the Axis to match any system. Just click on a axis title such as Acidity and type in a new word.

  • […] Profile V0.5.0 See examples in Your First Roast Flavor is a psychological inner experience. In order to be represented or communicated, we must […]

  • Ray says:

    Hi – will there be support in the future for a Victor dmm? The VC86B with USB output seems to be quite popular among roasters!

  • Arpi says:

    Sorry. The Victor dmm is not supported. Only meters that use RS232 or USB-RS232 chip are hardware compatible with artisan. The Victor 86 uses an HID interface as opposed to RS232. But if you could make a program that reads the temperature of your meter, you could use the ‘program’ option in the device configuration menu.

    • Dion says:

      Hi Arpi,

      I too have a Victor 86B, I would love to use it with Artisan. I am running OSX 10.5.8 on my laptop.

      I apologise I know nothing of these specs, but I notice my Victor device has a RS232 button. Any chance that this makes it potentially usable?

      Many thanks!

  • Bijou says:

    HI using a us roaster corp sample roaster with a fuji pxr 4 pid and windows 7 to use this program. the problem i am having is Artisan is registering the pid temperature a decimal off. What I mean is instead of reading the Pid which will say 312 degrees F, Artisan will register it as 31.2 degrees F. My roasting curve therefore looks like a flat line. If i posted in the wrong section let me know thanks.

  • I would love to have the cooling process as part of the roast. I’m planning to build a probe into the cooling tray as the roasting process has not ended before the coffee is cold. I know that I could just measure the cool down temp once and make sure it is short enough but for quality control reasons I would like to just measure this cooling time mutinously to be able to track seasonal changes, track changes in relationship to cleaning and maintenance procedures and track ‘random errors’ that would lead to occasional problems with the cooling time which would be all post hoc ‘visible’ if the cooling time was measured by routine by Artisan. What do you think?

  • nathan says:

    Victor DMM is RS232 as far as I know, so maybe it might?

  • Jamie says:

    Hi, does anyone know how to change the temperature from fahrenheit to celsius?

    Many thanks.