What is CuSHan
Watch the video, or scroll down for a description.
What is CuSHan?
Cushan is a short-hand notation for cubing algorithms. It uses lines to represent the turns you need to make from your point of view as you look at the cube.
Lines going up or down mean you turn the right, middle or left layers in the direction shown. For example:
Lines going left or right mean you turn the top, middle or bottom layers in the direction shown. For example:
Curved lines mean you turn the front, middle or back layers in the direction shown. For example:
The numbers and position of lines show you which layers to turn. Moves that include the right layer show only the number of lines for the layers turned, whereas moves that don't include the right layer, short place-holder lines are shown to illustrate the layers that don't move. For example:
The same goes for horizontal moves, where moves that include the top layer only have lines for the number of layers to turn. Whereas those that don't have place markers to illustrate the layers that don't move. For example:
For the front, middle and back layers, moves that include the front layer only have lines for the number of layers to turn, whereas those that don't have place markers to illustrate the layers that don't move. For example:
Sequences of moves are strung together in sections, each of which starts with a dot and ends in an arrow. For example, the following sequence:
Would be written as:
RUR'U' - 'Sexy'
As another example, the following sequence:
Would be written as:
R'FRF' - 'Sledgehammer'
Becuase of their prevelence, moves that combine the right and or top layers are transitioned with a rounded corner, whereas any other moves have an angled transition. Also, to avoid confusion, transitioning from a layer other than the top, right or front will explicitly show the layer with placeholders.
RUR'U' - 'Sexy'
RUR'URU'2R' - 'Sune'
One of the main advantages of CuSHan is that there is no doubt which way to turn the layers. As it is drawn from the point of view of you looking at the cube, you don't need to think about which way is clockwise or anti-clockwise on faces that aren't facing you. You just execute in the direction the lines are pointing.
Another advantage is that it is almost as easy to read backwards as it is forwards. You just start from the arrow end and work back to the dot, carrying out the moves as shown along the way. This is great for setting up cases to practice.
Also, if you're a visual memory person, you will probably find it seasier to memorise and visualise the algorithms in your mind than strings of characters as used in the traditional notation.
Using the Translator
You can use the Translator to translate from traditional notation to CuSHan. Just enter the algorithm into the text box and it will generate the CuSHan for you.
You can split an algorithm into multiple sections by adding a comma, which are then drawn individually from left to right. For example, RUR'U',R'FRF' (sexy sledgehammer) would produce:
You can download the CuSHan image, change the colors, or get the code to embed the algorithm on your own site by using the buttons underneath the translator.
The CuSHan API
I've made an API so you can easily integrate CuSHan into your own website. This is the same code generated in the 'Embed' option on the Translator and the text below shows you the options you can use to customize the appearance.
The example below shows the general syntax for the API. It uses an HTML object with the type "image/svg+xml". The data attribute is used to tell the server what algorithm is to be translated, so your data is the CuSHan API url (https://cushan.io/api) with the argument '?alg=' along with the algorithm to translate. For example, to translate the algorith RUR'U' would be:
You can size the image will display on your page using the width="x" and height="x" attributes. For example
To change the attributes relating to the appearance of the CuSHan generated by the API, you can append the various options to the url in 'data' in the form &attributeName=attributeValue. For example, The SVG created by the API will be 300 x 300 by default. If you want to change the aspect ratio of the SVG you can change its base size by appending &width=300&height=150 if you wanted to change it to 300 wide by 150 high.
You can change the horizontal and vertical alignment of the CuSHan using the &hAlign=left/center/right and &vAlign=top/center/bottom. For example:
You can also change the colors of the CuSHan and the background by using the &col=xxxxxx and &bgCol=xxxxxx respectively. The xxxxxx is the 6 character hexidecimal code of the color you want. You can also use 8 characters where the last 2 are the alpha value. For example:
Welcome to the Algorithms section. Click on the images below to see the relevant algorithms.
Welcome to the Resources section. Click on the images below to download the relevant resource.
Hi! My name’s Derek Nash. I developed CuSHan as a way to make it easier to memorise cubing algorithms by taking advantage of my visual memory.
It started out as a load of scribbles that eventually formed into something more coherent. I’m a coder / web-developer, so I thought I would put this site together in case it was also helpful for others looking to do the same.
I've got lots of ideas for CuSHan, so follow me on Instagram / Twitter / YouTube if you want to keep up to date with any developments. Happy cubing!
Site Change Log:
-Added Resources Section
-Added Resource: Know your colours
-Added Resource: Beginner 1-Look PLL Recognition Guide
-Added Resource: Demo files for real-time messsaging app
-Added URL Alg Link
-Added Simple Scrambler
-Added Auto-Break On Triggers Control
-Added Animation Duration Control
-Added Maximum Section Length Control
-Added Maximum Section Dimension Control
CuSHan Engine Change Log:
-Improved Overlapping Detection