Mech 325, Deus ex Machina.

Good Luck in MECH 325.

Video Tutorial

Installation

1. Install Local Latex Compiler.

   People had success with miktex.org, try that.

2. Install Latex Packages until latex_output/main.tex can be compiled.

3. Install Local Python Environment.

   Install from the offical website python.org and add it to path.

4. Install necessary python Packages with pip install -r requirements.txt.

5. Run git update-index --skip-worktree main.py and git update-index --skip-worktree latex_output/solution.tex. So the specific question being solved is not tracked in the repo, and update through git pull won't override them.

Using this repo

General Procedure

1. Go to examples folder, copy content of the respective file into main.py.
2. Replace the values as you see fit. For more variable names, use list_vars(context).
3. Run python main.py
4. Follow through the prompts.
5. Read the answer off from ./latex_output/aux/main.pdf.

Global Flag

To use any flags import mech325 at the beginning of the file.

mech325.show_image=False

• Disable figure pop-ups.
• The figure can be opened through the printed path in the terminal instead.

Unexpected Behaviour

If there is an issue BEFORE EXAM:

• Submit the issue as an github issue with the "context".

If there is an issue DURING EXAM:

• Save the "context" that cause the problem.
• Forfeit the program, use the bible instead.
• Submit the issue as an github issue with the saved "context".

Or, fix it yourself and open a pull request.

For those who want to help

Missing Components:

• pulley of wire rope.
• Spring Fatigue loading, sinus, zimmerli.
• (Others that I probably missed).

UX:

• Guess potential missing informaiton.
• Incorporate in units.
• Use description and units of values in a meaningful way.

Internals:

• Refactor code to deal with iteration more effectively.
• Decouple the big CUSTOM functions.

Features:

Main Task	Sub Task	Implemented	Tested	Documented
FLAT BELT	main question type	x	x	x
FLAT BELT	lower constraints
V BELT		x	x	x
SYNCHRONOUS BELT		x	x
CHAIN		x	x
WIRE ROPE
SPUR GEAR		x	x
HELICAL GEAR		x
BEVEL GEAR		x	x
WORM GEAR		x
RACK PINION
BUSHING	Shigley Selection	x	x
BUSHING
BALL AND CYLINDRICAL BEARING RADIAL	Selection	x	x
BALL AND CYLINDRICAL BEARING RADIAL	Clearance
BALL AND CYLINDRICAL BEARING ALL	Selection	x	x
BALL AND CYLINDRICAL BEARING ALL	Clearance
TAPER BEARING	Selection	x	x	x
TAPER BEARING	Clearance
SHAFT		x	x
KEY
PIN
SET SCREW
POWER SCREW		x
BALL SCREW		x	x
SPRINGS	si	x	x
SPRINGS	imperial	x
SPRINGS	Zimmerli, Sinus Failure
SPRINGS	critical frequency
BOLTS	imperial	x	x
BOLTS	si	x
BOLT JOINT		x	x