JMAG Version 22.

2
User's Manual
Screen Configuration

JSOL Corporation
Issue date of 1st Edition: August 2023

 COPYRIGHTS
Copyright © 2023 JSOL Corporation All Rights Reserved.
• Information in this document is subject to change without notice.
• No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or
mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written per-
mission of JSOL Corporation.
JMAG Division
JSOL Corporation
Tokyo/ KUDAN-KAIKAN TERRACE 11th Floor, 1-6-5 Kudanminami, Chiyoda-ku, Tokyo 102-0074, Japan
Phone: +81(03)6261-7361 Phone (Support): +81(03)6261-7362 FAX: +81(03)5210-1142
Osaka/ Tosabori Daibiru Bldg. 2-2-4 Tosabori, Nishi-ku, Osaka 550-0001, Japan
Phone: +81(06)4803-5820 FAX: +81(06)6225-3517
Email: [email protected] URL: https://www.jmag-international.com/

 Trademarks
• JMAG and JMAG-RT are registered trademarks of JSOL Corporation.
• Abaqus, CATIA, SIMULIA and SOLIDWORKS are trademarks or registered trademarks of Dassault Systemes or its subsidiaries in
the United States and/or other countries.
• AMD and AMD Opteron is a trademark of Advanced Micro Devices, Inc.
• Amesim, LMS Virtual.Lab, NX, Parasolid, Siemens, Simcenter, Simcenter 3D, Solid Edge, and STAR-CCM+ are trademarks or reg-
istered trademarks of Siemens Industry Software Inc., or its subsidiaries or affiliates, in the United States and in other countries.
• CAPRI CAE Gateway is a registered trademark of CADNexus Inc. in the United States and other countries.
• Creo and Pro/ENGINEER are registered trademarks of PTC, inc.
• DXF and Inventor are trademark or registered trademark of Autodesk, Inc. in the United States and/or other countries.
• Excel, Microsoft, Visual C++, Windows, and Windows 10 are either registered trademarks of Microsoft Corporation in the United
States and/or other countries.
• Flexera Software and FLEXlm are registered trademarks of Flexera Software LLC in the United States and other countries.
• Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other
countries.
• LabVIEW is a registered trademark of National Instruments Corporation.
• Linux is a registered trademark of Linus Torvalds in the United States and other countries.
• LSF is a registered trademark of IBM Corporation in the United States, other countries, or both.
• MATLAB and Simulink are registered trademarks of The MathWorks, Inc.
• MSC NASTRAN is a trademark of MSC Software Corporation.
• NASTRAN is a registered trademark of the National Aeronautics and Space Administration.
• NX Nastran is an enhanced proprietary version developed and maintained by Siemens Product Lifecycle Management Software Inc.
• NVIDIA is a trademark or registered trademark of NVIDIA Corporation in the United States and/or other countries.
• OpenOffice.org and Apache OpenOffice are registered trademarks of the Apache Software Foundation.
• PSIM is a registered trademark of Powersim Inc.
• ROMAX is a trademark of Romax Technology, LTD.
• Tecplot is a registered trademark of Tecplot, Inc. in the United States and other countries.
• Trademark information for PowerCore, owned by ThyssenKrupp Electrical Steel GmbH.
• All other product and company names are trademarks, registered trademarks, or service marks of their respective companies, organiza-
tions, or holders.
• This document does not include the letters ® and TM.
CONTENTS

About This Edition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

JMAG-Designer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Launching JMAG-Designer from Windows Start Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Launching JMAG-Designer from the Command Line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Quitting JMAG-Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
[Project Manager] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
[Treeview] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
[Filter] Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
[Project Manager] Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
[Control] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
Graphics Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
[Toolbox] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
[Materials] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
[Conditions] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
[Scripts] Tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
[Analysis Templates] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
[Equations] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
[Views] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Step Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Case Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Animation Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

Circuit Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Exiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Editing the Circuit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
[Circuit Manager] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Circuit Creation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
[Toolbox] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
[Libraries] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Step Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Graph Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72

3
JMAG Version 22.2 User's Manual
Screen Configuration

Exiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Dataset List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Graph List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

Script Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Exiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Debug Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

Geometry Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Components of the Geometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Exiting, or Sifting to the Standby Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
[Model Manager] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
[Treeview] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
[Control] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Graphics Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
[Toolbox] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
[Geometry Library] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
[Undo Stack] Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

Transformer Modeling Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Starting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Exiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
[Core] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
[Bobbin] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
[Coil] Tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128

JMAG-Scheduler . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Launching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Exiting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Showing and Hiding the JMAG-Scheduler Window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Menu Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
Tool Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Job List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
Job Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138

4
JMAG-Express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Start and Exit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Launching JMAG-Express from Windows Start Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Launching JMAG-Express from JMAG-Designer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Launching JMAG-Express from the Command Line. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Quitting JMAG-Express. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Design Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Data View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

5
JMAG Version 22.2 User's Manual
Screen Configuration

6
About This Edition

“JMAG User’s Manual Screen Configuration” explains the screen composition in the following programs.
• JMAG-Designer
• Circuit Editor
• Geometry Editor
• Transformer modeling tool
• JMAG-Scheduler
• Script Editor
• JMAG-Express
MEMO JMAG user's manual is divided into contents.
• “JMAG Installation Manual”.
• “JMAG User's Manual Screen Configuration Edition”
• “JMAG User's Manual Operations Edition”
• “JMAG User's Manual Parameter Explanation Edition”
• “JMAG User's Manual JMAG-Express, JMAG-RT, JMAG-RT Viewer Edition”
• “JMAG User's Manual Coupled Analysis Edition”
• “JMAG User's Manual Files Edition”
• “JMAG User's Manual Licenses”
• “JMAG User's Manual Scripts Edition” and “Script Help”.
• “JMAG User's Manual Analysis Guide”
• “JMAG User's Manual Iron Loss Formulas”

7
JMAG Version 22.2 User's Manual
Screen Configuration

8
JMAG-Designer

JMAG-Designer is JMAG’s flagship program. From electromagnetic field analysis to thermal and structural
analyses, JMAG-Designer covers a wide variety of analyses and has advanced modeling functions as well as a
variety of result analysis features.
The JMAG-Designer main window is composed of the following elements:
• Menu Bar • Step Control
• Tool Bar • Case Control
• [Project Manager] • Animation Control
• Graphics Window • Status Bar
• [Toolbox]

Animation
Step Control Menu Bar Toolbar
Control

Case Control

Graphics Window

Project Manager Tool Box

JMAG-Designer main window

 Topics in This Chapter

• Start and Exit (page 11)
• Menu Bar (page 14)
• Tool Bar (page 20)
• [Project Manager] (page 24)
• [Treeview] Tab (page 24)
• [Control] Tab (page 36)

9
JMAG Version 22.2 User's Manual
Screen Configuration

• Graphics Window (page 38)

• [Toolbox] (page 41)
• [Materials] Tab (page 42)
• [Conditions] Tab (page 45)
• [Scripts] Tab (page 45)
• [Analysis Templates] Tab (page 48)
• [Equations] Tab (page 49)
• [Views] Tab (page 51)
• Step Control (page 53)
• Case Control (page 53)
• Animation Control (page 53)
• Status Bar (page 53)

10
 JMAG-Designer

Start and Exit

• Launching JMAG-Designer from Windows Start Menu (page 11)
• Launching JMAG-Designer from the Command Line (page 11)
• Quitting JMAG-Designer (page 13)

Launching JMAG-Designer from Windows Start Menu

1. Click the Start icon in Windows and click JMAG-Designer in the list of applications.
JMAG-Designer starts and the startup window is displayed.
Operations such as opening a recently used file or linking with commercial CAD software can be
directly performed from the startup window.
MEMO If [Close] is clicked after selecting [Do not show this dialog in the future] in the startup win-
dow, the startup window will no longer be displayed during JMAG-Designer startup. In order to dis-
play the startup window again when launching JMAG-Designer, it is necessary to change its
environment settings.

Startup Window

Launching JMAG-Designer from the Command Line

 Windows (using command)

1. Execute the command to run JMAG-Designer.

If the JMAG-Designer installation folder is set to INSDIR, execute the following command:
(INSDIR=C:\Program Files\JMAG-Designer22.2, etc.).
cd $INSDIR
designer.exe

File paths with spaces need to be enclosed with double quotation marks (").
Enter the file path after the execution command when running JMAG-Designer specifying a
JCF file or script file. The following is an execution example:

11
JMAG Version 22.2 User's Manual
Screen Configuration

cd "C:\Program Files\JMAG-Designer22.2"
designer.exe "D:\JMAG\2Dmotor.jcf"

 Linux (using command)

1. Execute the command to run JMAG-Designer.

If the JMAG-Designer installation folder is set to INSDIR, execute the following command:
(INSDIR=/home/JMAG-Designer22.2, etc.)
cd $INSDIR
./designer

The path to the library and a symbolic link must be set every time the terminal is run (See the
JMAG Linux Module Installation Manual). Therefore, run the following commands during the
first startup from the terminal. Executing the setenv script file specifies path to the library.
cd $INSDIR
source setenv
./designer

The setenv file is a file with the setting commands for environmental variables written in a bash
shell. To set the path to the library in csh or other shells, the file where the export command is
replaced with the setenv command needs to be separately prepared.

 designer command-line options (Windows/Linux)

Example 1 of using options (Windows):
cd "C:\Program Files\JMAG-Designer22.2"
designer.exe "D:\JMAG\2Dmotor.jcf" -x

Example 2 of using options (Linux):

cd /home/user/installation/JMAG222
./designer -w filename.py -l /home/guest/logfile.log

Short option Long option Value Description

-x - None Opens the [Driver Setup] dialog when JMAG-Designer is
run. The graphic driver to use can be specified in this dia-
log.
Use this option when JMAG cannot be run due to the
graphics driver.
-g - None Runs a script file in non-GUI mode.
-w - None Runs a script file in non-Window mode.
-l --log Path of the Use this option when not using a GUI so that errors occur-
log file (.log) ring during execution are recorded.
outputted
- --multi None Executes multiple cases simultaneously using a power sim-
ulation license (PSL).
- --project-key None Specifies the project to be executed when multiple cases are
or to be executed using a power simulation license (PSL).
--project-
key-file
- --reservation Reservation Uses reserved licenses prior to executing JMAG-Designer.
key value

12
 JMAG-Designer

Quitting JMAG-Designer
Perform one of the following operations from the JMAG-Designer main window:
• Select [File] > [Exit] from the menu bar.
• Click displayed in the upper-right corner of the window.

13
JMAG Version 22.2 User's Manual
Screen Configuration

Menu Bar
The JMAG-Designer menu bar has the following commands:

JMAG-Designer Menu Bar

 [File] menu
Command Description
[New] Creates a new project. When a new project is created, the current proj-
ect is closed and a dialog to save the project is displayed.
[Open] Opens files such as project files (.jproj) or result files (.jplot). Also, when
linking with CAD software, a file of the linked CAD software is opened
from this command.
[Import CAD File] Imports a data file created with CAD software to JMAG-Designer.
[Save] Saves the open project to a project file.
The first time you save the file, you will need to specify a name and a
location to save it. The second and subsequent times, the project file
will be overwritten.
[Save As] Saves the open project to the specified location with a new name.
[Export Project] Saves only selected models and studies in the project file (.jproj).
[Export HSF File] Saves objects such as contour plots shown in the graphics window in
“HOOPS Streaming Files (.hsf )” or “Hoops Meta Files (.hmf )” format.
The Hoops file can be confirmed with viewers that support Hoops files.
[Image Setup] Specifies image size when exporting the graphics window as an image
file.
[Export Image] Exports the contents displayed in the graphics window as an image file.
[Export Animation] Exports an animation of results for each step as a movie file in AVI (.avi)
format.
[Print] Prints the graphics window.
[Exit] Exits JMAG-Designer.

 [Edit] menu
Command Description
[Undo] Cancels the last performed operation.
[Redo] Runs the canceled operation again.

14
 JMAG-Designer

 [View] menu
Command Description
[Toolbars] Toggles show/hide of the following items:
• [Project Manager]
• [Toolbox]
• [File]
• [View]
• [Viewpoint]
• [Rendering Mode]
• [Selection]
• [Report]
• [Scripts]
• [Step Control]
• [Case Control]
• [Animation]
• [Restore Default]
[Viewpoint] Specifies the viewpoint of the model.
• [Front] (XY View)
• [Back] (YX View)
• [Top] (ZX View)
• [Bottom] (XZ View)
• [Left] (ZY View)
• [Right] (YZ View)
• [Isometric]
• [View Control]
[Treeview Control] Changes the expanded or collapsed state of the hierarchy display of the
[Treeview] tab in the [Project Manager] or each tab of [Toolbox] of at once.
The three hierarchical displays that can be specified are as follows:
• [Expand All]:
Expands all hierarchies in the tree.
• [Collapse All]:
Closes all hierarchies in the tree.
• [Collapse Inactive]:
Closes the lower hierarchy of inactive items.

15
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Short Cut] The JMAG-Designer graphics windows displays shortcut keys to open fre-
quently used dialogs with one-click.
The checks to the left side of the following commands indicate that the
shortcut icons of the dialog for these commands are displayed in the graph-
ics window.
Select each command and clear the check to remove the shortcut icons
from the graphics window.
• [Analysis Parameter view (Current Study)]
• [All Cases Results (Current Study)]
• [Study Property]
• [Equation]
• [Optimization]
• [Mesh Property]
• [Restore Defaults]:
Restores all shortcut icons to the state displayed in the graphics window.
[ID] • [Part], [Face], [Edge], [Vertex], [Element], [Node]:
The IDs of the part (or face, vertex, edge, element, node) is displayed on
the graphics window.
• [Show All IDs]:
The IDs of parts (or faces, edges, and vertices) that do not appear on the
solid surface are also displayed.
[Select] Switches to the mode to select parts, faces, edges, and vertices in the
graphics window.
[Visibility] Makes vertices and cut planes visible in the graphics window.
• [Vertices]
• [Show only cut planes]
• [Show Cut Planes Out Lines]
• [Display Highlighted Face Forward]
• [Toggle Transparency During Condition Editing]
[Zoom] Switches to a mode for zooming in/out of the display.
[Zoom to Area] Switches to a mode for zooming into a specified area of the display.
[Rotation] Switches to a mode for rotating the view of a model.
[Pan] Switches to the mode for moving the display up, down, left, and right.
[Measurement] Displays the [Measurement] dialog. In the [Measurement] dialog, point
coordinates, edge lengths, face area, the distance between two points, dis-
tance between two edges, distance between points and edges, and angles
from three points can be measured.
[Volume/Area Calcula- Displays the [Volume/Area Calculation] dialog. In the [Volume/Area Cal-
tion] culation] dialog, the volume of parts and elements, and the area of part sur-
faces and element faces can be calculated.
[Direct Access] Displays the [Direct Access] dialog.
Direct Access is a function for searching JMAG commands and functions
from the keyword entered by the user. The command you found can be
executed on the spot and the setting panel of the function you found can
be opened.

16
 JMAG-Designer

Command Description
[Analysis Parameter View Displays the [Analysis Parameter View] dialog for the current study, cur-
(Current Study)], [Analy- rent model, current analysis group, or project.
sis Parameter View (Cur- In this dialog, you can see all the input parameter values for the study and
rent Model)], [Analysis change each value. In addition, mesh generation and analysis can be per-
Parameter View (Current formed from the [Analysis Parameter View] dialog.
Analysis Group)], [Analy-
sis Parameter View (Proj-
ect)]

 [Select] menu
Command Description
[Rectangular Region Parts or vertices can be region selected in the graphics window.
Selection], [Circle Region
Selection], [Polygon
Region Selection]
[Select Range] Displays the [Select Range] dialog.
[Select Circle] Displays the [Select Circle] dialog.
[Select ID] Displays the [Select ID] dialog.
[At Coordinate] Displays the [Select at coordinate] dialog.
[Sight Through] Not only sections that are visible, but also hidden sections of parts or ele-
ments are also selected.
[Surface Selection] Select faces, element faces, or nodes on the same surface as the selected face,
element face, or node.
[Highlight Target on When a check mark is displayed to the left of this command, parts and ele-
Mouse Over] ments will be highlight when the mouse is over items in the [Project Man-
ager] tree such as materials and conditions. When not checked, highlight
by clicking on the item in the [Project Manager] tree.

 [Tools] menu
Command Description
[Geometry Editor] Starts Geometry Editor.
[Motor Model] Starts JMAG-Express.
[Material Editor] Starts Material Editor ([Material Editor] dialog).
[Graph Manager] Starts Graph Manager.
[User Components] Displays the [User Components] dialog.
[JMAG-RT] Starts the JMAG-RT Library Manager that creates data for the circuit sim-
ulator from JMAG analysis results data.
[Calculate Motor Induc- Starts a tool to calculate the d-q axis inductance of a three-phase PM syn-
tance] chronous motor.
[Calculate Bus Bar Induc- Starts a tool to calculate self or mutual inductance of a conductor com-
tance] posed of a single part or multiple parts.
[Calculate Coil Induc- Starts a tool to calculate the inductance of a conductor.
tance]

17
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Field Integral Calcula- Starts a tool to calculate magnetic flux density and the electric field in the
tion] specified position (air), by using the results data from a magnetic field anal-
ysis or an electric field analysis.
[Force Export for Vir- Starts a tool to create universal files that can use vibration/noise analysis
tual.Lab] from LMS Virtual.Lab by using the electromagnetic force data included in
the result of a magnetic field transient analysis.
[Force Mapping for Starts a tool to create files to use in an Abaqus structural analysis by using
Abaqus] electromagnetic force data calculated in a magnetic field analysis in JMAG.
[Heat Generation Map- Starts a tool to create files to use in an Abaqus heat transfer analysis by
ping for Abaqus] using the Joule loss or iron loss data calculated in a magnetic field analysis
or an iron loss analysis in JMAG.
[Multi-Purpose File Starts a tool to export data in Nastran or CSV format for mesh, analysis
Export] data (time and frequency), and results data (physical quantity) created in
JMAG. Also, this tool can use results data for simulation software other
than JMAG to be mapped as an input parameter value in a JCF file for
JMAG.
[Create Hysteresis Curve] Starts a tool to create a hysteresis curve for JMAG FEA from data from
actual measured values.
[Reset Window Position] Restores the default position of windows and dialogs, such as the [Edit Cir-
cuit] window and the [Study Properties] dialog.
[Preferences] Opens the [Preferences] dialog. Set the environment settings of JMAG-
Designer in this dialog.

 [Window] menu
Command Description
[New Window] Duplicates an active window and opens a new window of the same model.
Results can be confirmed from different steps and viewpoints in one study.
[Close] Closes the active window.
[Close not actives] Closes all the windows that are not active. At the same time, the active win-
dow is maximized.
[Tile] Displays multiple windows vertically next to each other.
[Cascade] Displays multiple windows cascading each other.
[Previous]/[Next] Switches the active window from one window to another.

 [Scripts] menu
Command Description
[Start Recording] Starts recording the operations in JMAG-Designer in a script.
[Stop Recording] Stops recording the operations in JMAG-Designer in a script, and displays
the scripts that were recorded in the Script Editor.
[Python Console] Opens a terminal window for typing script commands directly.
[Script Editor] Opens an editor window for editing script commands.
[Show Script Toolbox] Displays the [Scripts] tab of [Toolbox].

18
 JMAG-Designer

 [Help] menu
Command Description
[Help] Opens JMAG-Designer Help.
[JMAG-RT Help] Opens JMAG-RT Help.
[Self Learning System] Opens the Self Learning System, a tutorial program designed to teach the
user the procedures and concepts for JMAG-Designer simulations.
[Application Catalog] [Application Note] opens the JMAG Application Catalog.
[JMAG Website] Opens the JMAG website which provides information about JMAG prod-
ucts and services.
[License Information] Displays JMAG license information.
[About] Displays the JMAG-Designer version information.

19
JMAG Version 22.2 User's Manual
Screen Configuration

Tool Bar
The toolbars of JMAG-Designer contain the following buttons:

 [File] toolbar
Icon Name Description
[Open an existing Opens files such as project files (.jproj) or result files (.jplot). When
project] linking with CAD software, the file of the linked CAD software is
opened from this button.
[Save] Saves the open project to a project file.
[Undo] Cancels the last performed operation.
[Redo] Runs the canceled operation again.

 [View] toolbar
Icon Name Description
[View Model] Displays CAD model.
[View Mesh Displays the outline of a mesh model. When the result is output,
Geometry] displacement and physical quantities can be checked.
[View Mesh] Displays the mesh model. When the result is output, displacement
and physical quantities can be checked.
[Display Contour Displays the contour plots.
Result]
[Display Max Posi- For speed-priority mode structural static analysis studies, this shows
tion Result] the position where the Mises stress is at a maximum with a label.
For speed-priority mode electric field static analysis studies, this
shows the position where the maximum electric breakdown factor is
at a maximum with a label.
[Display Vector Displays the vector plots.
Result]
[Display Flux Displays flux lines.
Line]
[View Composite This button is displayed when [Composite Result] settings are
Result] added to studies, and displays multiple plots (contours, vectors, flux
lines) in a single window simultaneously.
[Model Copy] Displays the results of a partial model as a full model.
[View Original Cascades the displays of original model. Displays the original model
Model] with red lines.
[View Scaled Dis- Applies scale in the currently displayed model.
placement]
[Show the Graph Starts Graph Manager.
Manager]
[Geometry Editor] Starts Geometry Editor.
[Motor Model] Starts JMAG-Express.

20
 JMAG-Designer

Icon Name Description

[Fit to Window] Zooms in or out so that the entire model is displayed in the appro-
priate size.
[Select] Switches to the mode to select parts, faces, edges, and vertices in the
graphics window.
[Zoom] Switches to a mode for zooming in/out of the display.
[Zoom to Area] Switches to a mode to enlarge a specified area of the model.
[Rotate] Switches to a mode to rotate the view of a model.
[Pan] Switches to the mode to pan the view of a model vertically and hori-
zontally.
[Measurement] Displays the [Measurement] dialog. In the [Measurement] dialog,
point coordinates, edge lengths, face area, the distance between two
points, distance between two edges, distance between points and
edges, and angles from three points can be measured.
[Volume/Area Cal- Displays the [Volume/Area Calculation] dialog. In the [Volume/
culation] Area Calculation] dialog, the volume of parts and elements, and the
area of part surfaces and element faces can be calculated.
[Rectangle Region Selects parts and elements within the rectangle area that specified.
Selection]
[Circle Region Selects parts and elements within the circle area that specified.
Selection]
[Polygon Region Selects parts and elements within the polygon area that specified.
Selection]
[Sight Through] Selects the hidden parts or elements also, when parts or elements are
overlapping and hiding. However, even if [Sight Through] is
selected, parts and elements in the hidden state cannot be selected.
[Surface Selection] Selects faces, element faces, or vertices on the same surface as the
selected face, element face, or vertex.

 [Viewpoint] toolbar
Icon Name Description
[Front] Displays the front of the model.
The Z-axis of the coordinate system faces the front of the screen,
and the Y-axis faces upward.
[Back] Displays the back of the model.
The Z-axis of the coordinate system faces the back of the screen, and
the Y-axis faces upward.
[Top] Displays the top of the model plane.
The Y-axis of the coordinate system faces the front of the screen, and
the Z-axis faces downward.
[Bottom] Displays the bottom of the model plane.
The Y-axis of the coordinate system faces the back of the screen, and
the Z-axis faces upward.
[Left] Displays the left side of the model.
The X-axis of the coordinate system faces the back of the screen, and
the Y-axis faces upward.

21
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Right] Displays the right side of the model.
The X-axis of the coordinate system faces the front of the screen,
and the Y-axis faces upward.
[Isometric View] Displays the isometric angle of a model.
The coordinate system is shown at an angle from an oblique posi-
tion.The X, Y, and Z axes are shown to be 120 degrees apart from
each other.
[Show the View Opens the [View Control] dialog.
Control Dialog]

 [Rendering Mode] toolbar

Icon Name Description
[Shaded] Displays a shaded model. This is the default display.
[Hidden Lines Displays only the lines that can be seen by painting the model in the
Removed] same color as the background.
[Wireframe] Displays a wireframe of the model.
[Show Only Cut Displays only cut planes in studies that have results and mesh.
Planes]
[Show Cut Planes When the cut plane display is valid, an outline of the cut geometry
Outlines] is displayed.
[Display High- Displays the selected face forward.
lighted Face For-
ward]
[Toggle Transpar- Sets transparency when specifying and editing a condition for a 3D
ency During Con- model.
dition Editing]

 [Selection] toolbar
Icon Name Description
[Select Vertex] Switches to the mode to select vertices.
[Select Edge] Switches to the mode to select edges.
[Select Face] Switches to the mode to select faces.
[Select Part] Switches to the mode to select parts.
[Select Node] Switches to the mode to select nodes.
[Select Element Switches to the mode to select element edges.
Edge]
[Select Element Switches to the mode to select element faces.
Face]
[Select Element] Switches to the mode to select elements.

22
 JMAG-Designer

 [Report] toolbar
Icon Name Description
[Capture Image] Captures the graphics window. Captured images can be output to
reports.

 [Script] toolbar
Icon Name Description
[Start Recording] Starts recording the operation in JMAG-Designer in a script.
[Start Recording] changes to [Stop Recording] after clicking.
[Stop Recording] Stops recording the operations in JMAG-Designer in a script, and
displays the scripts that were recorded in the Script Editor.
[Stop Recording] changes to [Start Recording] after clicking.

23
JMAG Version 22.2 User's Manual
Screen Configuration

[Project Manager]
In [Project Manager], the contents of the project currently displayed in JMAG-Designer can be con-
firmed and operations for each item such as project itself and the model and study belonging to the
project.
The contents of the project are displayed based on the hierarchical structure on the [Treeview] tab.
The [Control] tab is used when setting the parameters of individual items in the project.

[Treeview] Tab
The [Treeview] tab displays information about the structure of the model data, materials, condi-
tions, mesh, and analysis results to be analyzed.

[Treeview] tab

[Filter] Box
The corresponding study will be filtered and displayed in the tree when part of the display name of
the study (or model) displayed in the tree is typed in the [Filter] box.
The filter is effective when the string including the following information is typed. A wildcard char-
acter (?, *) can also be used for the input.

24
 JMAG-Designer

• Model name:
All studies included in the corresponding model will be displayed in the tree.
• Description of study name or study:
The corresponding study will be displayed in a tree.

[Project Manager] Tree

Analysis groups, projects, models, studies, etc. are hierarchically displayed in the tree in the
[Treeview] tab (hereafter [Project Manager] tree).
From the tree, operations such as selecting each item displayed in the tree, and setting properties or
suppression can be performed.

 Project
This is the top level of the hierarchy in the tree. The configuration of parts and analysis conditions
are managed within “Projects.”

Configuration Items
A project is composed of a “model” which manages the model data units and assembly structures.

Context menu
The following commands can be executed from a menu displayed by right-clicking a project:

Command Description
[Submit All Models to Performs a calculation in the background on study cases included in all
Queue] models by using JMAG-Scheduler. JMAG-Designer can be operated when
running an analysis, if it is run in background.
[Restore CAD Links for This command is displayed when [Support Multiple Simultaneous CAD
All Models] Links] is selected in the [Preferences] dialog.
This command restores the link between each model and JMAG’S geome-
try creation software when multiple models are added to the project.
[Close CAD Links for All This command is displayed when each model added to the project has
Models] restored a link to JMAG’s geometry creation software.
This command closes all links between each model and JMAG’s geometry
creation software.
[Check for New Results] When the calculation is executed in the background, for all the studies for
which the result is not displayed, check the existence of the result and load
the results that existed at once.
[Check Results in Folder] Opens all result files in the specified folder.
[Open JMAG-Express Opens a study or analysis group in the JMAG-Express view when a single
View] study or analysis group is included in the project.
Opens the selected study or analysis group in the JMAG-Express view
when multiple studies or analysis groups are included in the project.
Opens the [JMAG-Express Startup] dialog when none of the studies or
analysis groups are included in the project.
[Geometry Editor] • [Create Geometry]:
Starts Geometry Editor.
• [Import Geometry]:
Imports a model from Geometry Editor.

25
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Motor Model] • [Create with JMAG-Express]:
Starts JMAG-Express Classic.
• [Import]:
Imports a model from JMAG-Express Classic.
[Transformer Model] • [Create]:
Starts the Transformer Modeling tool.
• [Import]:
Imports a model from the Transformer Modeling tool.
[Integration Model] Adds an integration model to your project. An integration model is a
model that has no shape, and you can create an integration analysis study
for this model.
[Create Analysis Group] Adds an analysis group to your project.
[Manage Project] Performs operations such as deleting, changing the title, and changing the
order of the display in the tree for models or studies belonging to the proj-
ect.
[Import Analysis Tem- Applies analysis template to models in the project from file (.jtmpl). From
plate] this operation, analysis templates created from analysis groups can be also
applied.
[Analysis Parameter View] Displays the [Analysis Parameter View] dialog.
With the [Analysis Parameter View] dialog, the input parameter values of
studies can be checked in a single dashboard, and each value can be
changed. Mesh generation and analysis can additionally be executed from
the [Analysis Parameter View] dialog.
[Result View] Displays the [Result View] dialog (or the [All Cases Result View] dialog).
With the [Result View] dialog, the analysis results (graphs, diagrams, and
response tables) of selected cases can be checked within a single window.
With the [All Cases Result View] dialog, the analysis results (graphs, dia-
grams, and response tables) of all cases can be checked within a single win-
dow.
[Properties] Edits the properties of the project.

 [Solid model], [2D model], [Mesh model], [Integration model]

[Solid model], [2D model], or [Mesh model] is added to the [Project Manager] tree when:
• a CAD link is started
• a shape created with the Geometry Editor or commercially available CAD software is imported
• a JCF file created in JMAG-Designer Version 5.0 or earlier versions is loaded

[Integration Model] is added to the [Project Manager] tree when:

• an integration analysis study is added from the context menu of an assembly in the [Project Man-
ager] tree
• the JCF file of the integration analysis study is loaded to the project
• an RTT file is loaded into a project

26
 JMAG-Designer

Configuration Items
The model consists of the following items.
However, since the integration model is a model without a shape, items related to shape are not dis-
played.

Item Description
[Unit] The unit system is defined for each model. The unit system selected in the
[Units] tab of the [Preferences] dialog is applied to the model at one of the
following times:
• When a new model is added to [Project Manager]
• When a unit system is acquired for the model
[Equations] Equation variables can be created and used when specifying JMAG-
Designer and Geometry Editor values. Using variables allows parameter
values to be changed in accordance with expressions you created, and
allows relationships between parameters to be defined also via expressions.
MEMO Variables can be added to studies, models, and analysis groups.
Additionally, by registering variables as equation groups in the [Equations]
tab in the [Toolbox], those variables can be used across several different
projects.
[Assembly] Displays each part included in the assembly of the model data. The flags to
the left of assemblies and parts can be used to toggle between hiding and
displaying. Depending on the type of part, different icon images are dis-
played in the [Project Manager] tree.
• : Displayed when the type of part is a beam.
• : Displayed when the type of part is a shell.
• : Displayed for parts other than a shell or beam.
• : Displayed when parts are grouped. There is no difference in the type
of parts that are grouped (solid, beam, or shell).
[Cut plane] Defines a cross section to check the distribution of physical quantities
inside the model. Planar and cylindrical cross sections can be defined.
• : Displayed when cut planes are set.
• : Displayed when cut cylinders are set.
[Set] under [Template A “set” is a function that groups multiple parts, faces, edges, or vertices.
Parameter] A “set” can be selected as a items to set of each condition. Conditions can
be easily set by creating a set in advance when setting multiple conditions
on the same part.
The type of icons displayed in the [Project Manager] varies depending on
the type of set.
• : Displayed when parts are grouped as a set.
• : Displayed when faces are grouped as a set.
• : Displayed when edges are grouped as a set.
• : Displayed when vertices are grouped as a set.

27
JMAG Version 22.2 User's Manual
Screen Configuration

Item Description
[Reference Target] under In JMAG, there are many parameters that define the direction and coordi-
[Template Parameter] nate for such as magnetization direction of permanent magnet, axis direc-
tion and a point on the axis of Rotation Periodic Boundary condition. To
define the direction and coordinate, there is a method to refer to the face/
edge/vertex.
By setting the face/edge/vertex as reference target in advance, it become
easier to define the direction/coordinate using same face/edge/vertex at
multiple functions/conditions.
In addition, the information of reference target can be inherited to other
models using the analysis template function.
The type of icons displayed in the [Project Manager] varies depending on
the type of reference target.

• : Displayed when a face is registered as a reference target.

• : Displayed when an edge is registered as a reference target.

• : Displayed when a vertex is registered as a reference target.

[Coordinate System] The coordinate system is used when specifying the direction in condition
settings. The coordinate system can be set for each model. Types of coordi-
nate systems include the rectangular and cylindrical coordinate systems.
• : Displayed when the type of coordinate system is a rectangular coor-
dinate system.
• : Displayed when the type of coordinate system is a cylindrical coordi-
nate system.
• : Displayed when the type of coordinate system is a user-defined rect-
angular coordinate system.
• : Displayed when the type of coordinate system is a user-defined
cylindrical coordinate system.
[Study] To perform an analysis, it is necessary to set operating environments and
drive conditions for the analysis target, as well as material properties of each
section. In JMAG-Designer, these types of settings are managed in units
referred to as a “study”.
For details, see “Study” on page 30.

Context menu
The following commands can be executed from the menu displayed by right-clicking [Solid model],
[2D model], or [Mesh model].
The [Integration Model] is a model without a shape; therefore, commands related to shape are not
displayed in the context menu.

Command Description
[New Study] Creates a study. Studies that can be created depend on the license used.
[New Application Study] Creates a new study. Application studies that can be created depend on the
license used.
[Create Analysis Tem- Exports current model as an analysis template to a file (.jtmpl). An analysis
plate] template contains conditions and material settings.

28
 JMAG-Designer

Command Description
[Add as Analysis Tem- Adds current model as an analysis template to the [Analysis Template] tab
plate to Toolbox] in the [Toolbox]. An analysis template contains conditions and material
settings.
[Apply Analysis Template] Applies analysis template to the current model from file (.jtmpl).
[Open JMAG-Express Opens the study in the JMAG-Express view when a single study is included
View] in the current model.
Opens the selected study in the JMAG-Express view when multiple studies
are included in the project.
[Analysis Parameter View] Displays the [Analysis Parameter View] dialog.
With the [Analysis Parameter View] dialog, the input parameter values of
studies can be checked in a single dashboard, and each value can be
changed. Mesh generation and analysis can additionally be executed from
the [Analysis Parameter View] dialog.
[Result View] Displays the [Result View] dialog (or the [All Cases Result View] dialog).
With the [Result View] dialog, the analysis results (graphs, diagrams, and
response tables) of selected cases can be checked within a single window.
With the [All Cases Result View] dialog, the analysis results (graphs, dia-
grams, and response tables) of all cases can be checked within a single win-
dow.
[Check for New Result] When performing calculations in the background, the result file is
imported from the calculation folder into JMAG-Designer and linked with
the study.
[Check Results in Folder] Opens all result files in the specified folder.
[Run All Studies] Runs all studies included in the current model.
[Submit All Studies] Performs calculations in the background for the cases of all studies by using
JMAG-Scheduler. JMAG-Designer can still be operated when running
analyses if analyses are run in the background.
[Replace Model] While Geometry Editor or commercial CAD software are linked with
JMAG-Designer, replace the current model with geometries edited by
those programs.
[Update Model] While Geometry Editor or commercial CAD software are linked with
JMAG-Designer, geometries edited by those programs are imported into
JMAG-Designer. The settings of current model is inherited to the
imported model.
[Extend Model To 3D] This command can be selected in 2D/axisymmetric model.
Extends 2D/axisymmetric model to 3D using Geometry Editor.
[Restore CAD Link] Initiates a link between JMAG-Designer and Geometry Editor or commer-
cial CAD software.
[Change Link to Geome- Opens a model in Geometry Editor.
try Editor]
[Center Model] Changes the position of the model.
[Check Geometry] Checks for geometry errors.
[Delete Model] Deletes a model.
[Remove Mesh Cache] This command can be selected in solid model.
Removes the cache data for mesh generation that was created when export-
ing JCF files from a study created on a solid model.
[Properties] Edits the properties of the model.

29
JMAG Version 22.2 User's Manual
Screen Configuration

 Study
A study is added to the [Project Manager] tree when:
• a basic study or application study is added to [Solid Model], [2D Model], or [Mesh Model]
• an integration analysis study is added to [Integration Model]
• a JCF or RTT file is imported into [Project]

Configuration Items
Note that the integration analysis study is a study without a shape; therefore, items related to shape
are not displayed.

Item Description
[Case Control] Use this item when adding/managing analysis cases and design variables for
parametric analysis.
[Response Table Cre- Displayed for efficiency map analysis studies.
ation] Use this item when setting up the response table for running efficiency
map analysis studies.
[CAD Parameters] Use this item when editing a shape created with Geometry Editor on
JMAG-Designer or when using the dimension value of the shape as a
design variable for parametric analysis.
To reflect changed CAD parameters to the model in the graphics window,
right-click [CAD Parameters], and select [Apply Values] or [Apply All
Cases].
[Parts] This displays parts and groups that a model is composed of.
When the mouse pointer is moved over a part, the outline of the corre-
sponding part or group is highlighted in the graphics window.
Materials and conditions can be set by dragging and dropping materials
and conditions from [Toolbox] to the positions of parts and groups dis-
played under [Parts] in the [Project Manager] tree. If a material is assigned
to a part, the name of a material is displayed to the right side of the part.
The type of icons displayed in the [Project Manager] varies depending on
the type of part.
• : Displayed for parts for which no mesh has been generated.
• : Displayed for grouped parts for which no mesh has been generated.
• : Displayed when the mesh has already been generated. Or displayed
for mesh groups that are treated as parts.
This displays materials used in a study. The type of icons displayed in the
[Materials]
[Project Manager] varies depending on the type of material.
• Displayed when the type of material is a magnet.
• Displayed when the type of material is an electromagnetic steel sheet.
• Displayed when the type of material is other than a magnet or electro-
magnetic steel sheet. user magnetized magnet is also included.
This displays a winding setting used in a study.
[Winding]
This displays conditions set in a study.
[Conditions]
This displays circuit components used in a study.
[Circuit]

30
 JMAG-Designer

Item Description
[Mesh] This displays the mesh generation functions used in a study.
Right-click [Mesh] and select [Generate] to generate mesh. To display gen-
erated mesh, select [View Mesh] on the toolbar.
• Right-click [Group] to display the commands for creating mesh groups.
A mesh group is a function for grouping together elements, element
faces, element edges, or nodes as so to configure settings for materials and
conditions. The icon image displayed in the [Project Manager] tree will
differ depending on the type of group.
• : Displayed for element groups.
• : Displayed for element face groups.
• : Displayed for element edge groups.
• : Displayed for node groups.
• Use the checkboxes displayed to the left of [Mesh Region] and [Air
Mesh] to switch each between being shown/hidden.
• Right-click [Mesh Report] to display the commands for displaying mesh
reports. Mesh reports enable the ability to check the parameter values
used when generating mesh.
[Report] Right-clicking [Report] displays a menu for creating a report that lists
the settings and results of the study.
[Post Calculation When processing or editing the JMAG results data that have been
imported into the commercial software such as Microsoft Excel, Ope-
Scripts]
nOffice, and MATLAB, processing can be automated by registering a
series of processes in JMAG as “post-calculation scripts”.
[Result Items] and When there is no analysis result in the study, [Result Items] is displayed,
and if there is an analysis result [Results] is displayed.
[Results]
When [Result Items] or [Results] is right-clicked, menus for setting con-
tour plots, vector plots, flux lines, and scales, and menus for displaying
results in a list are displayed.

31
JMAG Version 22.2 User's Manual
Screen Configuration

Item Description
The following items are displayed under [Result Items] or [Results]:
• [Graphs]
• [Calculation]
• [Efficiency Map]:
Displayed after an efficiency map analysis study is created.
• [Response Table]
• [Map]
• [Section]
• [Probe]
• [Calculation Tools]
• [Filters]
• [Response Graphs]
• [Response Data]
• [Vector Expressions]
• [Graphs]
• [Contour Plots]
• [Vector Plots]
• [Flux Lines]
• [Scale]
• [Composite Result]
Right-clicking these items will display commands such as result display set-
tings, graph creation, and result data calculation processing, etc.
[Model Copy] This is displayed after an analysis is completed. Use when confirming the
result as a full model by copying the results of the partial model.

Context menu
The following commands can be executed from the menu that is displayed when you right-click a
study.
However, the integration analysis study is a study without a shape; therefore, the context menu does
not display commands related to shape.

Command Description
[Open JMAG-Express Opens the current study in JMAG-Express view.
View]
[Analysis Parameter View] Displays the [Analysis Parameter View] dialog.
With the [Analysis Parameter View] dialog, the input parameter values of
studies can be checked in a single dashboard, and each value can be
changed. Mesh generation and analysis can additionally be executed from
the [Analysis Parameter View] dialog.
[Run Active Case] Runs the current case in the foreground. Other operations cannot be run in
JMAG-Designer while it is running an analysis in the foreground.
[Run All Cases] Runs all cases included in the current study in the foreground. Other oper-
ations cannot be run in JMAG-Designer while it is running an analysis in
the foreground.

32
 JMAG-Designer

Command Description
[Restart] Resumes the suspended analysis in the foreground. Other operations can-
not be run in JMAG-Designer while it is running an analysis in the fore-
ground.
[Submit Restart to Resumes the suspended analysis in the background by using JMAG-Sched-
Queue] uler. JMAG-Designer can even be operated when running an analysis in
background.
[Submit Active Case to Runs the current case in the background by using the JMAG-Scheduler.
Queue] JMAG-Designer can even be operated when running an analysis in back-
ground.
[Submit All Cases to Runs all the cases included in the current study in the background by using
Queue] JMAG-Scheduler. JMAG-Designer can even be operated when running an
analysis in background.
[Check Result for Active Loads the result file of the current case from the calculation folder when
Case] batch processing analyses.
[Check Results for All Loads the result file of all cases from the calculation folder when batch pro-
Cases] cessing analyses.
[Check Results in Folder] Imports all result files in the specified folder.
[Check for New Cases] Loads the cases generated during optimization.
[Load Multi Case Results] When analysis is run in the background by using a local machine, or analy-
sis is run by using an SSH remote machine, a response table that includes
the results of cases that have finished calculating is loaded into JMAG-
Designer on the local machine. Loading the response table does not involve
downloading any of the result files. The loaded response table is displayed
in the [Load Multi Case Results] dialog.
[Load Topology Optimi- Loads the results of cases generated during topology optimization.
zation Results]
[Add a Case by Specifying Recreates the specified calculation case using the input file of topology
a Weight File] optimization and the CSV file containing the Gaussian weight informa-
tion.
[Delete Results of Active Deletes results for the current case. It also deletes the result file itself.
Case]
[Delete Results of All Deletes the results for all cases. It also deletes the result file itself.
Cases]
[Delete ResultSets of Deletes results of the current case from the study. The result file will remain
Active Case from Study] on the machine.
[Delete ResultSets of All Removes the results of all cases from the study. The result file will remain
Case from Study] on the machine.
[Remove Results from Deletes a part of the results data from the result file of the study.
Plot File]
[New Loss Study] Creates a section analysis study from a magnetic field analysis study.
[New Section Study] Creates a section analysis study from a 3D magnetic field analysis study.
[Add Winding] This command is displayed when a winding setting is not added to a study.
This adds a winding setting to a study.
[Delete Winding] This command is displayed when a winding setting is added to a study.
This deletes a winding setting from a study.
[Add Circuit] Adds a circuit into a study.
[Import Circuit] Imports a circuit from the circuit information file (.jcir or .cct) into a study.

33
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Export Circuit] Exports a circuit to the circuit information file (.jcir or .cct).
[Delete Circuit] Deletes a circuit from a study.
[Check Geometry] Checks for geometry errors.
[Export JCF] Exports the study as a jcf file. Either geometry data or mesh data can be
selected as data types to be exported.
[Merge JCF] Merges a separate study into the study.
[Duplicate Study] Duplicates a study.
[Delete Study] Deletes a study.
[Add as Analysis Tem- Adds current study as an analysis template to the [Analysis Template] tab in
plate to Toolbox] the [Toolbox]. An analysis template contains conditions and material set-
tings.
[Properties] Edits study properties.

 Analysis Group
An analysis group is added to the [Project Manager] tree when creating an analysis group from stud-
ies in the model.

Configuration Items
Item Description
[Open JMAG-Express Opens the selected study in the JMAG-Express view from the studies
View] included in the current analysis group.
[Case Control] Adds and manages analysis cases and design variables of parametric
analysis.
Studies in the analysis Studies belonging to the analysis group are displayed.
group • : Displayed when it is an active study (study that is displayed in the
graphics window).
• : Displayed when it is a non-active study.
[Filters] Displays the custom filter added to the analysis group.
A case can be extracted among a number of cases by specifying filter condi-
tions (case number, response value, etc.)
[Post Calculation Scripts] When processing or editing the JMAG results data that have been
imported into the commercial software such as Microsoft Excel, OpenOf-
fice, and MATLAB, processing can be automated by registering a series of
processes in JMAG as “post-calculation scripts”.
[Response Graph] Calculates the response value which is one real value from the physical
quantity output as the result of each case and displays the graph.
• [Response Data]
• [Graphs]

34
 JMAG-Designer

Context menu
The following commands can be executed from a menu displayed by right-clicking an analysis
group:

Command Description
[Analysis Parameter View] Displays the [Analysis Parameter View] dialog.
With the [Analysis Parameter View] dialog, the input parameter values of
studies can be checked in a single dashboard, and each value can be
changed. Mesh generation and analysis can additionally be executed from
the [Analysis Parameter View] dialog.
[Run Active Case] Runs the current case in the foreground. Other operations cannot be run in
JMAG-Designer while it is running an analysis in the foreground.
[Run All Cases] Runs all cases in the foreground. Other operations cannot be run in
JMAG-Designer while it is running an analysis in the foreground.
[Submit Active Case to Runs the current case in the background by using the JMAG-Scheduler.
Queue] JMAG-Designer can even be operated when running an analysis in back-
ground.
[Submit All Cases to Runs all the cases in the background by using JMAG-Scheduler. JMAG-
Queue] Designer can even be operated when running an analysis in background.
[Restore CAD Links for This command is displayed when [Support Multiple Simultaneous CAD
All Models] Links] is selected in the [Preferences] dialog.
This command restores the link between each model and JMAG’s geome-
try creation software when each study uses different models within one
analysis group.
[Close CAD Links for All This command is displayed when models used in each study within one
Models] analysis group have restored a link to JMAG’s geometry creation software.
This command closes all links between each model and JMAG’s geometry
creation software.
[Result View] Displays the [Result View] dialog (or the [All Cases Result View] dialog).
With the [Result View] dialog, the analysis results (graphs, diagrams, and
response tables) of selected cases can be checked within a single window.
With the [All Cases Result View] dialog, the analysis results (graphs, dia-
grams, and response tables) of all cases can be checked within a single win-
dow.
[Check for New Cases] Loads the cases generated during optimization.
[Load Multi Case Results] When analysis is run in the background by using a local machine, or analy-
sis is run by using an SSH remote machine, a response table that includes
the results of cases that have finished calculating is loaded into JMAG-
Designer on the local machine. Loading the response table does not involve
downloading any of the result files. The loaded response table is displayed
in the [Load Multi Case Results] dialog.
[Load Topology Optimi- Loads the results of cases generated during topology optimization.
zation Results]
[Add a Case by Specifying Recreates the specified calculation case using the input file of topology
a Weight File] optimization and the CSV file containing the Gaussian weight informa-
tion.
[Ungroup] Disbands the analysis group.
[Create Analysis Tem- Exports models in the analysis group as an analysis template to a file
plate] (.jtmpl). An analysis template contains conditions and material settings.

35
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Add as Analysis Tem- Adds models in the analysis group as an analysis template to the [Analysis
plate to Toolbox] Template] tab in the [Toolbox]. An analysis template contains conditions
and material settings.
[Edit Analysis Group] Adds studies to analysis groups, or removes studies from analysis groups.
[Properties] Edits properties of analysis group.

[Control] Tab
Settings of the materials and conditions are displayed in the [Control] tab. When Current condi-
tions are set or magnets are assigned to parts as materials, the [Treeview] tab automatically switches
to the [Control] tab and the settings are displayed.
The following screen is an example of the [Rotation Periodic Boundary] settings that are displayed
in the [Control] tab:

[Control] tab

MEMO The type of condition that can be specified varies depending on the type of the model used and
the analysis type.
MEMO Clicking the [Treeview] tab while the [Control] tab is displayed can display the [Treeview] tab
and the [Control] tab side by side in the [Project Manager].

36
 JMAG-Designer

 Difference between [OK] button and [Apply] button

Both the [OK] button and [Apply] button may be displayed on the contour or vector setting panel.
Both buttons are for reflecting the settings on the setting panel in the model, however the behavior
of JMAG-Designer after clicking is different.

[OK] button and [Apply] button

• When [OK] is clicked, the setting panel is closed when the setting is reflected in the model.
• When [Apply] is clicked, the setting is reflected in the model, but the setting panel does not
close. While confirming the display, you can modify the parameters of the setting panel.

37
JMAG Version 22.2 User's Manual
Screen Configuration

Graphics Window
This window below displays models. The results of each operation performed from menus and the
[Project Manager] are reflected.

Graphics window

A coordinate system is displayed in the lower left of the graphics window. This coordinate system
shows the current view applied to the model.
By hovering the mouse cursor over conditions and materials in the [Project Manager] tree, parts and
faces set with them are highlighted in the graphics window. Other settings are also displayed in the
graphics window depending on the condition. For example, the current direction is shown for the
FEM Coil condition, and the rotation axis is shown for the Rotation Motion condition.
Multiple conditions and material settings can be viewed at once. Hold down the [Ctrl] key or [Shift]
key on the keyboard while clicking conditions and materials in the [Project Manager] tree.

 Shortcut icon
The shortcut icons are displayed in the lower part of the JMAG-Designer graphics window. Click
each icon to display the dialog of the current study.

Shortcut icon Dialog

JMAG-Express View

[Analysis Parameter View] dialog

[All Cases Result View] dialog

[Study Properties] dialog

[Equation Group] dialog

[Optimization] dialog

[Mesh Properties] dialog

To hide a shortcut icon, select [Display] > [Shortcut] > (dialog name) from the menu bar and clear
the checkbox.
To show the shortcut icon again, select [Display] > [Shortcut] > (dialog name) from the menu bar
and select the checkbox.

38
 JMAG-Designer

 Context menu
The following operations can be executed from the menu by right-clicking in the graphics window:
• Changing viewpoint
• Grouping parts
• Basic operations
• Switch between show/hide
• Modifying selected part names in a single process
• Displaying the result physical quantity of a selected target in a table

[Viewpoint]
The viewpoint of the model can be selected in [Viewpoint]. The following viewpoints can be speci-
fied:

• [Front] (XY View) • [Left] (ZY View)

• [Back] (YX View) • [Right] (YZ View)
• [Top] (ZX View) • [Isometric View]
• [Bottom] (XZ View)
[Grouping]
Operations that are related to grouping parts can be executed in [Grouping].
Selected parts are grouped when [Group Selected] is selected. The group including selected parts is
ungrouped when selecting [Ungroup Selected].

Basic operations
The following operations can be specified:

• [Fit to Window] • [Rotate]

• [Select] • [Pan]
• [Zoom] • [Measurement]
• [Zoom to Area]
Switching between show/hide
Show/hide of parts, air region, and shell can be switched from the following menu:

• [Show Selected Part] • [Show All Shell]:

• [Hide Selected Part] 3D model only.
• [Show All Parts] • [Hide All Shell]:
3D model only.
• [Hide All Parts]
• [Show All Beam]:
• [Show All Air Region]
2D model only.
• [Hide All Air Region]
• [Hide All Beam]:
2D model only.
• [Rename Selected Parts]

39
JMAG Version 22.2 User's Manual
Screen Configuration

[Rename Selected Parts]

Selected part names can be modified in a single process from [Rename Selected Parts]. The [Rename
Parts] dialog is displayed when [Rename Selected Parts] is selected. Specify a new name in the [Part
Name] box, and then click [OK]. The names for selected parts are modified to be all the same.
MEMO The name of the air region generated from the automatic mesh generation function such as
[Slide Mesh] or [Generate Mesh at Each Step] cannot be modified.

[Show Table]
[Show Table] can be selected when a case with a result is active. The result table of the physical quan-
tity for the selected targets (such as parts, elements, and nodes) can be displayed in [Show Table].
For details, see “Parameter Explanation Edition.”

 Displaying multiple graphics windows (multi-window)

On the JMAG-Designer main window, multiple graphics windows can be opened for one model.
Select [Window] > [New Window] in the JMAG-Designer menu bar to open new graphics win-
dow.The graphics window can also be closed or the active window switched from [Window].
MEMO The following commands cannot be executed when the settings panel for a condition, material,
or result is displayed on the [Control] tab in the [Project Manager] tree:
• [New Window]
• [Close]
• [Close not actives]
• [Next]/[Previous] (change the active window)

40
 JMAG-Designer

[Toolbox]
The following tabs are displayed in the [Toolbox]:

Tab Description
[Materials] tab Material data with user-defined characteristic values (custom materials),
material data provided by material manufacturers, and reference material
provided by JSOL (the material database) are displayed.
When an active study is present, material data that cannot be used with
that active study are displayed as being unavailable.
[Conditions] tab Conditions that can be used with each analysis are displayed.
This tab is empty when there are no studies created for a project.
[Scripts] tab Scripts registered by users and JMAG-provided scripts (preinstalled scripts)
are displayed.
[Analysis Templates] tab Analysis templates registered by users are displayed.
[Equation] tab Analysis groups registered by users are displayed. Each equation group has
one or more equation variables.
[Views] tab Model display directions (custom viewpoints) registered by users are dis-
played.

MEMO The [Toolbox] can be switched between being shown and hidden.
To temporarily switch this between being shown or hidden, click or in the lower-left corner of the
[Toolbox].
To keep the [Toolbox] hidden, select [View] > [Toolbars] from the menu bar, then clear [Toolbox]. Select
the checkbox to display the [Toolbox] again.

41
JMAG Version 22.2 User's Manual
Screen Configuration

[Materials] Tab
In the [Materials] tab, a list of materials that have been added to the material database is displayed in
a tree format. Materials added to the database can be applied to the parts of each study from the
[Materials] tab.
MEMO The [Select Material] dialog in JMAG-Express can be used in the same way as the [Material] tab
in JMAG-Designer; see the following descriptions also when using the [Select Material] dialog in
JMAG-Express.

Left: [Materials] tab in JMAG-Designer, Right: [Select Material] dialog in JMAG-Express

 [Look For] box

When part of the name of the material is entered into the [Look For] box, the corresponding items
are displayed in a list. To display only the materials of a specific manufacturer, enter the manufac-
turer name (e.g. ArcelorMittal) in the [Look For] box. A wildcard character (?, *) can also be used for
searching items.

42
 JMAG-Designer

 Materials tree
Each material registered in the material database is categorized by material type and manufacturer.

Components
Item Description
[Temporary] When the material used in the imported project is not registered in the
material database, it will be placed in the temporary folder.
To use the materials in the temporary folder for other projects, move to the
[Custom Materials] folder.
[Bookmarks] Displays the materials registered in bookmarks.
[Custom Materials] Displays the materials created by the user and the materials transferred
from the temporary folder.
[Ambient] Displays air.
[Permanent Magnet] Sintered NdFeB or ferrite magnets are displayed.
• [User Magnetization]:
Displays user magnetized magnet output after running a magnetization
analysis.
[Soft Magnetic Material] Displays electromagnetic steel sheet and soft magnetic composite, etc.
[Conductor] Displays aluminum and copper as reference materials provided by JSOL.
[Insulation] Displays plastic materials.

MEMO Some category contains sub categories such as composition materials or material manufactures.
MEMO Electric or thermal properties of material data provided by materials manufacturers cannot be
modified. However, such properties can be modified if they are duplicated (with the exception of some
parameters).
MEMO Contact the manufacturers for details on the data of materials they provide.

Description displays during mouse over

Mousing over each material data displayed in the material tree displays a description of each material
data. When materials have no description set, nothing is shown.

 Context menu
The following commands can be executed from the menu that is displayed when you right-click the
material data or folders:

[Custom Materials] folder

Command Description
[Create New] Creates a new custom material.

43
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Create New Folder] Creates a new folder under the custom folder.
The maximum number of layers of subfolders that can be created in the
[Custom Materials] folder is five.
[Export All Materials] Exports all material data into a file (.xml).
[Import Material] Imports material data from a file (.xml).
[Import JMAG-Studio Imports material data created in JMAG-Studio into JMAG-Designer.
Materials]
[Synchronize Material When multiple JMAG-Designers are running at the same time, the custom
Database File] material information added by each is synchronized.

[User Magnetization] folder

Command Description
[Create New Folder] Creates a new folder under the user magnetization folder.
The maximum number of layers of subfolders that can be created in the
[User Magnetization] folder is five.
[Create New User Magne- Imports user magnetized magnet data from a file (.jcf ).
tized]

Individual material data

Command Description
[Edit], [Details] Opens the Material Editor ([Material Editor] dialog) and displays detailed
information on the selected material data.
[Export] This command is displayed for custom materials, user magnetized mag-
nets.
Selecting this command exports the selected material data to a file.
[Duplicate] Duplicates selected material data. When duplicating material data provided
by a material maker or JSOL reference material data, the copied material
will be placed in the [Custom Materials] folder.
[Delete] This command is displayed for custom materials, user magnetized mag-
nets.
Selecting this command deletes selected material data.
[Add to Bookmarks] Registers selected material data to bookmarks.
[Remove from Book- Removes selected material data from bookmarks.
marks]

 Moving materials
Materials in the [Custom Materials] folder can be moved freely including sub folders by drag and
drop. This also applies for the [User Magnetization] folder.

 [Create New Material] button

This button is used to create user's material data (custom material) and add it to the material data-
base.
When clicking [Create New Material], the Material Editor ([Material Editor] dialog) opens.

44
 JMAG-Designer

[Conditions] Tab
In the [Conditions] tab, a list of conditions is displayed in the tree format. [Conditions] tab is used
to set conditions to each study.

 Conditions tree
The condition tree displays the analysis conditions available for each analysis study. To set a condi-
tion, do the following:
• Drag and drop a condition from the condition tree to [Condition] under the study in the [Proj-
ect Manager] tree.
• Drag and drop a condition from the condition tree to a part, face, edge, vertex, element, element
face, element edge, or node on the graphics window.

Conditions tree

 [Show Descriptions]
Descriptions of each condition are displayed in the conditions list by selecting this checkbox.

 [Show Condition Groups]

Conditions can be sorted by its objective by clearing this checkbox.

[Scripts] Tab
In the [Scripts] tab, a list of scripts registered in JMAG-Designer is displayed in a tree format. Scripts
can be edited and executed in the [Scripts] tab.

 [Look For] box

When entering part of the script title in the [Look For] box, the corresponding script will be dis-
played. A wildcard (?, *) can be used when searching.

45
JMAG Version 22.2 User's Manual
Screen Configuration

 Script tree
Scripts added to JMAG-Designer are sorted into several folders and displayed.

[Scripts] tab

Folder Description
[Custom] folder This is the folder where user-created normal scripts are stored. The script in
the [Custom] folder is managed as a file in a specified folder in the
machine.
[Preinstall] folder This is the folder that stores the preinstalled normal scripts in JMAG-
Designer. For details of the preinstalled script, see “Parameter Explanation
Edition”.
[Post Calculation Cus- This is the folder where user-created post calculation scripts are stored. The
tom] folder post calculation script in the [Post Calculation Custom] folder is managed
as a file in a specified folder in the machine.
[Post Calculation Prein- This is the folder that stores the preinstalled post calculation scripts in
stall] folder JMAG-Designer. For details of the preinstalled post calculation script, see
“Parameter Explanation Edition”.

Displaying description during mouse over

When hovering the cursor over each script displayed in the script tree, a description of each script is
displayed. When scripts have no description set, nothing is shown.

Simultaneous operation of multiple JMAG-Designers

When multiple instances of JMAG-Designer are running at the same time, the operation (add,
delete, etc.) on the script executed in one JMAG-Designer is reflected in other instances of JMAG-
Designer in real time.

46
 JMAG-Designer

 Context menu
The following command can be executed from the menu displayed when right-clicking the script or
script folder:

[Custom] folder, [Post Calculation Custom] folder, and their subfolders

Command Description
[Rename] Changes the name of the currently selected folder.
[Delete] Deletes the selected folder and scripts in that folder. If there is a subfolder
in that folder, that will also be deleted.
[Create New Script] This command is displayed when right-clicking the [Custom] folder and
its subfolders.
This command creates a new script.
[Create New Folder] Creates a new folder in the selected folder.
[Run] This command is displayed when right-clicking the [Custom] folder and
its subfolders.
This command runs all the scripts in the selected folder. Note, however
that the scripts in the subfolder will not be run.
[Export Scripts] Exports the selected folder as a compressed file (.zip).
[Import Scripts] Imports scripts from script files (.vbs, .py, .js) or compressed files (.zip).

[Preinstall] folder, [Post Calculation Preinstall] folder

Command Description
[Export Scripts] Exports the selected folder as a compressed file (.zip).

Individual scripts
Command Description
[Edit] This command is displayed when right-clicking the custom script.
This command activates the Script Editor and open the script. The script
can be edited or debugged in Script Editor.
[Duplicate] This command is displayed when right-clicking the custom script.
This command duplicate the selected script.
[Delete] Deletes the selected script.
[Run] This command is displayed when right-clicking the custom script.
This command runs the selected normal script.
[Add as Post Calculation This command is displayed when right-clicking the custom script.
Script] This command duplicates the selected post calculation script and adds to
the [Post Calculation Script] of current study or [Post Calculation Script]
of the current analysis group.
[Export Scripts] Exports the selected script as a compressed file (.zip).
[Property] This command is displayed when right-clicking the custom script.
This command displays the [Script Property] dialog. Script titles and
descriptions can be edited in this dialog.

47
JMAG Version 22.2 User's Manual
Screen Configuration

 [Create New Script] button

The [Create New Script] button is used to create new normal scripts.
Clicking [Create New Script] will activate the Script Editor. Use Script Editor to write the script and
click [Register] to add the new normal script to the [Custom] folder of the [Script] tab.

[Analysis Templates] Tab

In the [Analysis Templates] tab, a list of analysis templates registered in JMAG-Designer is displayed
in a tree format. In the [Analysis Templates] tab, analysis templates can be applied to a model and
exported/imported to a file.

[Analysis Templates] Tab

 [Look For] box

When part of the name of the analysis template is entered into the [Look For] box, the correspond-
ing items are displayed in a list. A wildcard character (?, *) can also be used for searching items.

 Analysis template tree

Analysis templates registered in JMAG-Designer are displayed in the [Custom] folder.
Analysis templates can be assigned by dragging-and-dropping an analysis template from the analysis
template tree to a model in the graphics window.
• [Custom] folder:
This is the folder where user created analysis templates are stored. The analysis template dis-
played in the [Custom] folder is managed in the status of the file in the specified folder on the
machine.

Displaying description during mouse over

When hovering the cursor over each analysis template displayed in the analysis template tree, a
description of each analysis template is displayed. When analysis templates have no description set,
nothing is shown.

 Context menu
The following commands can be executed from a menu displayed by right-clicking the analysis tem-
plate or folder:

48
 JMAG-Designer

[Custom] folder
Command Description
[Create New Folder] Creates a new folder in the [Custom] folder.
The maximum number of layers of subfolders that can be created in the
[Custom] folder is five.
[Export Analysis Tem- Exports the [Custom] folder as a compressed file (.zip).
plates]
[Import Analysis Tem- Imports analysis templates from analysis template files (.jtmpl) or com-
plates] pressed files (.zip).
[Synchronize Analysis When multiple JMAG-Designers are running at the same time, the analysis
Template File] template information added by each is synchronized.

User created folder

Command Description
[Rename] Changes the name of the currently selected folder.
[Delete] Deletes the selected folder and analysis templates in that folder. If there is a
subfolder in that folder, that will also be deleted.
[Create New Folder] Creates a new folder in the [Custom] folder.
[Export Analysis Tem- Exports the selected folder as a compressed file (.zip).
plates]
[Import Analysis Tem- Imports analysis templates from analysis template files (.jtmpl) or com-
plates] pressed files (.zip).

Each analysis template

Command Description
[Delete] Deletes the selected analysis template.
[Export Analysis Tem- Exports the selected analysis template as a compressed file (.zip).
plates]
[Property] Edits the title and description of the analysis template.

 Moving analysis templates

Analysis templates in the [Custom] folder can be moved freely including sub folders by drag and
drop.

 [Show Descriptions]
Descriptions of each analysis template are displayed in the list by selecting this checkbox.

[Equations] Tab
A list of analysis groups created by users are displayed in a tree format in the [Equations] tab.
Equation groups are groups consisting of one or multiple equation variables.
By registering equation groups in the [Equations] tab, the same variables can be used across several
different projects. Equation groups registered to the [Equations] tab can be imported and exported.

49
JMAG Version 22.2 User's Manual
Screen Configuration

[Equations] tab

 [Look For] box

Enter a portion of the title of an equation group to display the corresponding equation groups.
Wildcards (?, *) can also be used when performing searches.
MEMO Searches cannot be performed by using the names of the variables registered to each equation
group.

 Equations tree
Equation groups registered to JMAG-Designer are displayed in the [Custom] folder.

 Context menu
The following commands can be executed from the menu that is displayed when you right-click the
equation groups or folders:

[Custom] folder
Command Description
[Create New Equation Opens the [Equation Group] dialog.
Group] From the [Equation Group] dialog, equation groups can be created, vari-
ables to be added to those equation groups can be created, and variables
already added to those groups can be changed/deleted.
[Create New Folder] Creates a new folder under the [Custom] folder.
An hierarchical structure of up to three subfolders can be created in the
[Custom] folder.
[Export Equation Groups] Equation groups are exported with the [Custom] folder as a compressed file
(.zip).
[Import Equation Equation groups are imported as equation files (.xml) or compressed files
Groups] (.zip).

Folders created by users

Command Description
[Rename] Changes the name of the currently selected folder.
[Delete] This deletes currently selected folders and equation groups within those
folders. If subfolders are present within those folders, then those subfolders
are also deleted.
[Create New Equation Opens the [Equation Group] dialog.
Group] From the [Equation Group] dialog, equation groups can be created, vari-
ables to be added to those equation groups can be created, and variables
already added to those groups can be changed/deleted.

50
 JMAG-Designer

Command Description
[Create New Folder] Creates a new folder under the currently selected folder.
[Export Equation Groups] Equation groups are exported with the [Custom] folder as a compressed file
(.zip).
[Import Equation Equation groups are imported as equation files (.xml) or compressed files
Groups] (.zip).

Individual equation groups

Command Description
[Edit] Opens currently selected equation groups in the [Equation Group] dialog.
[Duplicate] Duplicates currently selected equation groups.
However, when subfolders have been created in the same hierarchy as equa-
tion groups, then those equation groups cannot be duplicated.
[Delete] Deletes the currently selected equation group.
[Export Equation Groups] Equation groups are exported with the [Custom] folder as a compressed file
(.zip).

 Types of Equation Groups

Equation groups in the [Custom] folder can be freely moved including subfolders by using a drag-
and-drop operation.

 [Create New Equation Group] Button

The [Create New Equation Group] button creates equation groups and adds them to the [Equa-
tions] tab.
Click [Create New Equation Group] to display the [Equation Group] dialog.

[Views] Tab
In the [Views] tab, a list of user-defined viewpoints is displayed in a tree format. A user-defined
viewpoint is called a “custom viewpoint”. On the [Views] tab, custom viewpoints can be added or
viewpoints applied to the graphics window.

 Viewpoint list
Displays a list of registered custom viewpoints.

[Views] Tab

51
JMAG Version 22.2 User's Manual
Screen Configuration

Double-click the custom viewpoint to enter a new name. Or, selecting a custom viewpoint from the
viewpoint list and pressing the [F2] key can also edit the name.

 Context menu
The following commands can be executed from the menu that is displayed when you right-click the
custom viewpoint:

Command Description
[Rename] Displays the input field of the viewpoint name. The name will be changed
after entering a new name and pressing the [Enter] key.
[Delete] Deletes the selected custom viewpoints.

 [Add] button
Registers the viewpoint of the current graphics window as a custom viewpoint.

 [Delete] button
When clicking this button after selecting a custom viewpoint from the viewpoint list, the selected
custom viewpoint is deleted.

 [Apply] button
When clicking this button after selecting a custom viewpoint from the viewpoint list, the selected
custom viewpoint is applied to the active graphics window.
MEMO Double-clicking the custom viewpoint in the viewpoint list will also apply that custom view-
point to the active graphics window.
MEMO The custom viewpoint is applied to windows currently being displayed. Viewpoints are not
applied to minimized windows.

 [Apply All Windows] button

When clicking this button after selecting a custom viewpoint from the viewpoint list, the selected
custom viewpoint is applied for all the windows displayed in the graphics window.

 [Import] button
To use the custom viewpoint registered on another machine for the machine currently being used,
import the custom viewpoint from the viewpoint file (.xml).
MEMO When the names, positions, or directions match in the viewpoints registered in a computer in
use and viewpoints are output to the viewpoint file that is to be imported, processing will be conducted
in the following way:
• Not only when names match but also positions and directions, the corresponding viewpoints are not
imported from the viewpoint file.
• When positions and directions are matching but names are different, the corresponding viewpoints
are not imported from the viewpoint file.
• When names are matching but positions and directions are different, viewpoints of the viewpoint file
will be imported after their names have been changed.

 [Export] button
To use the registered custom viewpoint on other than the machine currently being used, export the
custom viewpoint to the viewpoint file (.xml).

52
 JMAG-Designer

Step Control
Step control becomes active when the results are displayed.
This is used for switching the steps to be displayed in the graphics window for studies or cases with
results of multiple steps. Also, for a frequency analysis, it is used for switching the phases to be dis-
played in the graphics window.

Step Control

Case Control
Case control is used to switch the cases to be displayed in the graphics window for a study with mul-
tiple cases.

Case Control

Animation Control
Animation control is used to successively draw contour plots and vector diagrams for each step for a
study or case with multiple step results.

Animation Control

Status Bar
The status bar displays the coordinates of the mouse pointer.

53
JMAG Version 22.2 User's Manual
Screen Configuration

54
Circuit Editor

The Circuit Editor ([Edit Circuit] window) is used to create electric circuits (or thermal circuits, control circuit)
used in an analysis and verify the analysis results of a circuit.
The main window of the Circuit Editor ([Edit Circuit] window) is composed of the following elements:

• Menu bar • [Toolbox]

• Tool bar • Step Control
• [Circuit Manager] • Status Bar
• Circuit Creation Window

Step Control
Menu bar Step control
Tool bar

Circuit creation
[Circuit Manager]
window [Toolbox]
Status bar

Left: During circuit creation, Right: During circuit result display

 Topics in This Chapter

• Start and Exit (page 56)
• Menu Bar (page 57)
• Tool Bar (page 59)
• [Circuit Manager] (page 65)
• Circuit Creation Window (page 65)
• [Toolbox] (page 66)
• Step Control (page 69)
• Status Bar (page 69)

55
JMAG Version 22.2 User's Manual
Screen Configuration

Start and Exit

• Starting (page 56)
• Exiting (page 56)
• Editing the Circuit (page 56)

Starting
In the [Project Manager] tree, right-click the study and select [Create Circuit].
The Circuit Editor ([Edit Circuit] window) starts up.
MEMO The [Create Circuit] command is displayed by right-clicking one of the magnetic field transient
analysis study, magnetic field frequency analysis study, trans analysis study, thermal analysis study, ther-
mal stress analysis study.
MEMO To import a created circuit file (.jcir) to a study, right-click the study, and select [Import Cir-
cuit].

Exiting
Perform one of the following procedures from the Circuit Editor ([Edit Circuit] window).
• Select [File] > [Close] from the menu bar.
• Click the upper right-hand section of the window bar.

Editing the Circuit

Right-click one of the magnetic field transient analysis study, magnetic field frequency analysis study,
trans analysis study, thermal analysis study, thermal stress analysis study in the [Project Manager] tree
of JMAG-Designer, and select [Edit Circuit].
The circuit included in the study is displayed on the Circuit Editor ([Edit Circuit] window).
MEMO The edit circuit window is locked for the study with analysis results. You can view the parame-
ters of each component but not change the components and their parameters. To change the compo-
nents and their parameters, delete or duplicate the study.

56
 Circuit Editor

Menu Bar
The Circuit Editor menu bar has the following commands:

 [File] menu
Command Description
[New Circuit] Opens a new edit circuit window. A message asking whether to save the
circuit is displayed.
[Import Circuit] Imports the circuit from the circuit information file (.jcir, .cct).
[Export Circuit] Exports the circuit as a circuit information file (.jcir, .cct).
[Export Circuit To Tool- Adds the displayed circuit to the [Circuit] folder under [Custom] dis-
box] played in the [Libraries] tab of [Tool Box].
[Export Image] Exports the circuit diagram as an image file (.png, .jpg, .bmp).
[Create Macro] Creates a new macro component. A macro component is a group of
multiple circuit components including the wires, grouped together as
one component.
The created macro component is added to the sub-folder ([Macro
Components]) of the [Custom] folder displayed in the [Libraries] tab of
the [Toolbox].
[Close] Exits the edit circuit window.

 [Edit] menu
Command Description
[Undo] Cancels the last operation.
[Redo] Reverses the canceled operation.

 [View] menu
Command Description
[Toolbars] Each toolbar such as [Treeview] can be displayed or hidden.
[Treeview Control] Expands or collapses the [File Tree] hierarchy at once. The two following
items can be specified.
• [Expand All]:
Expands the entire tree hierarchy.
• [Collapse All]:
Collapses the entire tree hierarchy.
[Show Grid] Toggles the grid as shown/hidden in the circuit creation window.
[Fit to Window] Displays the entire circuit.
[Zoom In] Enlarges the view of a circuit.
[Zoom Out] Reduces the view of a circuit.

 [Help] menu
Command Description
[Help] Opens the JMAG-Designer Help. A description regarding circuits is
also included.

57
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[About] Displays the version information about JMAG-Designer. The displayed
contents are the same as when selecting the same menu in JMAG-
Designer.

58
 Circuit Editor

Tool Bar
The toolbars of Circuit Editor contain the following buttons:

 [Tools] toolbar
Icon Name Description
[New Circuit] Opens a new edit circuit window. A message asking whether to save
the circuit is displayed.
[Import Circuit] Imports a circuit saved in a circuit information file (.jcir, .cct).
[Undo] Cancels the last operation.
[Redo] Reverses the canceled operation.
[Rotate Right 90 Rotates the selected component or wire by 90 degrees to the right.
Degrees] The object is rotated 90 degrees clockwise for every click.
[Rotate Left 90 Rotates the selected component or wire by 90 degrees to the left.
Degrees] The object is rotated 90 degrees counterclockwise for every click.
[Fit to Window] Displays the entire circuit.
[Select] Selects a component in the edit circuit window.
To select multiple components, click each component while holding
down the [Shift] key. Multiple components can also be selected by
pressing and dragging the mouse over the multiple components.
To clear the selection, click anywhere other than the selected com-
ponents.
To clear the selection individually, click the component while hold-
ing down the [Ctrl] key.
[Zoom] Zooms in and out the view of a circuit. Rotating the mouse wheel
forward reduces the view and rotating it backward magnifies the
view.
[Pan] Moves the circuit in all directions.

 [Electrical Components] toolbar

Icon Name Description
[Resistor] Adds Resistor components.
[Capacitor] Adds Capacitor components.
[Inductor] Adds Inductor components.
[Diode] Adds Diode components.
[FEM Coil] Adds FEM Coil components.
[FEM Conductor] Adds FEM Conductor components.
[Switch] Adds Switch components.
[Ground] Adds Ground components.
[Electric Potential Adds Electric Potential Source (1 Terminal) components.
Source (1 Termi-
nal)]

59
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Electric Potential Adds Electric Potential Source (2 Terminals) components.
Source (2 Termi-
nals)]
[Current Source (1 Adds Current Source (1 Terminal) components.
Terminal)]
[Current Source (2 Adds Current Source (2 Terminals) components.
Terminals)]
[Electric Potential Adds Electric Potential Probe components.
Probe]
[Current Probe] Adds Current Probe components.
[Three-phase Elec- Adds Three-phase Electric Potential Source components.
tric Potential
Source]
[Three-phase Cur- Adds Three-phase Current Source components.
rent Source]
[Multi Phase Elec- Adds Multi Phase Electric Potential Source components.
tric Potential
Source]
[Multi Phase Cur- Adds Multi Phase Current Source components.
rent Source]
[Brush/Commuta- Adds Brush/Commutator components.
tor]
[Macro] Adds macro components. A macro component is multiple compo-
nents combined into a single component, including the wiring.
[Left External Ter- Adds Left External Terminal components.
minal] When creating a macro component, this component is used to
determine the input terminal of that macro component.
[Right External Adds Right External Terminal components.
Terminal] When creating a macro component, this component is used to
determine the output terminal of that macro component.
[Reference FEM Adds Reference FEM Coil components.
Coil]
[Reference FEM Adds Reference FEM Conductor components.
Conductor]
[Power Source] Adds Power Source components.
[Three Terminal Adds Three Terminal Resistor components.
Resistor]
[Three Terminal Adds Three Terminal Coil components.
Coil]
[Coupling Con- Adds Coupling Control components.
trol]
[User Subroutine] Adds User Subroutine components.
[Voltage Differ- Adds Voltage Difference components.
ence]
[Winding Three Adds Winding Three Phase Coil components.
Phase Coil]

60
 Circuit Editor

Icon Name Description

[Winding Multi- Adds Winding Multiphase Coil components.
phase Coil]
[Winding Brush Adds Winding Brush Motor components.
Motor]
[Winding Three Adds Winding Three Phase Conductor components.
Phase Conductor]
[Winding Multi- Adds Winding Multiphase Conductor components.
phase Conductor]
[Winding Cage] Adds Winding Cage components.
[Control Voltage Adds Control Voltage Source (1 Terminal) components.
Source (1 Termi-
nal)]
[Control Voltage Adds Control Voltage Source (2 Terminals) components.
Source (2 Termi-
nals)]
[Control Current Adds Control Current Source (1 Terminal) components.
Source (1 Termi-
nal)]
[Control Current Adds Control Current Source (2 Terminals) components.
Source (2 Termi-
nals)]
[Control Current Adds Control Current Probe components.
Probe]
[Control Voltage Adds Control Voltage Probe components.
Probe]
[Control Switch] Adds Control Switch components.
[Electric FEA Adds Electric FEA Input components.
Input]
[Electric FEA Out- Adds Electric FEA Output components.
put]
[Wire] Wires between terminals of circuit components.

 [Thermal Components] toolbar

Icon Name Description
[Thermal Resistor] Adds Thermal Resistor components.

[Heat Capacity] Adds Heat Capacity components.

[Heat Generation] Adds Heat Generation components.
[Heat Transfer] Adds Heat Transfer components.
[Convection Cool- Adds Convection Cooling components.
ing]
[Fixed Tempera- Adds Fixed Temperature components.
ture]

61
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Equivalent Tem- Adds Equivalent Temperature Boundary components.
perature Bound-
ary]
[Heat Transfer Adds Heat Transfer Boundary components.
Boundary]
[Coil End Cool- Adds Coil End Cooling components.
ing]
[Thermal Probe] Adds Thermal Probe components.
[Thermal Circuit Adds Thermal Circuit Control components.
Control]

 [Control Components] toolbar

Icon Name Description
[Control Input] Adds Control Input components.
[User-Defined Cal- Adds User-Defined Calculation components.
culation]
[Control Output] Adds Control Output components.
[Control Signal Adds Control Signal Probe components.
Probe]
[Preinstall Opera- Adds Preinstall Operator components.
tor]
[JMAG-RT Adds JMAG-RT Model components.
Model]
[MUX] Adds MUX components.
[DEMUX] Adds DEMUX components.
[Control FEA Adds Control FEA Input components.
Input]
[Control FEA Adds Control FEA Output components.
Output]
[FEA] Adds FEA components.

 [Preinstall Operator] toolbar

Icon Name Description
[Add] Adds the [Add] Preinstall Operator component.
[Diff ] Adds the [Diff ] Preinstall Operator component.
[Product] Adds the [Product] Preinstall Operator component.

[Divide] Adds the [Divide] Preinstall Operator component.

[Sin] Adds the [Sin] Preinstall Operator component.

[Cos] Adds the [Cos] Preinstall Operator component.

[Atan] Adds the [Atan] Preinstall Operator component.

62
 Circuit Editor

Icon Name Description

[Sqrt] Adds the [Sqrt] Preinstall Operator component.
[Abs] Adds the [Abs] Preinstall Operator component.

[Gain] Adds the [Gain] Preinstall Operator component.

[Transfer mechani- Adds the [Transfer mechanical angle to electrical angle] Preinstall
cal angle to electri- Operator component.
cal angle]
[Transfer 2 phase Adds the [Transfer 2 phase to 3 phase] Preinstall Operator compo-
to 3 phase] nent.
[Transfer 3 phase Adds the [Transfer 3 phase to 2 phase] Preinstall Operator compo-
to 2 phase] nent.
[Switch] Adds the [Switch] Preinstall Operator component.

[Branch] Adds the [Branch] Preinstall Operator component.

[Step] Adds the [Step] Preinstall Operator component.

[Ramp] Adds the [Ramp] Preinstall Operator component.

[Triangle Wave] Adds the [Triangle Wave] Preinstall Operator component.

[Sawtooth Wave] Adds the [Sawtooth Wave] Preinstall Operator component.

[Inverse Sawtooth Adds the [Inverse Sawtooth Wave] Preinstall Operator component.
Wave]
[Zero Order Hold] Adds the [Zero Order Hold] Preinstall Operator component.

[ON/OFF Delay] Adds the [ON/OFF Delay] Preinstall Operator component.

[Saturation] Adds the [Saturation] Preinstall Operator component.

[1DTable] Adds the [1DTable] Preinstall Operator component.

[2DTable] Adds the [2DTable] Preinstall Operator component.

 [PostTools] toolbar
Icon Name Description
List for selecting This list is activated when both the electric circuit and thermal cir-
circuit cuit are used in a magnetic field analysis study or efficiency map
analysis study and the intervals of the time steps in the electric cir-
cuit and thermal circuit are not the same.
The circuit analysis results to be displayed in Circuit Editor can be
selected from this list.
• [Electrical]
• [Thermal]
Step control (page 69) refers to the time-step setting of the circuit
selected in this list.
[Display Voltage When this button is pressed, the voltage of each terminal is dis-
Value] played.
If the list in circuit selection is displayed, select [Electrical] to use
this button.

63
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Display Current When this button is pressed, the current value of each terminal is
Value] displayed.
If the list in circuit selection is displayed, select [Electrical] to use
this button.
[Display Current When this button is pressed, the scaled current vector is displayed
Vector] on the circuit component.
If the list in circuit selection is displayed, select [Electrical] to use
this button.
[Display Tempera- When this button is pressed, the temperature of each terminal is dis-
ture Value] played.
If the list in circuit selection is displayed, select [Thermal] to use this
button.
[Display Heat When this button is pressed, the heat flow of each terminal is dis-
Flow Value] played.
If the list in circuit selection is displayed, select [Thermal] to use this
button.
[Display Heat When this button is pressed, the scaled heat flow vector is displayed
Flow Vector] on the circuit component.
If the list in circuit selection is displayed, select [Thermal] to use this
button.
[Display Max/Min When this button is pressed, the maximum and minimum values of
Value] the results are displayed in the lower right corner of the window.
• When [Electrical] is selected from the list in circuit selection, the
electric current and potential are displayed.
• If [Thermal] is selected from the list of circuit selection, the tem-
perature and heat flow are displayed.

64
 Circuit Editor

[Circuit Manager]
The following tabs are displayed in [Circuit Manager]:

Tab Description
[Treeview] tab The [Treeview] tab displays components arranged on the circuit according
to type in a tree.
[Properties] tab The [Properties] tab is used to set the circuit component parameters.
Right-click the component on the circuit and select [Edit]. The [Treeview]
tab switches to the [Properties] tab, and the component property parame-
ters are displayed.

Circuit Creation Window

Place circuit components and wires and create a circuit. By hovering the mouse cursor over circuit
components displayed in the [Circuit Manager] tree, the circuit component icon is highlighted in
the circuit creation window.

 Color of circuit components, shape of terminals

Terminals of the same shape can be connected. As an exception, terminals of the Left External Ter-
minal component and Right External Terminal component can be connected to any terminal.

Component type Color Shape of terminal

Electric circuit component Black Circular
Thermal circuit component Orange Square
Control circuit component Blue Oblique square

From left, FEM Coil component, Three Terminal Resistor component, Heat Generation component,
Control Voltage Source (1 Terminal) component, User-Defined Calculation component

 Context menu
When a circuit component in the circuit creation window is right-clicked, a menu is displayed with
items relevant to the selection.

65
JMAG Version 22.2 User's Manual
Screen Configuration

[Toolbox]
The following tabs are displayed in [Toolbox]:

Tab Description
[Libraries] tab This tab displays the following items:
• JMAG provided macro components
• JMAG provided circuits
• Custom macro components:
Macro components created by the user
• Custom circuits:
Circuits registered by the user. Custom circuits include components,
component property information, and wiring.
Macro components and circuits can be added to the Circuit Editor win-
dow from this tab.

[Libraries] Tab
The micro components and circuits registered in the Circuit Editor are displayed as a tree in the
[Libraries] tab.

 [Look for] box

When part of a circuit or macro component title is entered, the corresponding macro component or
circuit is displayed. Wildcards (?, *) can be used for searching.

 Tree
Circuits and macro components registered in the Circuit Library are categorized and displayed in
several folders.

[Libraries] tab

66
 Circuit Editor

Folder Description
[Custom] folder Macro components and circuits created by the user are added to the sub-
folders of this folder.
• Macro components displayed in this folder are stored in MCCT file for-
mat in the JMAG user folder of the machine.
• Circuits displayed in this folder are stored in JCIR file format in the
JMAG user folder of the machine.
[Preinstall] folder Macro components and circuits that are initially included in JMAG-
Designer are displayed in this folder. For details on preinstalled macro
components, see “Parameter Explanation Edition”.

Descriptions displayed when hovering the mouse

Move the pointer to the macro component or circuit displayed in the tree and a description is dis-
played.

Navigating between folders

Macro components and circuits displayed in the tree can be moved to another folder using drag-
and-drop. However, you cannot move macro components to a [Circuit] folder or circuits to a
[Macro Component] folder.

Adding to the Circuit Editor window

The macro component is added to the circuit when it is selected from the tree and dragged and
dropped in the Circuit Editor window.
The circuit is replaced with a new one when you select a circuit displayed in the tree and drag and
drop it to the Circuit Editor window.

 Context menu
Right-clicking circuits or macro components can run the following commands from the menu dis-
played:

[Custom] folder and its subfolders

Command Description
[Synchronize Circuit Synchronizes each Circuit Library of JMAG-Designer when more than one
Libraries] JMAG-Designer is started.
[Rename] This command can be run for folders created by the user.
This command displays the [Rename] dialog. Enter a new name in the
[Folder Name] box and click [OK] to change the folder name.
[Delete folder] This command can be run for folders created by the user.
This command deletes the folder as well as the macro components and cir-
cuits in that folder. If there are subfolders in the selected folder, they are
also deleted.
[Create New Folder] Creates a subfolder in the selected folder.
The maximum number of hierarchies in the tree of the [Libraries] tab is 5.
[Export Circuit Libraries] Exports the selected folder as a compressed file (.zip) including the macro
components and circuits.

67
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Import Circuit Libraries] Imports macro components and circuits from the file to the selected folder.
• Macro components can be imported from compressed (.zip) or MCCT
files.
• Circuits can be imported from compressed (.zip), JCIR or CCT files.

User-registered macro component and circuit

Command Description
[Delete] Deletes the selected macro components or circuits from the Circuit
Library.
[Export Circuit Libraries] Exports the selected macro components or circuits as a compressed file
(.zip).
[Properties] Displays the [Circuit Property] dialog.
The titles and descriptions of macro components and circuits can be edited
and the saved version can be checked in this dialog.

68
 Circuit Editor

Step Control
Step control in the [PostTools] toolbar of the [Edit circuit] window is activated when the results are
displayed.
Step control is used to specify which analysis steps results to display when there is more than one
analysis step output to the result file.

If both electric circuit and thermal circuit are used in a magnetic field analysis study or efficiency
map analysis study, and the time step intervals of the electric circuit and thermal circuit are not the
same, the list for circuit selection is displayed on the [PostTools] toolbar.
The step control refers to the time step setting of the circuit selected in this list.

Status Bar
The coordinates of the cursor are displayed in the status bar.

69
JMAG Version 22.2 User's Manual
Screen Configuration

70
Graph Manager

The Graph Manager manages the table for input parameters and analysis results in the project as a “dataset”.
Existing datasets can be combined to create new datasets and displayed in a graph. Calculation processes can also
be added to datasets of analysis results.
Graph Manager is composed of the following elements:
• Dataset List • Graph List

Dataset list

Graph list

Graph Manager

 Topics in This Chapter

• Start and Exit (page 72)
• Dataset List (page 73)
• Graph List (page 76)

71
JMAG Version 22.2 User's Manual
Screen Configuration

Start and Exit

• Starting (page 72)
• Exiting (page 72)

Starting
Do one of the following procedures.
• Click [Show the Graph Manager] .
• Select [Tools] > [Graph Manager] from the menu bar.

Exiting
Do one of the following procedures.
• Click [Close].
• Click the right edge of the window bar.

72
 Graph Manager

Dataset List
The upper side of the Graph Manager is the dataset list.

 Dataset list
The datasets and tables added to the project are displayed in the dataset list. One line is one dataset
or one table.
When the column heading of the list is clicked once, the lines are sorted in ascending order based on
their name. Clicking the column heading again sorts the list in descending order. A sort mark
() is displayed on the column heading, which is the sort reference.
Contains the [Dataset Name], [X-axis], [Y-axis], [Case], and [Study] columns.

Columns Description
[Dataset Name] Displays the name of the datasets or tables.
[X-axis] and [Y-axis] Display the name of the X-axis and Y-axis for each dataset or table.
[Case] Displays the case number. “1” is usually displayed. A series of numbers
is displayed if a parametric analysis is run with multiple cases.
[Study] Displays the name of the study that is associated with the dataset and is
using the table of that dataset.
For tables that are not used in the study, the cells in the [Study] column are
empty.
If a table is used in multiple studies, the name of the study in which the
table was first set is displayed.

Context menu
The following commands can be executed from the menu that is displayed when right-clicking on
the dataset list:
• [Show Selected]
• [Add to Plots]
• [Transform] > [Fourier Transform], [Combine], [Skew Graph], [Moving Average], [Extract Fre-
quency]:
See the button descriptions below for details on these.
• [Create Dataset]
• [Delete Dataset]
• [Undo]
• [Redo]

 Filtering
Option Description
[Group By] Specifies the method to display the dataset list.
The dataset list is displayed as a table rather than a treeview if [No
Grouping] is selected. The dataset list is displayed as a treeview with the
datasets in rows for each study if [Study], etc., is selected.

73
JMAG Version 22.2 User's Manual
Screen Configuration

Option Description
[Show] Filters the rows to display in the dataset list.
[Current Study] displays only the data of the study displayed in the
graphics window.
[Current Model] displays all of the datasets for studies of the model dis-
played in the graphics window.
[Type] Select items to be displayed in the dataset list.
• [All]:
Displays a list of both dataset and tables.
• [Only DataSet]:
Displays a list of analysis result datasets and datasets created based on
analysis result datasets.
• [Only Point Sequence]:
Lists the tables created for input parameters of the analysis, such as study
properties, condition, and mesh-generating function.

 Buttons
Button Description
[Delete Unused Dataset] Deletes all datasets and tables from the project that are not used in the
study. Deleted datasets or tables cannot be restored using [Undo].
Clicking this button displays a confirmation message for deleting datasets
in the [Delete unused dataset] dialog. To execute delete, click [OK].
Tables used in an analyzed study cannot be deleted.
[Create] Creates a new data set.
Click this button to open the [Data Set Creation Wizard] dialog.
[Display] Displays the contents of the selected dataset or table in table format.
Click this button to open the [Dataset] dialog.
[Delete] Deletes the dataset or table selected from the dataset list.
• Even when a dataset is deleted from the Graph Manager, it can be sepa-
rately verified in the [Project Manager] tree.
• A table used in an executed study cannot be deleted.
[Transform]/[Fourier Performs a fast Fourier transform (FFT) on an existing dataset and creates a
Transform] new dataset.
Click this button to open the [Fourier Transform] dialog.
MEMO Fast Fourier transform can be run for graph data in the [Graph]
dialog as well. When performing a fast Fourier transform from the [Graph]
dialog, select [Calculation] > [Fourier Transform] from the menu bar of the
[Graph] dialog. The [Fourier Transform] dialog is displayed, and settings
for a Fourier transform can be performed.
[Transform]/[Combine] Combines two selected datasets (Lissajous).
Click this button with two datasets selected from the dataset list. The data-
set selected first is used as the X-axis, and the dataset selected after this is
used as the Y-axis.
Clicking this button displays the [Combine Datasets] dialog.

74
 Graph Manager

Button Description
[Transform]/[Skew Creates a graph accounting for skew effects based on a 2D analysis dataset
Graph] such as from a motor. Skew occurs when the motor stator or magnet is
tilted at an angle in the axial direction to control torque pulsation.
Clicking this button displays the [Skew Graph] dialog.
MEMO Skew graphs can be created from datasets of torque, current, elec-
tric potential, and electromagnetic force.
[Transform]/[Moving Calculates the moving average based on existing datasets, and creates a new
Average] dataset from the obtained value.
Clicking this button displays the [Moving Average] dialog.
[Transform]/[Extract Fre- Performs a fast Fourier transform (FFT) on an existing dataset, extracts the
quency] specified frequency components, and then creates a history graph. A new
dataset is created based on this graph.
Clicking this button displays the [Extract Frequency] dialog.
[Add Dataset to Graph] Adds the dataset or table selected from the dataset list to the active graph in
the graph list.

75
JMAG Version 22.2 User's Manual
Screen Configuration

Graph List
The lower side of the Graph Manager is the graph list.

 Graph list
The columns in the list consist of [Graphs], [Study], [Result], and [Case].
• The graph name is displayed in [Graphs]. The name of the dataset used in the graph is displayed
in the lower hierarchy.
• The dataset properties used in a graph are displayed in [Case], [Result], and [Study].
When the column heading of the list is clicked once, the lines are sorted in ascending order based on
their name. Clicking the column heading again sorts the list in descending order. A sort mark
() is displayed on the column heading, which is the sort reference.

Context menu
The following commands can be executed from the menu that is displayed when right-clicking on
the graph list:
• [Show Selected]
• [Create graph]
• [Delete Selected]
• [Remove Selected]
• [Undo]
• [Redo]

 Buttons
Button Description
[Create] Creates a graph from the dataset or table selected in the dataset list.
[Display] Displays a graph selected in the graph list.
Clicking this button displays the [Graph] dialog.
[Delete] Deletes the graph selected in the graph list.
[Remove Dataset from Deletes the dataset or table selected in the graph list from the graph.
Graph]

76
Script Editor

The Script Editor is used to edit and run scripts, and import and export script files.
The main window of Script Editor is composed of the following elements:
• Menu Bar • Tabs
• Toolbar • Debug Window

Script Editor

 Topics in This Chapter

• Start and Exit (page 78)
• Menu Bar (page 79)
• Tool Bar (page 81)
• Tabs (page 82)
• Debug Window (page 84)

77
JMAG Version 22.2 User's Manual
Screen Configuration

Start and Exit

• Starting (page 78)
• Exiting (page 78)

Starting
Perform one of the following operations from the main window of JMAG-Designer.
• Select [Scripts] > [Script Editor] from the menu bar.
• Right-click [Custom] displayed on the [Scripts] tab of [Toolbox] and select [Create New Script].
• Right-click the custom script displayed on the [Scripts] tab of [Toolbox] and select [Edit].
• Click [Create New Script] on the [Scripts] tab of [Toolbox].
• Right-click [Post Calculation Scripts] displayed under each study in the [Project Manager] tree
and select [Add Script].

Exiting
Perform one of the following operations in Script Editor:
• Select [File] > [Exit] from the menu bar.
• Click the right edge of the window bar.

78
 Script Editor

Menu Bar
The Script Editor menu bar has the following commands:

 [File] menu
Command Description
[New] Opens a new window to create a new script.
[Open] Opens a script file (.vbs, .py, .js).
[Save] Saves a script as a script file (.vbs, .py, .js). Saving a file for the first time
is the same as selecting [Save As] from the menu. Saving a file from the
second time overwrites the file.
[Save As] Saves the script currently being edited as a script file (.vbs, .py, .js).
[Reload] Reloads the script file (.vbs, .py, .js) for the active tab.
[Reload All] Reloads script files (.vbs, .py, .js) for all tabs.
[Print] Prints the script.
[Close] Closes the script file currently being edited.
[Exit] Closes the Script Editor.

 [Edit] menu
Command Description
[Undo] Cancels the last performed operation.
[Redo] Restores an operation that was canceled.
[Cut] Cuts a part of the selected script.
[Copy] Copies a part of the selected script.
[Paste] Pastes the cut or copied content at the mouse cursor position.
[Find] Displays a text box at the bottom of the Script Editor to search for a spe-
cific string in the script you are editing.
[Find Next] Searches forward from the current point.
[Find Previous] Searches backward from the current point.
[Replace] Displays a text box at the bottom of the Script Editor to replace a specific
string from the script you are editing.
[Go to Line] Enter the line number and move the mouse cursor to that line.
[Comment the Selected Comments out the selected rows.
Rows]
[Uncomment the Uncomments the rows currently selected. The rows no longer com-
Selected Rows] mented out are run during script execution.
[Add Script Header] Adds a defined execution string as header to the top of the script being
edited.

 [Tools] menu
Command Description
[Preferences] Opens the [Script Editor Preferences] dialog, which allows the Script Edi-
tor settings to be specified.
[Toolbar] Shows/hides the [Debug Window] and [Tools] toolbar.

79
JMAG Version 22.2 User's Manual
Screen Configuration

 [Debug] menu
Command Description
[Run] Runs the script currently being edited (the active tab).
[Step Into] Runs the script one step at a time. If a user-defined function is con-
tained in the script, the script within the function is also run by one
step at a time.
[Step Over] Runs the script one step at a time. If a user-defined variable is contained
in the script, the scripts within the function are processed collectively.
[Break] Aborts script execution.
[Stop] Stops script execution.
[Output Runtime Log] Displays history in the debug window while the script is running.

 [Help] menu
Command Description
[Help] Opens the JMAG-Designer Help. A description regarding scripts is also
included.
[About] Displays the version information about JMAG-Designer. The displayed
contents are the same as when selecting the same menu in JMAG-Designer.

80
 Script Editor

Tool Bar
The toolbars of Script Editor contain the following buttons:

 [Tools] toolbar
Icons Name Description
[New] Opens a new window to create a new script.
[Open] Opens an existing script file in the Script Editor.
[Save] Overwrites the file with the contents currently in the Script
Editor.
[Undo] Cancels the last performed operation.
[Redo] Repeats an operation that was canceled.
[Cut] Cuts a part of the selected script.
[Copy] Copies a part of the selected script.
[Paste] Cut or copied contents are pasted to the position of the cur-
sor.
[Run] Runs the script currently being edited (the active tab).
[Run in Debugger/ Step Into] Runs the script one step at a time. If a user-defined function
is contained in the script, the script within the function is
also run by one step at a time.
[Step Over] Runs the script one step at a time. If a user-defined function
is contained in the script, the scripts within the function are
processed collectively.
[Break] Aborts script execution. Clicking [Run], [Step Into], or [Step
Over] after stopping the script begins running the script
again from the line it was aborted on.
[Stop] Stops script execution. Clicking [Run] or [Run in Debugger]
after stopping a script runs the script from the first line.

81
JMAG Version 22.2 User's Manual
Screen Configuration

Tabs
Each script is displayed in a tab in the Script Editor.

 [Title]
Enter the title of the script file. The script title is displayed in the [Script] tab in the [Toolbox].

 [Script Language] list

• When importing a script file (.vbs, .py, .js), supported language types are displayed.
• When creating a new script file, a script language to be used can be selected from the [Script Lan-
guage] list. Once the script file is saved, however, the script language selected from the [Script
Language] list can no longer be changed.

 Text color
The text is highlighted in different colors depending on the type:
• Blue: Method
• Red: Constant
• Green: String enclosed with double quotation marks (" ")
• Gray: Comment

 Syntax error check

An error is automatically detected during the execution of the script, and an error message is dis-
played if an error exists in the syntax of the scripts.
IMPORTANT If two byte characters are used in the script, the characters may appear gar-
bled after a file is loaded. In this case, the language code needs to be specified as follows:
1. Start JMAG-Designer.
2. Select [Tools] > [Preferences] from the menu bar to open the [Preferences] dialog.
3. Select the language code to use from the [Default Encoding] list in the [System] settings.
4. Click [OK].
5. Start Script Editor.

 Context menu
Command Description
[Undo] Cancels the last performed operation.
[Redo] Restores an operation that was canceled.
[Cut] Cuts a part of the selected script.
[Copy] Copies a part of the selected script.
[Paste] Cut or copied script contents are pasted to the position of the cursor.
[Delete] Deletes the selected line or string.
[Select All] Selects the entire script displayed in the tab.

 Shortcut keys
• [Tab] key:
Pressing the [Tab] key on the keyboard with a line selected indents the line.

82
 Script Editor

When performing the same action with multiple lines selected, all selected lines are indented at
the front of the line.
• [Shift] key + [Tab] key:
Pressing the [Shift] and [Tab] keys on the keyboard with a line selected allows an indent to be
removed.
When performing the same action with multiple lines selected, indents at the front of the line are
removed for all selected lines. No changes are made if the line is not indented.

 Search field
Selecting [Edit] > [Find] from the Script Editor menu bar displays a text box for search, search but-
ton, and search options below the Script Editor.
A string specified in the script can be searched for using the search pane.

 Replace field
Selecting [Edit] > [Replace] from the Script Editor menu bar displays a text box for replacing a
string, a replace button, and replace options below the Script Editor.
A string specified in the script can be replaced for another string using the replace pane.

 Line and column

The position of the cursor (line and column) is displayed.

 button
Closes the script tab currently being displayed.

 [Copy To Toolbox] button

This button is displayed in Script Editor when one of the following methods is used to open the
Script Editor:
• Right-click [Post Calculation Script] under a study or analysis group in the [Project Manager]
tree and select [Add Script].
• Right-click a post calculation script added to the study or analysis group and select [Edit].
Clicking [Copy to Toolbox] will copy the post calculation script currently being displayed in Script
Editor to the [Script] tab in [Toolbox] of JMAG-Designer.
• If the post calculation script currently being displayed is a copy of the preinstalled post calcula-
tion script, it is copied to the [Post Calculation Custom] folder in the [Script] tab.
• If you created the post calculation script currently being displayed, it is copied directly under the
[Custom] folder in the [Script] tab.

 [Register] Button
Adds the script currently being displayed in Script Editor directly under the [Custom] folder in
[Script] tab of [Toolbox].

 [Close] button
Closes the script currently being displayed.

83
JMAG Version 22.2 User's Manual
Screen Configuration

Debug Window
The debug window allows histories and variables to be displayed while the script is running and
commands to be entered.

 Operation
• The debug window is displayed in the bottom of the Script Editor by selecting [Tools] > [Tool-
bars] > [Debug Window] from the Script Editor menu bar.
• To hide the debug window, click in the upper-right corner of the window.
• By clicking on the left side of the debug window, the debug window is separated from Script
Editor to become an independent window. This operation can also be performed by double-
clicking the [Debug Window] title bar.
• To return the debug window back inside the Script Editor, drag the debug window to the bottom
of the Script Editor window. When the debug window is dragged to the bottom section of the
Script Editor, a blue space is displayed; release the mouse button to complete the operation. This
operation can also be performed by double-clicking the [Debug Window] title bar.

 Log output field

When an error occurs while running a script, a [Script Output] window is displayed. The line at
which the script error occurred and the details of the error are displayed in this window.

Context menu
• [Copy]:
Copies the selected string.
• [Select All]:
Selects the entire log displayed in the debug window.
• [Clear All]:
Deletes the log displayed in the debug window.

 [Variable] tab
Variables corresponding to the following types and its value are displayed in a list.
• string: string type
• int: integer type
• double: real number type
• bool (true/false): boolean type

Notes
• Object type variables are not displayed.
• While performing debugging (step in/step out/over), the values of each variable cannot be
changed in the [Variable] tab.

 [Console] tab
Commands for each scripting language can be directly entered while debugging is being performed.
For details on commands, see reference materials for each scripting language.

84
Geometry Editor

The Geometry Editor is a specialized JMAG-Designer tool for creating geometry.

The Geometry Editor has the following functions.
• The Geometry Editor is a history based modeling tool.
• This tool can be used for 2D and 3D models.
• This tool can be used for creating solid models and mesh models.
• CAD models or mesh models imported from JCF files in JMAG-Designer can be edited in the Geometry
Editor.
• A CAD model created using CAD software from another manufacture can be edited using the Geometry
Editor.
• This function can be linked with JMAG-Express. A model data sent from JMAG-Express to JMAG-Designer
can be edited again in the Geometry Editor.
The Geometry Editor is composed of the following elements.

• Menu Bar • [Toolbox]

• Tool Bar • [Undo Stack] Box
• [Model Manager] • Status Bar
• Graphics Window

Menu Bar

Toolbar
Model Manager

Toolbox
Graphics Window

Undo Stack

Status Bar

Geometry Editor

 Topics in This Chapter

• Components of the Geometry (page 87)
• Start and Exit (page 89)
• Menu Bar (page 90)

85
JMAG Version 22.2 User's Manual
Screen Configuration

• Tool Bar (page 99)

• [Model Manager] (page 112)
• Graphics Window (page 117)
• [Toolbox] (page 119)
• [Undo Stack] Box (page 122)
• Status Bar (page 123)

86
 Geometry Editor

Components of the Geometry

The components of geometry that can be used in Geometry Editor are as follows:

Component 2D/3D Description

Assembly 2D/3D An assembly corresponds to a model in JMAG-Designer.
An assembly is composed of one or more parts or 2D sketches. An
assembly has information about the location of the parts.
Part 3D A part is composed of one or more solids, shells, or beams.
Solid 3D When a sketch with a feature set has a 3D shape, it is called a
“solid”. “Solid” is not displayed in the [Model Manager] tree.
Shell 3D When a sketch with a feature set has a 3D shape without thickness,
it is called a “shell”. “Shell” is not displayed in the [Model Manager]
tree.
Beam 2D/3D When a sketch with a feature set has a 1D shape, it is called a
“beam”. “Beam” is not displayed in the [Model Manager] tree.
Sketch 3D In the sketch, draw a cross-sectional view of the part.
2D sketch 2D • When creating a 3D model, the sketch should be created under
the part.
• When creating a 2D model, the sketch should be created under
the assembly.
Feature 2D/3D Shape characteristics that are added to regions, solids, and assem-
blies.
There are various types of features, such as the Extrude feature for
creating solids, the Extrude Surface feature for creating shells, the
Make Beam feature for creating beams, the Chamfer/Fillet feature,
and the Pattern Copy feature.
When you create a mesh, you add a mesh feature to a region. A
mesh created by adding a mesh feature to a solid or region is called a
“feature mesh”.
Coordinate system 2D/3D A 2D coordinate system for drawing. Users can define these them-
selves.
Basic shapes 2D/3D Basic shapes are the items that make up a sketch.
There are several types of basic shapes: lines, circles, arcs, ellipses,
elliptical arcs, splines, and vertices.
Region 2D/3D A region is created for a cross-sectional drawing of a part.
By creating a region on the cross-sectional drawing of a part (the
outline of the part), it becomes an object (face).
In the case of a 2D model, one region is one part.
Constraint 2D/3D Constraints are used to set limits on the length, size, and position of
basic shapes and parts.
For constraints, there is a “2D constraint,” which defines the posi-
tions of basic shapes between identical or different sketches, and a
“3D constraint,” which defines the position of parts.
Coil template 3D The coil template feature allows you to model coils by simply speci-
fying numerical parameters.

87
JMAG Version 22.2 User's Manual
Screen Configuration

Component 2D/3D Description

Wire template 2D The wire template feature allows you to model wires by simply spec-
ifying the range through which the wires will pass and numerical
parameters.
Mesh part 2D/3D A mesh part is used when creating a mesh model. A mesh part is
made up of one or more mesh blocks.
The state in which the feature mesh is separated from the solid or
region is called the “mesh part”.
You can make direct changes to the elements and nodes of the mesh
part.
Models created in JMAG-Studio are also imported as mesh parts.
Mesh block 2D/3D A mesh block is used when creating mesh models for 3D analysis or
2D analysis.
A mesh block is made up of one or more elements or beam ele-
ments.
Geometry set 2D/3D A geometry set is information of groups of regions, solids, edges,
and vertices, or definition information of directions and coordi-
nates.
This information can be used for setting conditions in JMAG-
Designer.

MEMO About JMAG-Studio

The corresponding components between JMAG-Studio and Geometry Editor are listed below.

Geometry Editor JMAG-Studio

Assembly N/A.
Geometry data in JMAG-Studio is not grouped
into a specific category.
Parts (including solids, shells, or beams) Solid, shell, and beam.
If a part is composed of multiple solids in JMAG-
Designer, each solid is managed individually in
JMAG-Studio.
2D sketch A 2D model composed of regions
Feature N/A.
A similar feature is the mesh extrusion.
Basic shapes (vertices, lines, circles, arcs, and Entities, vertices
splines)
Regions Regions
Constraints N/A
Mesh (element), mesh part, mesh block Mesh (element)
Node Node
Coil template, wire template N/A
Geometry set N/A

88
 Geometry Editor

Start and Exit

Perform one of the following operations to run Geometry Editor.
• Starting (page 89)
• Exiting, or Sifting to the Standby Mode (page 89)

Starting
The methods to start Geometry Editor are the following:
• From the JMAG-Designer menu bar, select [Tools] > [Geometry Editor].
• Click [Geometry Editor] from the toolbar in JMAG-Designer.
• In the [Project Manager] tree, right-click a project and select [Geometry Editor] > [Create
Geometry].
MEMO The number of Geometry Editor program that can be run on a machine is one, regardless of the
number of licenses that are owned.
MEMO Geometry Editor cannot start up alone, where it needs to be started using the menu in JMAG-
Designer.

Exiting, or Sifting to the Standby Mode

Perform one of the following operations to close Geometry Editor.
If following operations are performed when the hot standby option has been applied to Geometry
Editor, the Geometry Editor will not exit but will shift to the standby mode.
• From the Geometry Editor menu bar, select [File] > [Exit].
• Click in the right-hand side of the Geometry Editor window bar.

89
JMAG Version 22.2 User's Manual
Screen Configuration

Menu Bar
The menu bar provides the commands to operate the Geometry Editor.

 [File] menu
Command Description
[Back To JMAG- Return to JMAG-Designer from Geometry Editor. The Geometry Editor
Designer] window continues to be displayed.
[New] Creates a new assembly.
[Open] Opens a file created in the assembly of the Geometry Editor or another
application.
[Merge] Imports the file specified in the assembly while editing and merges them.
[Save Model] Exports an assembly created in the Geometry Editor to JMAG-Designer.
Assemblies in the process of editing can also be exported.
[Export] Saves an assembly as a new file to a new location.
[Image Setup] Specifies the size of an image file when exporting an image of the graphics
window.
[Export Image] Exports an image of the graphics window.
[Print] Prints the image of the graphics window.
[Exit] When the Geometry Editor hot standby option checkbox is checked in
JMAG-Designer, the Geometry Editor window closes and the standby state
is entered. If cleared, Geometry Editor closes.

 [Edit] menu
Command Description
[Undo] Cancels the last operation that was performed.
[Redo] Restores an operation that was canceled using [Undo].
[Cut] Cuts out a selected item (sketch or part) in the tree or the graphics win-
dow.
[Copy] Copies a selected item (sketch or part) in the tree or the graphics win-
dow.
[Paste] Pastes the item (sketch or part) that was either cut or copied from the
tree or the graphics window.
[Delete] Deletes a selected item (sketch or part) in the tree or the graphics win-
dow.

 [Insert] menu
Command Description
[Create Part], [Edit Part] Creates or edits a part or mesh part.
[Create Part] is displayed when a part or mesh part is not selected on the
[Model Manager]. [Edit Part] is displayed when it is selected.

90
 Geometry Editor

Command Description
[Create 2D Sketch], [Edit Creates or edits a 2D sketch or sketch.
2D Sketch], [Create [Create 2D Sketch] is displayed when 2D sketch is not selected on the
Sketch], [Edit Sketch] [Model Manager]. [Edit 2D Sketch] is displayed when it is selected.
When a part is in the edit mode in the [Model Manager] tree and a sketch
is not selected, [Create Sketch] is dis-played. When selected, [Edit Sketch]
is displayed.

Editing an assembly
Command Description
[Extrude Cut] Runs extrude cut or extrude split for the part.
• [Extrude Cut]
• [Extrude Split]
• [Sweep Cut]
• [Sweep Split]
[Revolve Cut] Runs revolve cut or revolve split for the part.
• [Revolve Cut]
• [Revolve Split]
[Assembly Pattern] Copies an assembly or parts.
• [Assembly Linear Pattern]
• [Assembly Circular Pattern]
• [Assembly Mirror Copy]
[Assembly Feature] Performs the following operations for an assembly or part.
• [Assembly Boolean]
• [Assembly Scale]
• [Imprint for Parts]
[Move Parts] Moves parts.
• [Translate Part]
• [Rotate Part]
[Path] Creates a path for creating sweeps.
• [Vertices Path]
• [Points Path]
• [Helix Path]
• [Spiral Path]
• [Composite Path]
[Reference Geometry] Creates a point, line, or plane at the desired location. You can add a sketch
to the created plane or copy the basic shape using the created points and
lines.
• [Reference Point]
• [Reference Line]
• [Reference Plane]

91
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Geometry Set] Groups the selected solids, regions, edges or vertices. Analysis conditions
can be set to these sets, and these sets can be used for parameter settings of
analysis conditions.
• [Solid/Region Set]
• [Face Set]
• [Edge Set]
• [Vertex Set]
Defines directions using selected edges or faces. This set can be used for
parameter settings of analysis conditions.
• [Direction Set]
Defines coordinates using selected vertices. This set can be used for param-
eter settings of analysis conditions.
• [Point Set]
[Mesh Feature] Creates mesh for a region and deletes duplicated vertices on created mesh.
• [Delete Duplicated Node Feature]
[Mesh Part Tool] Performs the following operations for a mesh part.
• [Delete Duplicated Node]
• [Element Scale]

Editing a sketch
Command Description
[Line], [Rectangle], [Cir- Draws lines, rectangles, circles, ellipses, and vertices in a sketch.
cle], [Ellipse], [Vertex]
[Create Coordinate Sys- Adds a user-defined coordinate system to a sketch. Added coordinate sys-
tem] tems can be used with drawings.
[Basic Shape Tool] Performs the following operations for the shape in a sketch.
• [Sketch Trim]
• [Break at Intersection]
• [Create Fillet]
• [Create Chamfer]
• [Connect 2 Basic Shapes]
• [Tangent Line]
• [Vertical Line]
• [Parallel Lines]
• [Joint]
• [Merge]
• [Scale Basic Shape]
• [Divide Basic Shape]
• [Delete Duplicated Node]
[Move Basic Shape] Moves basic shape in a sketch.
• [Translate Basic Shape]
• [Rotate Basic Shape]

92
 Geometry Editor

Command Description
[Copy Basic Shape] Copies basic shape in a sketch.
• [Parallel Copy Basic Shape]
• [Rotate Copy Basic Shape]
• [Mirror Copy Basic Shape]
[Sketch Tool] Performs the following operations for the sketch.
• [Project Outline to Sketch]
• [Create Constraints from Geometry]
[Sketch Option] Selects the options to be effective while editing a sketch from the following:
• [Drag Basic Geometry By Mouse]
• [Automatic Constraints]
• [Enabled Snapping]
• [Grid]
• [Vertex]
• [Perpendicularity]
• [Parallelism]
• [Horizontally/Verticality]
• [AngleOX]
[Create Region] Creates a region on an area of a basic shape that is enclosed.
[Region Pattern] Copies regions.
• [Region Linear Pattern]
• [Region Circular Pattern]
• [Region Mirror Copy]
[Region Feature] • [Boolean for Region]:
Applies Boolean operations for regions.
• [Region Fillet]/[Region Chamfer]:
Creates a fillet or chamfer for an angle formed by two edges.
• [Region Scale]:
Enlarges or reduces the region.
• [Region Move]:
Moves region to rotation direction or linear direction.
• [Region Edge Offset]/[Region Edge Move]:
Changes the region geometry by moving the region edge.
• [Convert to Fillet Feature]:
Converts the curved edge of a region to a [Region Fillet] feature. By
using the [Region Fillet] feature, the fillet radius can be changed and the
fillet can be deleted.
• [Convert to Linear Pattern Feature]/[Convert to Circular Pattern Fea-
ture]/[Convert to Mirror Copy Feature]:
Cuts out a region for one pattern from regions having periodicity or sym-
metry. A region pattern feature is then set to that one pattern region.
[Template Feature] Creates 2D geometry using a template.
• [Wire Template]
• [User Defined Region Template]

93
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Mesh Feature] Creates mesh for a region and deletes duplicated vertices on created mesh.
• [Create Region Mesh]
• [Delete Duplicated Node Feature]

Editing a part
Command Description
[Extrude] Creates a solid based on a sketch.
• [Extrude]
• [Extrude Surface]
• [Extrude Imprint]
• [Sweep]
• [Sweep Surface]
[Extrude Cut] Runs extrude cut or extrude split for a solid or part.
• [Extrude Split]
• [Extrude Cut]
[Revolve] Creates a solid with the rotation axis as the center based on a sketch.
• [Revolve]
• [Revolve Surface]
• [Sweep Cut]
• [Sweep Split]
[Revolve Cut] Runs revolve cut or revolve split for a sketch.
• [Revolve Cut]
• [Revolve Split]
[Create Beam] Creates a beam based on a sketch.
[Face Extrude] Creates a new part based on the face of the existing part.
• [Face Extrude]
• [Face Revolve]
• [Face Sweep]
• [Loft]
[Solid Pattern] Copies solids.
• [Linear Pattern]
• [Circular Pattern]
• [Mirror Copy]

94
 Geometry Editor

Command Description
[Solid Feature] • [Boolean for Region]:
Applies Boolean operations for edges.
• [Edge Fillet]/[Edge Chamfer]:
Creates a fillet or chamfer for an angle formed by two edges.
• [Solid Scale]:
Enlarges or reduces the solid.
• [Solid Move]:
Moves solid to rotation direction or linear direction.
• [Solid Face Offset]/[Solid Face Move]:
Changes the solid geometry by moving the solid face.
• [Convert to Fillet Feature]:
Converts an imported solid curve to an [Edge Fillet] feature. By using
the [Edge Fillet] feature, the fillet radius can be changed and the fillet can
be deleted.
• [Convert to Linear Pattern Feature]/[Convert to Circular Pattern Fea-
ture]/[Convert to Mirror Copy Feature]:
Cuts out a solid for one pattern from solids that have periodicity or sym-
metry. A solid pattern feature is then set to that one pattern solid.
[Template Feature] Creates 3D geometry using a template.
• [Coil Template]
• [User Defined Solid Template]
[Path] Creates a path for creating sweeps. Or creates a beam.
• [Vertices Path]
• [Points Path]
• [Helix Path]
• [Spiral Path]
• [Composite Path]
[Reference Geometry] Creates a point, line, or plane at the desired location. You can add a sketch
to the created plane or copy the basic shape using the created points and
lines.
• [Reference Point]
• [Reference Line]
• [Reference Plane]
[Mesh Feature] Deletes duplicated vertices on created mesh.
• [Delete Duplicated Node Feature]

Editing a mesh part

Command Description
[Parallel Mesh Extrude], Extrudes elements.
[Cylindrical Theta Mesh
Extrude], [Cylindrical
Radial Mesh Extrude]
[Make Beam Element] Creates beam elements from selected element edges.

95
JMAG Version 22.2 User's Manual
Screen Configuration

Command Description
[Parallel Mesh Copy], Copies mesh.
[Cylindrical Mesh
Copy], [Mirror Mesh
Copy]
[Move Node] Moves nodes.
• [By Coordinate]
• [By Parallel]
• [By Theta]
• [By Radial]
• [To Applicable Node]
[Delete Duplicated Node] Deletes duplicated nodes.
[Split Mesh Block], Splits or merges mesh blocks.
[Merge Mesh Block]
[Element Scale] Enlarges or shrinks elements by specifying a scale.
[Divide Element By Pat- Divides an element into subdivisions.
tern], [Divide Element By
Division]
[Shift Mesh] Changes the order of connections of each node in an element.

 [View] menu
Command Description
[View Solid Vertex] Highlights the vertex on the solid.
[Highlight Free Vertex] Highlights a vertex that is not connected to another vertex.
[Nodes] Highlights all the vertices (nodes) in the elements included in mesh.
[Element Incidence] Displays the arrows showing incidence of elements (connectivity).
[Highlight Mesh Bound- Highlights areas where mesh is divided due to duplicated nodes.
ary]
[ID] • [Element]:
Displays the IDs of elements in the graphics window.
• [Node]:
Displays the IDs of nodes in the graphics window.
• [Show All IDs]:
Also displays the IDs of elements and nodes that do not appear on model
surfaces.
[Viewpoint] Specifies the viewpoint of a model.
• [Front]
• [Back]
• [Top]
• [Bottom]
• [Left]
• [Right]
• [Isometric View]
• [View Control]
• [Normal View]

96
 Geometry Editor

Command Description
[View Control] Controls the display of the graphics window.
• [Fit to Window]
• [Zoom]
• [Zoom to Area]
• [Rotate]
• [Pan]
[Display Type] Controls drawing of the model.
• [Shaded]
• [Hidden Lines Removed]
• [Wireframe]
[Display Target] Selects the display target.
• [View Model/Mesh]
• [View Model]
• [View Mesh Outline]
• [View Mesh]
[Direct Access] Displays the [Direct Access] dialog.
Direct Access is a function for searching JMAG commands and functions
from the keyword entered by the user. The command you found can be
executed on the spot and the setting panel of the function you found can
be opened.
[Treeview] Modifies the display of items by expanding or collapsing in treeview simul-
taneously.
• [Expand All]
• [Collapse All]
• [Collapse Inactive]
[Toolbars] Shows and hides each toolbar.
Tool buttons can be hidden by selecting a menu and clearing the check
mark in [Toolbars]. Tool buttons can be displayed by selecting the menu
and enabling the check mark in [Toolbars].
Select [Toolbars] > [Restore Defaults] to restore show/hide of the tool bar
to default settings.
• [Model Manager]
• [Undo Stack]
• [File]
• [Edit]
• [View Control]
• [Viewpoint]
• [Display Type]
• [Select]
• [Insert]
• [Restore Defaults]

97
JMAG Version 22.2 User's Manual
Screen Configuration

 [Select] menu
Command Description
[Rectangular Region Specifies a range using a rectangle or circle to select basic shapes, parts,
Selection], [Circle Region faces inside the range.
Selection], [Polygon
Region Selection]
[At Box] By specifying an area of rectangle or box from the command, geometries,
elements, element faces, element edges, and nodes within the area can be
selected.
[At Circle] By specifying an area of circle or cylinder from the command, geometries,
elements, element faces, element edges, and nodes within the area can be
selected.
[At Coordinate] By specifying the coordinates from the command, basic shapes, parts, ele-
ments, element faces, and element edges that include specified coordinates,
or vertices and nodes in the same position of the specified coordinates can
be selected.
[Sight Through] Switches between enabling/disabling the function to select a hidden section
when parts or elements are overlapping.
[Surface Selection] Switches between enabling/disabling the function to select all element faces
and nodes on the same plane.

 [Tools] menu
Command Description
[Geometry Check] Detects areas that may cause mesh generation to fail in the model.
[Intersection Check] Detects areas where solids or regions interfere with each other in the model.
[Mesh Quality] Displays the [Mesh Quality] dialog. This dialog allows the quality of the
mesh to be evaluated based on the flatness of the elements.
[Measurement] Displays the [Measurement] dialog. In the [Measurement] dialog, point
coordinates, edge lengths, the distance between two points, distance
between two edges, distance between points and edges, and angles from
three points can be measured.
[Volume/Area Calcula- Displays the [Volume/Area Calculation] dialog. In the [Volume/Area Cal-
tion] culation] dialog, the volume of solids and elements, and the area of solid
surfaces, regions, and element faces can be calculated.
[Renumber Element ID] Renumbers element IDs.
[Renumber Node ID] Renumbers node IDs.
[Refresh View] Updates the view of the Geometry Editor.
[Preferences] Displays the [Preferences] dialog. In this dialog, each setting for the Geom-
etry Editor can be configured.

 [Help] menu
Command Description
[Help] Opens the JMAG-Designer Help.
[License Information] Displays the host name, host ID, and the license server information of the
computer running JMAG-Designer.
[About] Displays the version information of the Geometry Editor.

98
 Geometry Editor

Tool Bar
The toolbars of Geometry Editor contain the following buttons:

 [File] toolbar

Icon Name Description

[Return to JMAG- Return to JMAG-Designer from Geometry Editor. The Geometry
Designer] Editor window continues to be displayed.
[Open] Opens files created with the assembly of the Geometry Editor or
other applications.
[Save Model] Saves an assembly edited in the Geometry Editor.
[Undo] Cancels the last performed operation.
[Redo] Restores an operation that was canceled using [Undo] .

 [Edit] toolbar

Icon Name Description

[Cut] Cuts out a selected item (sketch or part) in the tree or the graphics
window.
[Copy] Copies a selected item (sketch or part) in the tree or the graphics
window.
[Paste] Pastes the item (sketch or part) that was either cut or copied in the
tree or the graphics window.
[Delete] Deletes a selected item (sketch or part) in the tree or the graphics
window.

 [Select] toolbar

Icon Name Description

[Fit to Window] Adjusts the size of the model in the graphics window so the entire
model is visible.
[Select] Switches to a mode for selecting parts, edges, faces and points.
[Zoom] Enlarges or shrinks the view of the model.
[Zoom to Area] Specifies an area of the model to enlarge in the graphics window.
[Rotate] Rotates the model.
[Pan] Pans the view of the model up and down as well as left and right.

99
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Measurement] Displays the [Measurement] dialog. In the [Measurement] dialog,
point coordinates, edge lengths, face area, the distance between two
points, distance between two edges, distance between points and
edges, and angles from three points can be measured.
[Volume/Area Cal- Displays the [Volume/Area Calculation] dialog. In the [Volume/
culation] Area Calculation] dialog, the volume of solids and elements, and the
area of solid surfaces, regions, and element faces can be calculated.
[Rectangle Region Used in the state that [Select] is selected.
Selection]
Selects basic shapes, parts, and faces using a rectangle region by left-
clicking and dragging to any location.
[Circle Region Used in the state that [Select] is selected.
Selection]
Selects basic shapes, parts, and faces using a circle region by left-
clicking and dragging to any location.
[Polygon Region Used in the state that [Select] is selected.
Selection]
Selects basic shapes, parts, and faces using a polygon by left-clicking
and creating vertices in the order of the circumferential direction,
then connecting the start point and end point.
[Sight Through] Used in the state that [Select] is selected.
Selects all of the objects within the selection range when [Sight
Through] is selected and [Rectangle Region Selection], [Circle
Region Selection], and [Polygon Region Selection] are run.
[Surface Selection] Used in the state that either [Element Face Select] or [Node
Select] is selected.
When an element face or node is selected in the state that [Surface
Selection] is selected, the element face or node considered to be on
the same surface and is selected together.

 [Viewpoint] toolbar

Icon Name Description

[Front] Displays the front (Z direction) of a model.
[Back] Displays the back (-Z direction) of a model.
[Top] Displays the top (Y direction) of a model.
[Bottom] Displays the bottom (-Y direction) of a model.
[Left] Displays the left side (X direction) of a model.
[Right] Displays the right side (-X direction) of a model.
[Isometric View] Displays the isometric angle of a model.
[View Control] Opens the [View Control] dialog to adjust the viewpoint.

100
 Geometry Editor

Icon Name Description

[Normal View] Changes the viewpoint so that the selected line and face is perpen-
dicular in relation to the screen.

 [Display Type] toolbar

Icon Name Description

[Shaded] Displays shaded parts. This is the default display.
[Hidden Lines Paints the model in the same color as the background and displays
Removed] only the lines of the parts.
[Wireframe] Displays wireframe of the parts.
[View Model/ Displays mesh for areas with generated mesh, and solids or regions
Mesh] for other areas.
[View Model] Shows the solid/region. The mesh will be hidden.
[View Mesh Out- Displays the exterior of the mesh.
line]
[View Mesh] Shows mesh. Hides the solid/region.

 [Select] toolbar

Icon Name Description

[Geometry Select] Select [Geometry Select] when selecting geometry (solid, shell,
beam).
[Basic Geometry This setting can be selected when [Edit Sketch] and [Geometry
Select Filter] Select] are selected. Enables selection of basic shape.
[Constraint Select This setting can be selected when [Edit Sketch] and [Geometry
Filter] Select] are selected. Enables selection of constraints.
[Region Select Fil- This setting can be selected when [Edit Sketch] and [Geometry
ter] Select] are selected. Enables selection of region.
[Node Select] Switches to a mode for selecting nodes.
[Element Edge Switches to a mode for selecting element edges.
Select]
[Element Face Switches to a mode for selecting element faces.
Select]
[Element Select] Switches to a mode for selecting elements.
[Mesh Block Switches to a mode for selecting mesh blocks.
Select]

101
JMAG Version 22.2 User's Manual
Screen Configuration

 [Insert] toolbar

Toolbar buttons when editing an assembly

Icon Name Description

[Edit Part] Switches to a mode for editing parts or mesh parts.
A sketch that will be the foundation of the solid can be created when
[Edit Sketch] is selected after [Edit Part] is selected.
[Edit Sketch] Switches to a mode for editing a sketch.
[Extrude Cut] Runs extrude cut for the assembly.
[Extrude Split] Runs extrude split for the assembly.
[Sweep Cut] Cuts out a solid by extending the specified sketch along the path.
[Sweep Split] Divides a solid by extending the specified sketch along the path.
[Revolve Cut] Runs revolve cut for the assembly.
[Revolve Split] Runs revolve split for the assembly.
[Assembly Linear Copies selected parts and sketches in a linear direction.
Pattern]
[Assembly Circu- Copies the selected parts and sketches in the radial direction.
lar Pattern]
[Assembly Mirror Copies the selected part or sketch symmetrically across a face.
Copy]
[Assembly Bool- Runs the Boolean operation for parts in an assembly.
ean]
[Assembly Scale] Runs a scale for parts or sketches.
[Imprint for Parts] Runs imprint for parts in the assembly.
[Translate Part] Moves parts in parallel.
[Rotate Part] Rotates parts.
[Vertices Path] Creates a path to connect the specified vertices.
[Points Path] Creates a path to connect the specified coordinates.
[Helix Path] Creates a helical path.
[Spiral Path] Creates a spiral path.

102
 Geometry Editor

Icon Name Description

[Composite Path] Combines the selected paths into one.
[Reference Point] Creates a reference point for position and direction when copying
solids.
[Reference Line] Creates a reference line for position and direction when copying sol-
ids.
[Reference Plane] Creates a reference plane for position and direction when copying
solids.
[Solid/Region Set] Groups the selected one solid or multiple solids (or regions).
[Face Set] Groups the selected one face or multiple faces.
[Edge Set] Groups the selected one edge or multiple edges.
[Vertex Set] Groups the selected one vertex or multiple vertices.
[Direction Set] Defines directions using selected edges or faces.
[Point Set] Defines coordinates using selected vertices.
[Delete Duplicate Integrates nodes in the same coordinates that occur in the process of
Nodes Feature] mesh generation into a single node.
[Delete Dupli- Can be selected when mesh parts exist in the assembly.
cated Node] Integrates nodes in the same coordinates that occur in the process of
mesh generation into a single node.
[Element Scale] Can be selected when mesh parts exist in the assembly.
Runs scale for the mesh part.

103
JMAG Version 22.2 User's Manual
Screen Configuration

Toolbar buttons when editing a sketch

Icon Name Description

[Edit Part] Switches to a mode for editing parts or mesh parts.
A sketch that will be the foundation of the solid can be created when
[Edit Sketch] is selected after [Edit Part] is selected.
[Edit Sketch] Switches to a mode for editing a sketch.
[Line] Creates a line by specifying two points.
[Spline] Creates a spline by specifying multiple points.
[Function Curve] Creates a straight line or curve defined by the equation y = f(x), or
equations x=f(t), y=g(t).
[Rectangle] Specifying two points creates a rectangle with a diagonal line deter-
mined by the two points.
[Circle] Specifying two points (center point and one point on the circumfer-
ence) creates a circle.
[Circle by 3 Points] Specifying three points (three points on the radius) creates a circle.
[Circle By Diame- Specifying two points (both ends on the diameter of the circle) cre-
ter] ates a circle.
[Circle by 2 Points Specifying three points (two points on the circumference and the
Radius] center point) creates a circle.
[Circle by 2 Lines Specifying two lines (2 lines in contact with the circle) and one
Radius] point (center point of the circle) creates a circle.

104
 Geometry Editor

Icon Name Description

[Circle By 3 Lines] Specifying three lines (3 lines in contact with the circle) creates a cir-
cle.
[Center Point Arc] Specifying three points (center point and start point/end point of
the arc) creates a circle.
[3 Point Arc] Specifying three points (start point/end point of arc, one point on
the arc) creates an arc.
[Arc by 2 Points Specifying three points (start point/end point of arc, and one point
Radius] on the arc) creates an arc.
[Ellipse] Specifying three points (center point and two points that define the
principal axis/accessory axis) creates an ellipse.
[Elliptical Arc] Specifying five points (center point of the elliptical arc, two points
that define the principal axis/accessory axis, and start point/end
point) creates an elliptical arc.
[Vertex] Specifying one point creates a vertex.
[Create Coordinate Adds a user-defined coordinate system to a sketch. Added coordi-
System] nate systems can be used for drawing.
[Sketch Trim] Cuts and deletes a line, circle, arc, or spline at the intersection clos-
est to the clicked position.
[Break at Intersec- Divides multiple overlapping lines, circles, arcs, and splines at the
tion] intersection.
[Create Fillet] A fillet is created for two basic shapes (combination of either two
lines, two arcs, or a line and an arc).
[Create Chamfer] A chamfer is created for two basic shapes (combination of either two
lines, two arcs, or a line and an arc).
[Connect 2 Basic Two basic shapes (combination of line, circle, arc, or spline) can be
Shapes] connected by extending one or both of the basic shapes.
[Tangent Line] Selects a vertex and circle (or an arc), then creates a line connecting
the two.
[Vertical Line] Selects a vertex and line, then creates a vertical line connecting the
two.
[Parallel Lines] Creates a separate parallel line based on a specified distance from the
selected line.
[Joint] Creates a line that connects the end points of the basic shape to a
closed state.
[Merge] Merges basic shapes (line, arc, circle, elliptical arc, and ellipse).
[Scale Basic Shape] Runs a scale for basic shapes.
[Divide Basic Divides selected basic shapes (lines, arcs, circles, elliptical arcs,
Shape] ellipses, splines, and function curves) according to a specified ratio.
[Delete Duplica- Merges overlapping vertices into a single vertex.
tion]
[Move Basic Translates basic shapes.
Shape]
[Rotate Basic Rotates basic shapes.
Shape]
[Parallel Copy Parallel copies one or more basic shapes.
Basic Shape]

105
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Rotate Copy Basic Rotation copies one or more basic shapes.
Shape]
[Mirror Copy Mirror copies one or more basic shapes.
Basic Shape]
[Project Outline to When 3D CAD models such as ACIS files created with other CAD
Sketch] software are imported to the Geometry Editor, the geometry of the
model cannot be modified because the dimensions of the model are
not imported.
In project outline to sketch, an outline of the selected solid is
reflected on the selected plane as a sketch. The original solid can be
modified by setting features such as extrude on the created sketch.
[Create Con- Sets multiple constraints simultaneously based on the geometry.
straints From
Geometry]
[Drag Basic Switches the mouse dragging functions for basic shapes on and off.
Geometry By
Mouse]
[Automatic Con- Switches the automatic constraints functions on and off.
straints]
[Enabled Snap- Switches all snap functions on and off in a single process.
ping]
[Grid] Enables the snap for the intersections of the grid when creating basic
shapes in the graphics window.
[Vertex] Enables the snap for the vertex when creating basic shapes in the
graphics window.
[Perpendicularity] Displays a navigation line to create a line perpendicular to the previ-
ous line that was created in the Geometry Editor.
[Parallelism] Enables the snap to create a line parallel to the previous line that was
created.
[Horizontally/Ver- Enables the snap to create horizontal or vertical lines.
tically]
[AngleOX] Enables the snap to create lines or arcs with specified angles.
[Create Region] Creates a region based on the basic shape.
[Region Linear Copies a selected region in the linear direction.
Pattern]
[Region Circular Copies the selected region in the radial direction.
Pattern]
[Region Mirror Creates a mirror image of the selected region.
Copy]
[Boolean for Runs Boolean operations on regions.
Regions]
[Region Fillet] Creates a fillet for an angle formed by two edges.
[Region Chamfer] Creates a chamfer for an angle formed by two edges.
[Region Scale] Runs scale for a region.
[Region Move] Translates or rotates the selected region.

106
 Geometry Editor

Icon Name Description

[Region Edge Off- By specifying the offset and moving the region edge to the normal
set] direction, the geometry of the region that contains the edge is
changed.
[Region Edge By moving the region edge linearly or radially, the geometry of the
Move] region that contains the edge is changed.
[Convert to Fillet Converts the curved edge of a region to a [Region Fillet] feature. By
Feature] using the [Region Fillet] feature, the fillet radius can be changed and
the fillet can be deleted.
[Convert to Linear Cuts out a region for one pattern from regions having periodicity in
Pattern Feature] the linear direction. Sets the [Region Linear Pattern] feature to that
one pattern region.
[Convert to Circu- Cuts out a region for one pattern from regions having periodicity in
lar Pattern Feature] the circular direction. Sets the [Region Circular Pattern] feature to
that one pattern region.
[Convert to Mir- Cuts out one side of a symmetric region. Sets the [Region Mirror
ror Copy Feature] Copy] feature to that region.
[Wire Template] Creates a detailed 2D model of each individual wire of a coil using
the template.
[User Defined Creates a user original region template using a program written in
Region Template] Python.
[Create Region Generates mesh for the region.
Mesh]
[Delete Duplicate Integrates nodes in the same coordinates that occur in the process of
Nodes Feature] mesh generation into a single node.

107
JMAG Version 22.2 User's Manual
Screen Configuration

Toolbar buttons when editing a part

Icon Name Description

[Edit Part] Switches to a mode for editing parts or mesh parts.
A sketch that will be the foundation of the solid can be created when
[Edit Sketch] is selected after [Edit Part] is selected.
[Edit Sketch] Switches to a mode for editing a sketch.
[Extrude] Runs extrude for a sketch.
[Extrude Surface] Runs extrude surface for a sketch.
[Extrude Imprint] Runs extrude imprint for a sketch.
[Sweep] Creates a solid that connects the specified sketches.
[Sweep Surface] Creates a shell by stretching the specified sketch along the path.
[Extrude Cut] Runs extrude cut using a sketch.
[Extrude Split] Runs extrude split using a sketch.
[Sweep Cut] Cuts out a solid by extending the specified sketch along the path.
[Sweep Split] Divides a solid by extending the specified sketch along the path.
[Revolve] Runs revolve for a sketch.
[Revolve Surface] Runs revolve surface for a sketch.
[Revolve Cut] Runs revolve cut using a sketch.
[Revolve Split] Runs revolve split using a sketch.
[Create Beam] Handles the selected line, arc, circle and spline as a beam.
[Face Extrude] Runs extrude for the face of a solid in the normal direction, creating
a new solid.
[Face Revolve] Runs revolve for the face of a solid in the circumferential direction,
creating a new solid.

108
 Geometry Editor

Icon Name Description

[Face Sweep] Runs extrude for the face of a solid based on the path, creating a new
solid.
[Loft] Creates a solid connecting faces of a solid (or regions, or faces of a
solid and a region).
It is also possible to create solids connecting multiple faces, regions,
and vertices.
[Coil Template] Creates 3D coil geometry by entering value parameters from the coil
template.
[User Defined Creates a user original solid (or shell, beam) template using a pro-
Solid Template] gram written in Python.
[Solid Linear Pat- Copies a selected solid in the linear direction.
tern]
[Solid Circular Pat- Copies the selected solid in the radial direction.
tern]
[Solid Mirror Creates a mirror image of the selected solid.
Copy]
[Boolean for Solid] Runs Boolean operation for overlapping solids.
[Imprint for Solid] Imprints the area where solids (or solid and shell, solid and beam)
are in contact or adjacent to one another in the part.
[Edge Fillet] Creates a fillet for the edges of a solid.
[Edge Chamfer] Creates a chamfer for the edges of a solid.
[Solid Scale] Runs scale for solids.
[Solid Move] Translates or rotates the selected solid.
[Solid Face Offset] By moving the solid face linearly or radially, the geometry of the
solid that contains the face is changed.
[Solid Face Move] By specifying the displacement and moving the solid face linearly or
radially, the geometry of the solid that contains the face is changed.
[Convert to Fillet Converts an imported solid curve to an [Edge Fillet] feature. By
Feature] using the [Edge Fillet] feature, the fillet radius can be changed and
the fillet can be deleted.
[Convert to Linear Cuts out a solid for one pattern from solids that have periodicity in
Pattern Feature] the linear direction. Sets the [Solid Linear Pattern] feature for that
one pattern solid.
[Convert to Circu- Cuts out a solid for one pattern from solids that have periodicity in
lar Pattern Feature] the circular direction. Sets the [Solid Circular Pattern] feature for
that one pattern solid.
[Convert to Mir- Cuts out one side from a solid that has plane symmetry. Sets the
ror Copy Feature] [Region Mirror Copy] feature for that one side of solid.
[Vertices Path] Creates a path or beam to connect the specified vertices.
[Points Path] Creates a path or beam to connect the specified coordinates.
[Helix Path] Creates a helical path or beam.
[Spiral Path] Creates a spiral path or beam.
[Composite Path] Combines the selected paths or beams into one.

109
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Name Description

[Reference Point] Creates a reference point for position and direction when copying a
solid.
[Reference Line] Creates a reference line for position and direction when copying a
solid.
[Reference Plane] Creates a reference plane for position and direction when copying a
solid.
[Delete Duplicate Integrates nodes in the same coordinates that occur in the process of
Nodes Feature] mesh generation into a single node.

Toolbar buttons when editing a mesh part

Icon Name Description

[Edit Part] Switches to a mode for editing parts or mesh parts.
A sketch that will be the foundation of the solid can be created when
[Edit Sketch] is selected after [Edit Part] is selected.
[Parallel Mesh Extrudes in the parallel direction for elements included in the mesh
Extrude] part.
[Cylindrical Theta Extrudes in the theta direction for elements included in the mesh
Mesh Extrude] part.
[Cylindrical Radial Extrudes in the radial direction for elements included in the mesh
Mesh Extrude] part.
[Make Beam Ele- Creates beam elements from selected element edges.
ment]
[Parallel Mesh Runs parallel copy for elements included in the mesh part.
Copy]
[Rotate Mesh Runs rotation copy for elements included in the mesh part.
Copy]
[Mirror Mesh Runs mirror copy for elements included in the mesh part.
Copy]
[By Coordinate] Moves nodes included in a mesh part to the specified coordinates.
[By Parallel] Moves nodes included in a mesh part by the specified distance in
parallel to the specified direction.
[By Theta] Rotates nodes included in a mesh part at a specified angle in the
specified circumferential direction with the specified axis in the cen-
ter.
[By Radial] Moves nodes included in a mesh part by the specified distance in the
specified radial direction with the specified axis in the center.
[To Applicable Moves nodes included in a mesh part to the same position as the
Node] specified node.

110
 Geometry Editor

Icon Name Description

[Delete Dupli- Integrates nodes in the same coordinates that occur in the process of
cated Node] mesh generation into a single node.
[Split Mesh Block] Splits mesh blocks of a mesh part.
[Merge Mesh Merges mesh blocks of a mesh part.
Block]
[Element Scale] Runs scale for a mesh part.
[Divide Element Divides an element into subdivisions by specifying the division pat-
By Pattern] tern.
[Divide Element Divides an element into subdivisions by specifying the number of
By Division] divisions in each edge of an element.
[Shift Element] Modifies the direction of incidence (connectivity) of each element
included in a mesh part.

111
JMAG Version 22.2 User's Manual
Screen Configuration

[Model Manager]
[Model Manager] can be used to verify the structure of the assembly currently displayed in the
Geometry Editor and perform operations for an assembly and its components (sketches, parts).
In the [Treeview] tab, components of an assembly are displayed by their hierarchical structure. The
[Control] tab is used when setting the parameters for each component of the assembly.

[Treeview] Tab
Components of an assembly are managed in the [Treeview] tab.

Left: 2D analysis model, right: 3D analysis model

In the [Treeview] tree inside the [Model Manager] (hereafter referred to as the [Model Manager]
tree), assembly, parts, solids, sketches, basic shapes, features, constraints, and regions are displayed in
the hierarchy.
From the tree, operations such as selecting each item displayed in the tree, and setting properties or
suppression can be performed.

 Notes
• The Geometry Editor is a history-based geometry modeling tool which has task-history informa-
tion for each model. The task-history is displayed in order on the [Treeview] tab and earlier oper-
ations will be displayed in top-to-bottom order (e.g. the image below shows the operations were
run in the order of coil, magnet, and rotor).

The task-history also affects the display of the graphics window. For example “coil” is displayed
in the graphics window while “rotor” is not, when “magnet” is edited as in the image above.
This is because “coil” is created before “magnet,” and “rotor” is created after “magnet.

112
 Geometry Editor

 Components of the tree

Component Icon Description
Assembly Geometry Editor manages sketches, basic shapes, fea-
tures, parts and mesh parts under “Assembly”.
Reference geometry etc. A plane (or axis or point) used as a motion direction
or axis when using features for copying or moving.
In addition to the XY plane, YZ plane, and ZX plane
displayed on the tree by default, others can also be
added arbitrarily.
Path etc. A path is used when creating sweeps.
Part, mesh part A 3D part.
: during edit state Or a mesh part created from meshes contained in a
part.
Solid etc. A 3D shape that makes up a 3D part.
A 3D shape is generated by setting up a 3D modeling
feature in the sketch.
Features to make into 3D include extrude, extrude
cut, and beam. The solid icon is also a feature icon to
make into 3D.
Sketch A 2D part.
: during edit state Or a draft drawing when creating a 3D shape.
Basic shape etc. A basic shape is a vertex, line, circle, arc, ellipse, ellip-
tical arc, and spline.
The basic shapes displayed in the [Model Manager]
tree can be classified and displayed by type. Right-
click [Basic Shape] in the [Model Manager] tree and
select [View by Type].
Constraint etc. Constraints given to the dimensions and positions of
shapes, such as vertical and horizontal.
Constraints displayed in [Model Manager] tree can be
classified and displayed by type. Right-click [Con-
straint] in the [Model Manager] tree and select [View
by Type].
Region A face enclosed with basic shapes.
Feature etc. An option applied to a region or solid, such as pattern
copy, chamfer, fillet, scale, boolean, wire template,
and coil template.
Mesh block A mesh block included in the mesh part.

: including non
visible elements

113
JMAG Version 22.2 User's Manual
Screen Configuration

 Selecting the components in the [Model Manager] tree

Parts and sketches can be selected not only from the graphics window, but also from the [Model
Manager] tree.
For example, for a model with multiple parts combined in a complex manner, it is sometimes diffi-
cult to select specific parts in the graphics window. In times like these, select a part in the [Model
Manager] tree.
Parts for [Assembly Boolean] and [Imprints for Parts] can also be selected in the [Model Manager]
tree by clicking the [Treeview] tab when the [Control] tab is displayed. As shown in the image
below, the [Treeview] tab is displayed the upper section, and the [Control] tab is displayed in the
lower section. When a part is clicked in the upper part of the tree, that part is added to the [Part] list
in the lower section.

[Control] Tab
The settings for basic shapes and features are displayed in the [Control] tab of [Model Manager].
The [Control] tab automatically switches to the editor when basic shapes and features are created or
edited.
The following figure shows the [Line] settings displayed in the [Control] tab.

114
 Geometry Editor

[Line] settings in the [Control] tab

Selected line

MEMO Clicking the [Treeview] tab with the [Control] tab displayed allows the [Treeview] tab and
[Control] tab to be vertically arranged in the [Model Manager].

 Difference between [OK] button and [Apply] button

The [OK] button or the [Apply] button is displayed in the basic shape or feature setting panel. Both
buttons reflect the contents of the setting panel to the geometry, but the behavior of the Geometry
Editor after clicking differs.

[OK] button and [Apply] button

[OK] button
The [OK] button is displayed for the following functions:
• Basic shape creation
• Features for assemblies, sketches, or parts (geometry properties)

After the [OK] button is clicked, the setting panel closes and the settings are applied at the same
time.

• When the setting panel is displayed, [Undo] in the [File] toolbar cannot be used to return the
settings to the state prior to being reflected.
• For a feature, even after the assembly is closed and reopened, the settings can be returned to the
state prior to being reflected by removing the feature.

[Apply] button
The [Apply] button is displayed for the following functions:
• Basic shape processing such as break at intersection, basic shape scale

115
JMAG Version 22.2 User's Manual
Screen Configuration

• Create region
• Mesh part processing such as mesh copy, moving nodes

When the [Apply] button is clicked, the settings are reflected, but the setting panel does not close.
• The same settings can be continually performed while changing the target. For example, after
selecting a basic shape and creating a region, another basic shape can be selected and a region can
be created.
• When the setting panel is displayed, [Undo] in the [File] toolbar can be used to return the
settings to the state prior to being reflected.
• For functions displaying the [Apply] button, even if [Undo] is used, settings cannot be
returned to the state prior to being reflected after the assembly is closed.
• When the [Apply] button is unavailable on a setting panel (such as the [Create Region] setting
panel, for example), press the Enter key on the keyboard to display the [Close by Enter Key] dia-
log.
• When clicking [OK] with [Do not show this dialog in the future] selected:
The currently opened setting panel is closed.
From now on, pressing the Enter key on the keyboard when the [Apply] button is unavailable
on a newly opened setting panel will close that setting panel.
• When clicking [Cancel] with [Do not show this dialog in the future] selected:
The currently opened setting panel does not close, and is instead closed by returning to its
currently open state and pressing the Enter key on the keyboard again when the [Apply] but-
ton is unavailable.
From now on, pressing the Enter key on the keyboard when the [Apply] button is unavailable
on a newly opened setting panel will close that setting panel.
• When clicking [OK] with [Do not show this dialog in the future] cleared:
The currently opened setting panel is closed.
Newly opening a setting panel and pressing the Enter key on the keyboard when the [Apply]
button is unavailable will display the [Close by Enter Key] dialog again.
• When clicking [Cancel] with [Do not show this dialog in the future] cleared:
The currently opened setting panel does not close.
Returning to the currently opened setting panel and pressing the Enter key on the keyboard
again when the [Apply] button is unavailable will once again display the [Close by Enter Key]
dialog.

MEMO When [Do not show this dialog in the future] is selected, the [Close by Enter Key] dialog is
added to the [Dialogs] setting panel list in the [System Options] tab of the [Preferences] dialog. The
[Close by Enter Key] dialog can be displayed again by removing the [Confirmation to Close by Enter
Key] dialog from the [Dialogs] setting panel list.

116
 Geometry Editor

Graphics Window
The graphics window displays the model. Results of operations that are performed using the buttons
in the toolbar, commands, and Model Manager are displayed.

 Origin, XY plane/YZ plane/ZX plane

• When editing an assembly , the origin position and direction of each plane for the coordinate
system (global coordinate system) used in the assembly are displayed in the graphics window.
• When editing a part , the origin position and direction of each plane for the local coordinate
system used in the part are displayed in the graphics window.

MEMO A red mark signifying the rotation center is displayed while the model is being rotated.

 Coordinate system
Depending on what is being edited, the coordinate system displayed in the left corner of the window
can have differing meanings.
• When editing an assembly , it indicates the coordinate system (global coordinate system) used
in the assembly.
• When editing a part , it indicates the local coordinate system used in the part.
• When editing a sketch , it indicates the coordinate system used in the assembly or part that
includes the sketch.
Editing a sketch also displays a separate local coordinate system used in the sketch. The short,
blue arrow is the X-axis, and the long, green arrow is the Y-axis.

Local coordinate system

Global coordinate system

Coordinate system when editing a sketch inside assembly

MEMO The coordinate system in the left side of the window can be hidden.

 Number of nodes and elements

The number of nodes and elements are displayed in the upper right corner of the graphics window
when generating mesh.

117
JMAG Version 22.2 User's Manual
Screen Configuration

MEMO The number of nodes and the number of elements can be hidden.

 Context menu
Right-clicking an item in the [Model Manager] tree or an object in the graphics window displays
commands appropriate to that item.
• Right-clicking an object, such as the edge of selected basic shape or solid displays a list of applica-
ble operations. For example, when the edge of a solid is selected and right-clicked, commands
such as [Edge Fillet] and [Edge Chamfer] are displayed in the menu.
• When the setting panel such as for a feature, is displayed in the [Control] tab of the [Model
Manager], right-clicking the graphics window displays the commands such as [OK] and [Can-
cel].
• When the setting panel such as for a feature is not displayed in the [Control] tab of [Model Man-
ager] and nothing is selected, commands appropriate to each editing mode, such as assembly
editing or sketch editing are displayed.

118
 Geometry Editor

[Toolbox]
[Toolbox] is composed of the [Geometry Library] tab.
MEMO The [Toolbox] can be switched between show/hide.
To temporarily change the [Toolbox] to be shown/hidden, click or in the lower left corner of the
[Toolbox].
To keep the [Toolbox] hidden, select [View] > [Toolbars] from the menu bar, and then clear [Tools].
Select the checkbox to display the [Toolbox] box again.

[Geometry Library] Tab

In the [Geometry Library] tab, a list of geometries registered in the library in the tree format. Geom-
etries registered in the geometry library can be inserted to the assembly.

[Geometry Library] Tab

 [Look For]
Entering part of the folder name (or geometry name, tag name) in the [Look For] box will display
the target folder or geometry.
• When performing an AND search, use half spaces as delimiters.
• The use of wild cards (?, *) are also supported.
• The search is not case sensitive.
• Double-byte and single-byte characters are distinguished.

 Geometry tree
Each geometries registered in the library is categorized by type.

Components
Component Description
[Custom Geometry] Displays the geometries registered by the user.

119
JMAG Version 22.2 User's Manual
Screen Configuration

Component Description
[Shared] Displays the geometries with shared folder. Shared folder can be set in the
[Preferences] dialog of Geometry Editor.
[Motor] Displays the rotor/stator geometries that are categorized by motor type and
dimensions.
• [3D Geometries] under [Stator]:
[Winding (Arbitrary)], [Winding (Distributed)]
• [2D Geometries] under [Stator]:
[Winding (Arbitrary)], [Winding (Concentrated)], [Permanent Magnet]
• [3D Geometries] under [Rotor]:
[Permanent Magnet], [Squirrel-Cage], [Inductor]
• [2D Geometries] under [Rotor]:
[Permanent Magnet], [Squirrel-Cage], [Salient Pole], [Winding], [Com-
mutator]
[Simple Geometries] Displays the geometries that are registered since JMAG-Designer Version
17.0.
• [3D Geometry]:
[Box], [Sphere], [Cone], [Cylinder], [Pyramid], [Prism], [Torus],
[Helix], [Shell], and [Beam]
• [2D Geometry]:
[Square], [Polygon], [Circle], and [Ellipse]

 Context menu
The following commands can be performed from a menu displayed by right-clicking geometry or
folder.

[Custom Geometry] Folder

Command Description
[Create New Folder] This creates a new folder in the [Custom Geometry] folder.
[Export Library] This exports the [Custom Geometry] folder and its sub folders as the
geometry library.
[Import Library] This imports the specified folder as the geometry library to the [Custom
Geometry] folder.
[Rename Folder] This command can be selected for subfolders of the [Custom Geome-
try] folder.
This changes the name of the currently selected folder.
[Delete] This command can be selected for subfolders of the [Custom Geome-
try] folder.
This command deletes the selected folder and geometries in that folder.
If there is a subfolder in that folder, that will also be deleted.

[Shared] folder, [Motor] folder and its sub folder, [Simple Geometries] and its sub folder
There is no context menu in these folders.

Individual geometry data

Command Description
[Insert] This inserts the selected geometry to assembly.

120
 Geometry Editor

Command Description
[Delete] This command is displayed only for custom geometries.
This deletes the selected geometry.
[Properties] This command is displayed only for custom geometry.
This command displays the [Properties] dialog. The geometry name
can be changed and tags can be added to a geometry in this dialog.
[Export Library] This command is displayed only for custom geometries.
This command exports the selected geometry as the geometry library.

 [Insert]
This inserts the selected geometry to assembly. You cannot select multiple geometries and add them
all at once.

121
JMAG Version 22.2 User's Manual
Screen Configuration

[Undo Stack] Box

Displays the operation history in the Geometry Editor. Click the displayed history to revert back to
that point. When a new operation is performed at the point of a reverted state, the history after this
point is discarded, and new operation history is recorded.

[Undo Stack] Box

MEMO The maximum number of history steps that can be recorded as operations in the Geometry Edi-
tor is the value set as the [Maximum Undo Level] in JMAG-Designer.
MEMO The [Undo Stack] box can be switched between show/hide.
To temporarily change the [Undo Stack] box to be shown/hidden, click or in the top right corner
of the [Undo Stack] box.
To keep the [Undo Stack] box hidden, select [View] > [Toolbars] from the menu bar, and then clear
[Undo Stack]. Select the checkbox to display the [Undo Stack] box again.

122
 Geometry Editor

Status Bar
The status of the assembly and the coordinates of the cursor are displayed in the status bar. From the
status bar, it is also possible to confirm the viewpoint transitions and error messages.

 [Coordinates]
The coordinate of the cursor in the graphics window is displayed.
The coordinates of vertices or nodes are displayed when selected.
The coordinates (X, Y, Z) for the local coordinate system are displayed in the status bar when [Edit
Sketch] is selected.

 [Home View]
If [Home View] is clicked, the viewpoint changes to the same viewpoint as when the assembly
was opened.

 [Undo View], [Redo View]

To undo a change in the viewpoint, click [Undo View] . To redo change in the viewpoint, click
[Redo View] .

 [Messages]
Displays the list of messages. Click the messages to display the details. The [Messages] button is not
available when there is no error or warning in the geometry.

123
JMAG Version 22.2 User's Manual
Screen Configuration

124
Transformer Modeling Tool

The transformer modeling tool is a tool for creating a three dimensional transformer model.
The transformer modeling tool is composed of the following elements.

• Menu Bar • [Bobbin] Tab

• [Core] Tab • [Coil] Tab

 Topics in This Chapter

• Start and Exit (page 126)
• Menu Bar (page 126)
• [Core] Tab (page 127)
• [Bobbin] Tab (page 127)
• [Coil] Tab (page 128)

125
JMAG Version 22.2 User's Manual
Screen Configuration

Start and Exit

• Starting (page 126)
• Exiting (page 126)

Starting
Transformer Model Tool can be launched from the JMAG-Designer [Project Manager] tree.
• In the [Project Manager] tree, right-click a project and select [Transformer Model] > [Create].
MEMO The number of transformer modeling tool program that can be run on a machine is one, regard-
less of the number of licenses that are owned.
MEMO Transformer Model Tool cannot start up alone.

Exiting
Perform one of the following operations in Transformer Model Tool.
• Select [File] > [Exit] from the menu bar.
• Click displayed in the upper-right corner of the window.

Menu Bar
The following commands are prepared in the Transformer Modeling Tool menu bar.

 [File] menu
Command Description
[Exit] Exits Transformer Modeling Tool.

126
 Transformer Modeling Tool

[Core] Tab
On the [Core] tab, set the core dimension. A core can be created in the [Core] tab using one of the
following methods:
• Use the core database:
Select from a database of existing cores provided by core manufacturers.
• Create a core using the geometry database:
Create a core based on the core templates provided in the Transformer Modeling tool by setting
a few CAD parameters.
• Import CAD data:
Import CAD data created by the user.

[Bobbin] Tab
On the [Bobbin] tab, set the bobbin dimension. Select the bobbin type to be created (track, disk,
rectangle, rounded rectangle) and then specify its dimensions.

127
JMAG Version 22.2 User's Manual
Screen Configuration

[Coil] Tab
On the [Coil] tab, create the space for coil and insulation layer. Furthermore, the space for winding
coils can be created separately for the primary and secondary coil.
MEMO The wire settings are set by the coil space in the trans analysis study.

128
JMAG-Scheduler

JMAG-Scheduler is a tool for running and managing analyses in JMAG. JMAG-Scheduler can be used when
running an analysis in the following ways:
• Run an analysis without launching JMAG-Designer
• Run an analysis continuously
• Run an analysis using remote machines:
By using JMAG-RemoteSystem or SSH (Secure Shell), analysis can be run on another machine.
• Run a direct coupled analysis:
Analysis using multiple solvers can be performed.
• Run a direct coupled analysis with JMAG and Abaqus.
The JMAG-Scheduler main window is composed of the following elements:

• Menu Bar • Job List:

• Tool Bar A “Job” is a command to run an analysis that is
exchanged between machines.
• Job Information

Menu Bar Job list

Toolbar

Job information

JMAG-Scheduler

 Topics in This Chapter

• Start and Exit (page 131)
• Menu Bar (page 132)
• Tool Bar (page 134)

129
JMAG Version 22.2 User's Manual
Screen Configuration

• Job List (page 135)

• Job Information (page 138)

130
 JMAG-Scheduler

Start and Exit

• Launching (page 131)
• Exiting (page 131)
• Showing and Hiding the JMAG-Scheduler Window (page 131)

Launching

 Launching from the JMAG-Designer [Project Manager] tree

1. In the [Project Manager] tree, right-click a study.

2. Select [Submit Active Case to Queue] or [Submit All Cases to Queue].
The input file name and analysis (study) type are displayed in the [Submit Job] dialog.
3. Set the parameters of the dialog and click [Submit Job].

 Launching from Windows Start Menu

Windows 10

1. Click the Start icon in Windows.

2. Click [All Apps].
3. In the [Apps] screen, click the JMAG-Scheduler icon.

Exiting
Perform one of the following operations in JMAG-Scheduler.
• From the menu bar, select [File] > [Exit].
• Click [Exit] on the toolbar.
• Click displayed in the upper-right corner of the window.
MEMO When this operation is performed while running a job on the local machine using JMAG-
Scheduler, a message dialog is displayed asking whether or not to run it. To exit, click [Yes].

Showing and Hiding the JMAG-Scheduler Window

Once JMAG-Scheduler is run, it will stay on the task bar even if the window is closed. The JMAG-
Scheduler window can be hidden when performing a long calculation.

 Hiding the window

Perform the following operations from the JMAG-Scheduler.
• From the menu bar, select [File] > [Close].

 Displaying the window again

• On the Windows task bar, double-click the JMAG-Scheduler icon .

131
JMAG Version 22.2 User's Manual
Screen Configuration

Menu Bar
The following commands are prepared in the JMAG-Scheduler menu bar.

 [File] menu
Command Description
[Close] Closes the main window of JMAG-Scheduler. Job management and execu-
tion will continue. To redisplay the main window, double-click the JMAG-
Scheduler icon displayed on the Windows task bar.
[Exit] Exits JMAG-Scheduler. Selecting this command, while a job is running on
the local machine using JMAG-Scheduler, displays a message dialog asking
whether or not to run it. To exit, click [Yes].

 [View] menu
Command Description
[Toolbars] Toggles between display/hide the toolbar.
[Treeview Control] Changes the expanded or collapsed state of the hierarchy display of the
[Treeview] tab or each tab in [Toolbox] of [Project Manager] at once. The
following can be specified.
• [Expand All]:
Works in the same way as clicking on all displayed in the [Treeview]
tab. Materials under each item of [Parts] are also displayed.
• [Collapse All]:
Works in the same way as clicking on all except the topmost . Usu-
ally, only projects and models are displayed.
[Hide Finished Jobs] The check mark displayed to the left of this item indicates that jobs that
have already been finished will not be displayed in the JMAG-Scheduler
job list.

 [Job] menu
Command Description
[Add Job] Adds a job to JMAG-Scheduler.
[Resubmit Job] Changes the canceled job (or job group) to “Queued”.
[Restart Job] Resumes the jobs (or job groups) which have already completed their calcu-
lations.
[Submit Queue] Changes the status of a job (or job group) from “Wait” to
“Queued”.
[Submit Queue All] Changes the status of all jobs in the job list from “Wait” to
“Queued”.
[Run as High Priority] Raises the priority of a selected local job (job executed on the local
machine) to the highest priority. The job switches from a regular job to a
priority job. The priority job is started as soon as there is space available in
the job execution space on the local machine.

132
 JMAG-Scheduler

Command Description
[Cancel Queue] Changes the status of a job (or job group) from “Queued” to
“Wait”.
[Increase Priority] Raises the priority of the selected job (or job group).
[Decrease Priority] Lowers the priority of the selected job (or job group).
[Delete Job] Removes the selected job (or job group) from the list.
[Cancel Job] Cancels the selected job (or job group).
[Export Settings] Exports job settings to a Scheduler job file (.xml) or JCoupled file (.xml).
[Change Priority Mode] Switches JMAG-Scheduler to the priority change mode. In the priority
change mode, the order of the priority of multiple jobs can be changed all
at once.
[Remove All Finished Removes all jobs that have already been completed from the JMAG-Sched-
Jobs] uler job list.
[Restart Status Updates] Re-establishes connections with remote machines and restarts status
updates for jobs displayed in the JMAG-Scheduler job list.

 [Remote] menu
Command Description
[Configure Servers] Sets the job scheduler server to be used to run jobs.
[Remote Monitoring Set- Performs settings for monitoring results when running a job (or job group)
tings] remotely.

 [Setting] menu
Command Description
[Number of Jobs] Sets the upper limit value of the number of jobs that the machine runs
simultaneously.
[Remove Finished Jobs on The check mark displayed to the left of this item indicates that when
Exit] JMAG-Scheduler is terminated, jobs that have already been completed will
be automatically deleted from the JMAG-Scheduler job list.
[Restart Updates on The check mark displayed to the left of this item indicates that when
Opening] JMAG-Scheduler starts, connections will be re-established with remote
machines, and statuses will be updated for jobs displayed in the JMAG-
Scheduler job list.

 [Help] menu
Command Description
[Help] Opens the JMAG-Designer Help. The JMAG-Designer Help also contains
a description about JMAG-Scheduler.
[About] Displays version information of JMAG-Scheduler.

133
JMAG Version 22.2 User's Manual
Screen Configuration

Tool Bar
The toolbars of JMAG-Scheduler contain the following buttons:

 [Toolbar] toolbar

Icon Status Description

[Exit] Exits JMAG-Scheduler.

[Add Job] Adds a job to JMAG-Scheduler.

[Resubmit Job] Changes the canceled job (or job group) to “Queued”.
[Submit Queue] Changes the status of a job (or job group) from “Wait”
to “Queued”.
[Submit Queue All] Changes the status of all jobs in the job list from
“Wait” to “Queued”.
[Run as High Priority] Raises the priority of a selected local job (job executed on the
local machine) to the highest priority. The job switches from
a regular job to a priority job. The priority job is started as
soon as there is space available in the job execution space on
the local machine.
[Cancel Queue] Changes the status of a job (or job group) from
“Queued” to “Wait”.
[Restart Jobs] Resumes the jobs (or job groups) which have already com-
pleted their calculations.
[Delete Job] Deletes the selected job (or job group).

[Cancel Job] Cancels the selected job (or job group).

[Remove All Finished Removes all jobs that have already been completed from the
Jobs] JMAG-Scheduler job list.
[Restart Status Updates] Re-establishes connections with remote machines and
restarts status updates for jobs displayed in the JMAG-
Scheduler job list.
[Increase Priority] Raises the priority of the selected job (or job group).

[Decrease Priority] Lowers the priority of the selected job (or job group).

134
 JMAG-Scheduler

Job List
Jobs that are added to JMAG-Scheduler are displayed in a hierarchical format in the job list.
There are two types of jobs: analysis jobs and control jobs. Control jobs are created only when an
efficiency map analysis study or optimization is performed. When multiple jobs are added all at
once, those jobs are displayed in a grouped format in the job list.
The title, status, and machine name (server name) of each job, as well as the time when each job was
added, can all be checked in the job list.
MEMO When running an efficiency map analysis study (speed-priority) using JMAG-Scheduler, infor-
mation for the calculation points of those jobs (current, speed, phase/slip frequency) is displayed in the
title of each of the load analysis jobs.

 Opening and closing the tree

• When clicking on the left side of each item in the tree, the item expands and the lower hierar-
chy is displayed. When the [>] key on the keyboard is pressed with each item selected, it is dis-
played in the same way.
• Conversely, when clicking on the left side of each item in the tree, the item being expanded is
closed and the lower hierarchy is hidden. When the [<-] key on the keyboard is pressed with an
item selected, it will be hidden in the same way.
• To open or close a tree from the menu bar, select the commands displayed after selecting [View]
> [Treeview Control]. [Expand All] and [Collapse All] can be selected.
• To open or close a tree from the context menu, press the [*] key to open all the items, or press the
[\] key to close all the items.

 Icons
Icons are displayed next to the titles of analysis jobs, control jobs, and job groups to indicate their
status. The icons for control jobs are marked with a light blue circle in the upper-right corner. The
icons for job groups have a folder displayed in the background.

Icon Status Description

Wait The job has been added to JMAG-Scheduler but has
not been added as a queued job.
A job in this state will not be started even if it is slated
to be started.

135
JMAG Version 22.2 User's Manual
Screen Configuration

Icon Status Description

Queued The job is added as a queued job.
It will be started when slated to be started. However, if
there is a priority job or a job waiting for a priority job
to complete, that job will be executed first.
Queued (Resubmitted) The job has been canceled and then re-added as a
queued job.
It will be started when slated to be started. However, if
there is a priority job or a job waiting for a priority job
to complete, that job will be executed first.
Queued for high priority run- The job is a priority job added as a queue job.
ning It will be started as soon as there is space available in
the job execution space on the local machine.
Waiting for priority job The job is waiting because a priority job interrupted.
After the priority job is started, the job starts as soon
as there is space available in the job execution space on
the local machine.
Running (generating mesh, solv- The job is running.
ing matrix, etc.)
High priority running (mesh The job is being executed as a priority job.
generation, matrix computation,
etc.)
Error The job ended with an error.

Canceled The job was canceled during execution.

Finished The job completed.

 Progress bar
The progress bar displays the amount of progress for individual jobs. For job groups, the progress
bar displays the amount of progress for the entire group.
MEMO When project files (.jproj) are grouped and executed using the Massive Job Runner function,
the progress bar displays a “(Grouped)” message in addition to the amount of job progress.

 Context menu
The following commands are displayed by selecting a job group (or job group) from the job group
and then right-clicking it.

Menu Description
[Submit Queue] Changes the status of a job (or job group) from “Wait” to “Queued”.
[Cancel Queue] Changes the status of a job (or job group) from “Queued” to “Wait”.
[Resubmit Job] Changes the status of canceled jobs (or job groups) to “Queued”.
[Cancel Job] Cancels selected jobs (or job groups).
[Delete Job] Deletes selected jobs (or job groups).
[Remove All Finished Removes all jobs that have already been completed from the JMAG-Sched-
Jobs] uler job list.

136
 JMAG-Scheduler

Menu Description
[Restart Status Updates]Re-establishes connections with remote machines and restarts status
updates for jobs displayed in the JMAG-Scheduler job list.
[Add Job to Group] Adds selected jobs a job group.
[Remove Job from Group] Removes selected jobs from a job group.

MEMO To select multiple jobs in the job list, click each job while holding down the [Ctrl] key or [Shift]
key on the keyboard. This can also be performed for selecting multiple job groups.

137
JMAG Version 22.2 User's Manual
Screen Configuration

Job Information
 [Local Simultaneous Number of Jobs]
This is displayed when batch execution is performed with a local machine.
The number of analysis jobs that are currently being run on the local machine is displayed in [Run-
ning].
In [Setting], the maximum number of analysis jobs that can be run simultaneously as specified in
the JMAG-Scheduler [Setting Number of Jobs] dialog is displayed.
When the number of analysis jobs that are currently being run has reached the value specified in the
JMAG-Scheduler [Setting Number of Jobs] dialog, the number is displayed in red, as shown below.
A message is displayed when you move the mouse pointer over the number. Check the content of
the message and change the settings if necessary.

 Job information
When a job or job group is selected from the job list, the details are displayed.

Item Description
[Title] Title of the job (or job group)
[Machine (Server)] Name of the machine running the job. When running a job remotely, the
control server name and remote machine name are displayed.
[CPU Group] The CPU group name when performing a job remotely.
[Submitted] The time a job was added to JMAG-Scheduler. For job groups, the time for
the first job added to the group.
[Finished] The time the job was completed. For job groups, the time for the last job
completed in the group.
[Elapsed] The time elapsed since the job was started for jobs currently running. This
is not displayed for job groups.
[Remaining] An estimation of the time remaining until the job is completed for jobs
currently running. This is not displayed for job groups.
[Power Simulation The power simulation license name specified when adding a job.
License]
[Reservation Key] The reservation key name specified when adding a job.
[Status] Job status. If the job completes with an error, the cause of the error is dis-
played as well.
[Disk Usage] The amount of disk space being used by the running job.

138
 JMAG-Scheduler

Item Description
[Thread Affinity] The CPU cores that will be used to execute the threads of the job (for
example, [8, 10, 12, 14]).
This message is displayed when the shared memory multiprocessing (SMP)
function is used and [Automatically Set Processor Affinity for Local Jobs] is
selected in the [Setting Number of Jobs] dialog of JMAG-Scheduler.
[Results Folder] The path of the output folder of a job's result file. This is not displayed for
job groups.
A link is provided to the path, and clicking it opens the results folder.
When right-clicking the path, the following items will be displayed.
• [Copy Link Location]:
When selecting this item, the local path is saved to the clipboard. In this
case, the local path is formed “file:///[Path displayed on the JMAG-
Scheduler]” (example: file:///D:/JMAG/Motor.jfiles/motor~1/Case2).

 [Monitor]
This displays the [Run Analysis] dialog. In a graph, you can check the results of the analysis jobs that
are currently running.

139
JMAG Version 22.2 User's Manual
Screen Configuration

140
JMAG-Express

JMAG-Express features simple procedures for creating analysis models and high-speed evaluation.
The main window of JMAG-Express (the JMAG-Express View) consists of the following elements:

• Menu • Design Table

• Workspace • Data View

Menu

Design Table

Workspace

Data View

JMAG-Express View

 Topics in This Chapter

• Start and Exit (page 142)
• Menu (page 144)
• Workspace (page 148)
• Design Table (page 149)
• Data View (page 150)

141
JMAG Version 22.2 User's Manual
Screen Configuration

Start and Exit

• Launching JMAG-Express from Windows Start Menu (page 142)
• Launching JMAG-Express from the Command Line (page 143)
• Quitting JMAG-Express (page 143)

Launching JMAG-Express from Windows Start Menu

1. Click the Start icon in Windows and click JMAG-Express in the list of applications.
The [JMAG-Express Startup] dialog is displayed.
2. To create a new project, select [Select Model/Scenario] and choose the model type,
geometry (rotor and stator), and scenario.
To open an existing project, select [Select File] and specify the JPROJ file.
3. Click [OK].
JMAG-Express starts.
When the specified JPROJ file contains multiple studies, the [Open in JMAG-Express View]
dialog will be displayed. Select one study and click [OK] to start JMAG-Express.

Launching JMAG-Express from JMAG-Designer

 Open from the [Project Manager] tree

Right-click a project, model, analysis group, or study in the [Project Manager] tree and select [Open
JMAG-Express View].
• When you right-click a study or analysis group, they will open in the JMAG-Express View.
• When you right-click a project, JMAG-Designer will behave differently depending on whether
the project contains an analysis group or a study.
• If the project contains a single study or analysis group, it will open in the JMAG-Express
View.
• If the project contains multiple studies or analysis groups, the [Open JMAG-Express View]
dialog will open. Select an analysis group or study and click OK to open the JMAG-Express
View.
• If the project does not contain any studies, the [JMAG-Express Startup] dialog will open.
• When a model is right-clicked, the behavior of JMAG-Designer will change depending on
whether the model contains a study.
• If the model contains only one study that does not belong to an analysis group, it will open in
the JMAG-Express view.
• If the model contains multiple studies that do not belong to an analysis group, the [Open
JMAG-Express View] dialog will open. Select a study and click [OK] to open the JMAG-
Express view.

 Open the current study in JMAG-Express using the shortcut icon

Click [Show JMAG-Express View] displayed at the bottom of the graphics window.

142
 JMAG-Express

Launching JMAG-Express from the Command Line

 Windows (using command)

1. Execute the command for starting JMAG-Designer with the option for starting JMAG-
Express.
If the JMAG-Designer installation folder is set to INSDIR, execute the following command:
(INSDIR=C:\Program Files\JMAG-Designer22.2, etc.).
cd $INSDIR
designer.exe --fast-response-mode

File paths with spaces need to be enclosed with double quotation marks (").
Enter the file path after the execution command when running JMAG-Express specifying a
JPROJ file. The following is an execution example:
cd "C:\Program Files\JMAG-Designer22.2"
designer.exe --fast-response-mode "D:\JMAG\2Dmotor.jproj"

 Linux (using command)

1. Execute the command for starting JMAG-Designer with the option for starting JMAG-
Express.
If the JMAG-Designer installation folder is set to INSDIR, execute the following command:
(INSDIR=/home/JMAG-Designer222, etc.)
cd $INSDIR
./designer --fast-response-mode

The path to the library and a symbolic link must be set every time the terminal is run. Therefore,
run the following commands during the first startup from the terminal. Executing the setenv
script file specifies path to the library.
cd $INSDIR
source setenv
./designer --fast-response-mode

The setenv file is a file with the setting commands for environmental variables written in a bash
shell. To set the path to the library in csh or other shells, the file where the export command is
replaced with the setenv command needs to be separately prepared.

 designer command-line options (Windows/Linux)

See “designer command-line options (Windows/Linux)” on page 12.

Quitting JMAG-Express
Perform one of the following operations from the JMAG-Express main window:
• On the [File] tab, click [Exit].
• Click displayed in the upper-right corner of the window.

143
JMAG Version 22.2 User's Manual
Screen Configuration

Menu
JMAG menu commands are grouped into four tabs ([File], [Home], [Edit], and [View]).

 [File] Tab
Command Description
[New] Displays the [JMAG-Express Startup] dialog.
From this dialog, you can create new studies or load studies from JMAG
project files into JMAG-Express.
[Open] Displays the [Open JMAG Project File] dialog.
From this dialog, you can load studies into JMAG-Express from JMAG
project files.
[Save] Saves studies displayed in JMAG-Express to a project.
[Save As] Displays the [Save As] dialog.
From this dialog, you can save the project that includes the studies dis-
played in JMAG-Express under any name to a specified folder.
[Preferences] Displays the [Preferences] dialog.
In this dialog, you can change the preferences for JMAG-Designer and
JMAG-Express.
[Version] The [Version Information] dialog displays the license number of the ver-
sion of JMAG-Designer.
[Exit] Exits JMAG-Express.

 [Home] Tab
Group Command Description
[Operation] [Undo] Cancels the operation that was just performed.
[Redo] Performs the undone operation again.

144
 JMAG-Express

Group Command Description

[Evaluate] Study name (such as Use [Run], [Submit Cases], or [Optimization], which
[Map], [Stress]) are described below, to run analysis for the studies
that have their checkboxes selected.
[Run] Runs analysis in the foreground. You cannot operate
JMAG-Express while analysis is running in the fore-
ground.
[Submit] Uses JMAG-Scheduler to run analysis in the back-
ground. If analysis is run in the background, then you
cannot operate JMAG-Express during that time.
[Optimization] Displays the [Optimization] dialog the same as
JMAG-Designer.
In this dialog, you can set the parameters for optimi-
zation calculations, such as design variables and objec-
tive functions, and you can also run the optimization
calculations.
[Check New Results] Loads result files from the calculation folder when
analysis is run in batches.
[Load Multi Case When analysis is run in the background by using a
Results] local machine or by using an SSH remote machine, a
response table containing the results of the finished
cases is loaded into JMAG-Express on the local
machine.
Loading the response table does not involve down-
loading any of the result files. The loaded response
table is displayed in the [Load Multi Case Results]
dialog.
[Apply Selected Case] A case selected in the design table is displayed on each
tab of the Workspace and on each tab of the Data
View.
[Display Selected Starts a mode where the settings and results of the case
Case] selected in the design table are displayed on each tab
of the Data View.
[Report] [Add Response Graph] Displays the [Response Graph] dialog the same as
JMAG-Designer.
In this dialog, you can create new response graphs
from the results. The created response graph is dis-
played on the [Response Graph] tab of the Data View.
[Tools] [Switch to JMAG- Starts JMAG-Designer and loads the studies displayed
Designer] in JMAG-Express.
When switching from JMAG-Express to JMAG-
Designer, the license that is currently being used will
also change from the FR license to the JMAG-
Designer license.
[Help] [Help] Opens JMAG-Designer Help.

145
JMAG Version 22.2 User's Manual
Screen Configuration

 [Edit] Tab
Group Command Description
[Design Table] [Add Case] Displays the [Submit to Queue] dialog.
In this dialog, you can add new values to parameters
that have been added as design variables. You can also
create new cases from the combinations of the values.
[Delete Selected Cases] Deletes cases selected in the design table.

[Copy] Saves cases selected in the design table to the clip-

board.
[Paste] Adds cases to the design table that have been copied
to the clipboard.
[Grouping Cases] [Group Selected Displays the [Create Case Group] dialog.
Cases] In this dialog, you can group one or more cases that
you have selected in the design table.
[Remove Cases from Removes one or more cases that you have selected in
Group] > (Group the design table from the group.
name)
[Rename Group] > Displays the [Rename Case Group] dialog.
(Group name) In this dialog, you can change the names of selected
groups.
[Remove Group] > Removes groups that you have selected.
(Group name)
[Filter] [Add / Delete] Displays the [Filter List] dialog.
In this dialog, you can create and delete filters for
cases.
[Constraint Filter] Click [No Filter Applied] or [Filter Applied] to dis-
play the list of constraint conditions that were set in
the [Optimization] dialog. Select a constraint condi-
tion to place a check mark to the left of that con-
straint condition. This will display only the cases that
meet the criteria of the constraint condition in the
design table.
[Case Group Filter] Click [No Filter Applied] or [Filter Applied] to dis-
play a list of case groups. Select a case group to place a
check mark to the left of that case group. This will
display only the cases that are included in the case
group in the design table.
[Custom Filter] Click [No Filter Applied] or [Filter Applied] to dis-
play user-created filters in the list. Select a custom fil-
ter to place a check mark to the left of that custom
filter. This will display only the cases that meet the
criteria of the filter in the design table.

146
 JMAG-Express

 [View] Tab
Group Command Description
[Display] [Fit] Zooms in/out so that the entire model or circuit is
displayed at a suitable size.
[Zoom] Switches to a mode for zooming in/out.
[Zoom to Area] Switches to a mode for zooming in on a particular
area.
[Pans] Switches to a mode that pans the display up, down,
left, or right.
[Window] [Open Data View in Opens a window and displays the items that are
Another Window] shown in each tab of the Data View (such as the
model and the circuit) in that window.
[Design Table] [Show/Hide Columns] Displays the [Show/Hide Columns] dialog.
In this dialog, you can change the items that are dis-
played in the design table.
[Circuit] Study name (such as The circuits of the studies that have their checkboxes
[Map], [Stress]) selected are displayed on the [Circuit] tab in the Data
View.
[Result] [Display Magnifica- Displays the [Display Magnification] dialog.
tion] In this dialog, you can change the display magnifica-
tion of the [Result] tab and the [Response Graph] tab
of the Data View.

147
JMAG Version 22.2 User's Manual
Screen Configuration

Workspace
Each tab in the Workspace displays the required parameters in a tree format in accordance with the
selected scenario.

Tab Description
[Dimension] tab Displays the parameters that define the geometry and dimensions.
[Material] tab Displays the parameters that define the physical properties of the materials
used for each part.
[Winding] tab Displays the parameters that define the windings.
[Drive] tab Displays the parameters that define the drive circuit.
[Vehicle] tab This tab is displayed when the [Machine Characteristics (Efficiency Map)]
scenario for magnetic field design is selected.
This tab displays the parameters for evaluating efficiency and losses in the
drive cycle.
[Temperature] tab This tab is displayed when a thermal design scenario is selected.
This tab displays the parameters that define the physical properties of each
component in the thermal circuit.
[Structural] tab This tab is displayed when a structural design scenario is selected.
This tab displays the parameters that define the contact conditions between
the magnet and the core.

 Notes
• The number of digits to be displayed is as follows:
• [Dimension] tab: 4 decimal places (e.g., 0.1234). Fractions are rounded to the nearest whole
number. Trailing zeros are not displayed.
• Tabs other than [Dimension]: 5 decimal places (e.g., 0.12345). Fractions are rounded to the
nearest whole number. Trailing zeros are not displayed.

148
 JMAG-Express

Design Table
Cases added to a study are displayed in a table.

Input values Analysis results (response values)

Current case

• You can use this table in the same way as the table in the [Design Table] dialog in JMAG-
Designer.
• The number of digits to be displayed for input values is as follows:
5 decimal places (e.g., 0.12345). Fractions are rounded to the nearest whole number. Trailing
zeros are not displayed.
• The number of digits to be displayed for response values is as follows:
4 decimal places, scientific notation (e.g., 0.1234+05)
• Response values follow the unit system selected in the [Units] setting panel in the [Prefer-
ences] dialog. Units are displayed in the column headings of the design table along with the
names of the response values. However, the following response values do not have unit infor-
mation and therefore do not display units:
• Response values using equations created in the [Edit Equation] dialog in JMAG-Designer
• Response values created in the [Create Response Value from Script] dialog in JMAG-
Designer
• Response values created in the [Efficiency Map Response Data] dialog in JMAG-Designer
• The last row of the table (the row containing the yellow cells) is the current case. The values set
in each tab of the Workspace are reflected for the current case.
• By using each button in the [Grouping Cases] group on the [Edit] tab, you can create and
remove groups for cases.
• By using the [Filter] group on the [Edit] tab in the menu, you can create filters (selection criteria)
and apply them to the design table.
• Items that are displayed in the table can be changed by using [Show/Hide Columns] for [Design
Table] on the [View] tab.

149
JMAG Version 22.2 User's Manual
Screen Configuration

Data View
You can check the geometry, the circuit, and more, in each tab of the Data View. You can change the
size and what is displayed for the diagrams that are shown in each tab by using the buttons on the
[View] tab.

Tab Description
[Model] tab Displays the geometry to be determined from the values of each parameter
on the [Dimension] tab of the Workspace.
• When you click a CAD parameter in the [Dimension] tab of the Work-
space, the angle and length dimension line related to that CAD parame-
ter are displayed in the [Model] tab.
• When you click a material parameter in the [Material] tab of the Work-
space, the part to which that material is applied is highlighted in the
[Model] tab. When you click the magnet parameter, the magnetization
direction is shown, and when you click the steel sheet parameter, the
lamination direction is shown.
[Winding] tab Displays both the numbers of the slots that each phase coil passes through
and the connections of each phase in a diagram. Alphabetical characters
and numerical characters indicate the phase and slot number, respectively.
[Circuit] tab Displays electric and thermal circuits.
After running an evaluation, click [Display Selected Case] on the [Home]
tab of the menu to display the results of the case selected in the design table
on the circuit diagram.

150
 JMAG-Express

Tab Description
[Result] tab Displays the evaluation results for cases that meet both of the following
conditions:
• Cases that are displayed in the design table (cases that meet the filter cri-
teria)
• Cases with checkboxes selected in the [Case] column in the design table

Design table
[Graph (All Cases)] tab Displays all cases in a single graph for each physical quantity.
[Response Graph] tab Displays response graphs you have created.
You can create response graphs from [Add Response Graph] on the
[Home] tab.

151
JMAG Version 22.2 User's Manual
Screen Configuration

152
INDEX

B H

Bobbin Tab 127 History Manager Box 122

Home tab 144
C
J
Circuit Creation Window 65
Circuit creation window 65 JMAG-Scheduler 129, 141
Circuit Manager 65 Job Information 138
Circuit tab 150 Job information 138
Coil Tab 128 job information 138
Control tab 114 Job List 135
Core Tab 127 Job list 135

D L

Data view 150 Libraries tab 66

Dataset List 73
Dataset list 73
M
Debug Window 84
Debug window 84 Material tab 148
Design table 149 Menu 144
Dimension tab 148 Menu Bar 57, 79, 90, 126, 132
Drive tab 148 Menu bar 79
Model Manager 112
E Model tab 150

Edit tab 146

P

F Properties Tab 65

File tab 144

R

G Response Graph tab 151

Result tab 151
Geometry Editor 85
Graph (All Cases) tab 151
S
Graph List 76
Graph list 76 Script Editor 77
Graph Manager 71 Status Bar 123
Geometry Editor 123
Status bar 69
Step control 69

153
JMAG Version 22.2 User's Manual
Screen Configuration

Structural tab 148

Tabs 82
Temperature tab 148
Tool bar 81, 134
Toolbar 59, 81, 99
Toolbox 66
transformer modeling tool 125
Treeview Tab 65, 112
Treeview tab 24

Vehicle tab 148

View tab 147

Winding tab 148, 150

Workspace 148

154