HerbalThink-TCM Herbalists' Bootcamp
Subtopics on this page…
Tutorial #2: Setup and Documentation
============ HERBALTHINK-TCM BEGINNER TUTORIAL #2 QUESTIONNAIRE ========== (updated 2017-02-05) --------------- Installation and startup: A-0: Were you able to create Desktop shortcuts so that you can conveniently start HerbalThink-TCM and CaseQuery in the future? [ ] A-1: Did the startup sequence appear as described in the tutorial? [ ] --------------- Documentation: B-0: Did all the Chinese characters in the table appear correctly? [ ] B-1: -- PDF file displayed correctly? [ ] B-2: -- MP3-audio file displayed correctly? [ ] B-3: -- RMHI website appear in your default browser window? [ ] B-4: Were the explanations for the different types of navigation links clear? [ ] --------------- Magnifier/Zoom: C-0: Were you able to make your operating system's Magnifier/Zoom feature work? [ ] C-1: Were you able to set its options so that it can conveniently enlarge a specific content window to any desirable magnification? [ ] --------------- Verifying: D-0: Paste the results of your 'Copy All', from the 'About This Computer' tab here (this contains important information required to generate your activation codes): [ ] -------------------------------------------- Suggest some times that you would be able to call us for a phone tutorial, if and when you need additional help in completing the remaining tutorials. DAYS OF WEEK, TIMES OF DAY: [ ] YOUR WORLD TIME ZONE (or city/country, if not known): [ ] (See: http://www.worldtimezone.com ) Best times for us are typically M-F in very early morning, 7-10 am Mountain Time (western Montana). If those days/hours do not work for you, suggest some alternatives that would. We can arrange Saturday morning tutorials, if necessary. =============================== END ======================================
Installation and initial setup
To activate the Test option, which gives you trial access to approximately 15% of the course material, including all introductory information required for completing RMHI's admissions aptitude test, you will first need to complete this tutorial. If you intend to apply for admission or would like to become a member of the V123 brainstorming network, you must complete all the tutorials in this series.
It is important to follow the installation instructions exactly see the 'HowToInstall' document link on the page where you originally downloaded the software.
To run HerbalThink-TCM the first time, find the original folder that you installed, which will be named something like HerbalThinkTCM_4516 (220.127.116.11 is the version number). Open up this folder, and you should see a single folder: herbalthinktcm . Finally, open up this folder to see all the primary components of the HerbalThink-TCM system. The folder contents should be as follows (on Mac OS X for Windows and Linux, the ordering may be slightly different, but all of the same items should be included).
The files that are highlighted above in green are the application files that you will be running. To run HerbalThink-TCM, double-click on one of the following files, whichever is appropriate for your operating system:
The first time you run it, your system software validation feature may respond by saying the software is "untrusted" (which means it is not certified by either Apple or Microsoft). We thoroughly check our software for viruses, etc., before each release. To run, you must specify that you allow our software to run, and the procedure for this differs on the Mac and on Windows. It may be as simple as selecting some option like "Run anyway", or you may need to go into your System Preferences to specifically add HERBALTHINKTCM to your permitted list of allowed software. Refer to your operating system instructions for how to do this.
For convenience in future startups, it will be useful for you to do one of the following:
(Eventually, you will want to run the CaseQuery application, so you should also make a shortcut to the appropriate CASEQUERY-xxx file for your operating system.)
After starting HerbalThink-TCM, the following sequence will typically occur:
A Terminal/Console window may appear with a printout indicating "HerbalThinkTCM starting, please wait...". You can ignore this window, closing it at the end after you have finished your work with HerbalThink-TCM:
In quick sequence, the following splash panels will temporarily appear:
For new users, the previous splash panel will display the following text:
Finally, the green HerbalThinkTCM control panel will appear near the upper left corner of your monitor screen:
The preceding is how it will appear on Mac OS X. On Windows and Linux, the command menus will be attached to the control panel window itself.
If you need more help in running HerbalThink-TCM, double-click on the file Help.html inside the herbalthinktcm folder. The complete documentation/help will then open up in your default browser.
Questionnaire Installation and startup
Please answer the following questions in the questionnaire for this tutorial:
Verifying correct installation
Select the About HerbalThinkTCM command from the HerbalThinkTCM menu (or the File menu on Windows and Linux). In the window that appears, select the About This Computer tab:
If you have followed all the installation instructions correctly and no problems were detected during installation, the top of the window should state:
At the end of this tutorial, you will be selecting the Copy All button at the bottom of the preceding tab. This will copy all the window's contents to your System Clipboard, which you can then paste into your email questionnaire see the last question.
(If you are concerned about computer privacy and wonder what all this information is for, it helps us to diagnose what might have gone wrong if you did not follow installation instructions correctly. If you got the "Warnings: None" message, no major problems were detected, and you can just send us the first 20 lines up to and including the line "user.dir = ...".)
In the green HerbalThinkTCM control panel, click on the Documentation button, which will bring up a new window entitled Help (Documentation). You may also access the Documentation by two other methods:
For the purposes of this section, you must open the Help by clicking on the control panel button.
Your Help window should now appear as follows:
For beginners, you should click on the Go to the Getting Started page link in the left frame. This will present only those items of likely interest to new users. Now click the Documentation and Self-Study Reference link in the left frame, and your Help window should now appear as follows:
For users who are not especially computer-savvy, there are many important tips on this page that are standard to many computer programs, and you should become familiar with those features, like changing font size and resizing/enlarging windows.
Click on the Displaying/copying Chinese characters link in the Subtopics on this page... section to jump down to that subtopic. You should see a table with two sets of rows of Chinese characters. In each set, the bottom row should be identical to the upper row:
If the rows are identical, your system has a complete set of Chinese fonts installed. If some of the characters in the bottom rows appear empty or as an empty box, then your system may be missing all or some of the character set. See your system installation instructions for details. (Chinese fonts are usually pre-installed on most modern operating systems.)
Important note: the above table is an identical graphical-image copy of the table as it appears on the author's computer, so the complete set of Chinese characters will always appear correctly here. You need to examine your computer's capabilities by viewing the corresponding table as specified in these instructions.
Displaying PDF, MP3-audio, and web-links
Now scroll down to the next section, 3rd-party applications: PDF-document, MP3-audio, links to Internet pages. Click on each of the following links and note whether the corresponding file is displayed correctly:
Navigating multi-frame windows
Now scroll down to the next section, Navigating multiple frames and windows — types of hyperlinks. Practice clicking on the various links in the table to see examples of how many windows within the text modules of HerbalThink-TCM are organized using multiple frames within each window. Initially, this may be slightly confusing to new users. However, you will eventually appreciate how this allows you to quickly jump around in the texts and databases via cross-referencing links, without losing your place or sense of location in the overall hierarchy.
Changing font size
To permanently change the default font size, for example to display a bigger type for easier reading, choose the Preferences... command.
Using your operating system's 'Magnifier/Zoom' feature
Windows, Mac OS X, and most Linux desktop operating systems have a very handy feature that allows you to magnify small text. This is especially useful for older software that may not allow for text size enlargement within the application itself. The 'Magnifier/Zoom' feature will be useful if you plan to use the TCM Herbal Tutor interactive-game module extensively.
TCM Herbal Tutor has been in use since the year 2000. We freely admit that the interface is ugly, somewhat clunky, and could do with an update (we are working on it). However, this software has been a crucial component of our curriculum for over 15 years, and it still works quite well with the latest versions of Java (7, 8). Students who faithfully use it throughout the one-year Level-1 course consistently demonstrate clinical skills and analytic abilities that routinely exceed that of 4-year TCM college graduates. We have 15 years of statistics to prove this beyond any doubt. So we are reluctant to replace it until the new software has been thoroughly tested to verify its effectiveness as a learning tool.
There are a few simple tricks that will help you overcome the small text size in the game windows of TCM Herbal Tutor:
Following are screen shots of a TCM Herbal Tutor game window, first without magnification and then with optimal magnification. If you plan on using it a lot, the Magnifier option will come in handy. (To access TCM Herbal Tutor, you must first activate the Test option; see next section below.)
Verifying correct installation
Select the About HerbalThinkTCM command from the HerbalThinkTCM menu (or the File menu on Windows and Linux). In the window that appears, select the About This Computer tab. (See for screen shots: Verifying correct installation, above.)
Select the Copy All button at the bottom of the tab. This will copy all the window's contents to your System Clipboard, which you can then paste into your email questionnaire. (We will need this information to generate your Test activation codes.)
Activating the 'Test' option
To receive activation codes for the Test version-option, you must first:
The Test version-option includes access to all introductory material, which you will need to read/access in order to fulfill the RMHI admissions requirements, in the main reference and software modules of HerbalThink-TCM. The activation codes are contained in a text-file attachment. Open that attachment using any simple text editor like TextEdit, Notepad, or WordPad. Within this file, there are two fields of information that you will require:
Your window should now appear as in the following example:
Now click the Activate button at the bottom, and immediately the Test version-option should now be highlighted in bold-green:
You may now close the Activate license window.
Tutorials #3-7: Self-Study Reference, TCM Herbal Tutor, TCM Pulse Simulator, CaseQuery and AutoSage-TCM
Use of these modules within the HerbalThink-TCM system is covered in the remainder of this Beginner Tutorial series. Follow the instructions carefully, then answer the simple questions in the questionnaire for each tutorial. These questions are primarily designed to ensure that you understand how to access the different software modules and find relevant subsections in each that contains the required information. This is a very basic skill that you will be using frequently as a software user, as a member of the V123 brainstorming network, and/or as an enrolled RMHI student. These tutorials will explain everything you will need to know in order to qualify either for Active Member status in V123 or for admission to RMHI's certification program.
The reason that we request briefly knowing about your background, interests, and goals in using HerbalThink-TCM is to enable us to tailor the tutorial to your needs. That is the primary reason why we prefer supplementing these remaining online tutorials tutorial by phone, because it is difficult to create a one-size-fits-all introduction. The software is quite flexible and accommodates a wide range of users, from beginners with no prior experience of TCM to experts.
Regardless of whether you decide to join our V123 brainstorming network or apply for admission to an RMHI certification course, by completing this tutorial series, we hope to permanently transform your understanding of health and illness.