# cube

**Repository Path**: nwu_hq/cube

## Basic Information

- **Project Name**: cube
- **Description**: 某门课的作业，一个魔方复原项目，使用Django框架和DeepCudeA算法
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-10-30
- **Last Updated**: 2021-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 魔方项目说明

[TOC]


## 1. 项目环境

1. 该项目使用操作系统为 **Linux发行版Ubuntu 16.04**
2. 该项目的运行环境为 **python 2.7**
3. 该项目使用的框架为 **Django 1.11**
4. 项目依赖保存在 *requirement.txt* 文件中，下面会有说明。



## 2.项目使用说明

### 1.项目准备

本项目已经基于*Django*框架创建了基本的文件。在项目的根目录下有一个requirement.txt文件，里面保存了项目所需要的运行依赖库。使用以下命令完整依赖的导入。

```bash
cube$ pip install -r requirement.txt
```

此过程需要较长时间，建议使用阿里云镜像库加快下载速度。

### 2. 项目运行

当我们在准备阶段完成了项目依赖的导入以后，我们就可以直接运行我们的项目了，此过程就是*Django*的项目运行过程。

使用以下命令启动服务。需要到Django项目目录下。

```bash
cube$ cd deep 
deep$ python manage.py runserver 0.0.0.0:8000 # 映射到8000端口
```

在运行后就能看到以下命令行输出。

![初始化运行](pic/1.PNG)

在本地浏览器中，我们输入网址：**localhost:8000/index**，由于在 *urls.py*中没有加入对于 **/** 的映射，所以无法使用 **localhost:8000/** 访问，此网站将显示404错误。

我们就能看到魔方的界面，此界面魔方是一个已经复原的魔方。如下图所示





![index界面](pic/2.PNG)







点击上图的**Scramble**按钮，就能看到一个打乱的魔方。**我们可以在图中旋转我们的魔方**。如下如所示



![打乱的魔方](pic/3.PNG)





点击Solve按钮，我们就能看到复原的过程。



![solve](pic/4.PNG)

我们可以通过图中的左右按钮进行复原过程的查看。



## 3. 项目提高

该项目完成了自动输入魔方的样子，然后能够对给定的魔方样子进行复原。

首先我们还是按照 [项目运行](#2. 项目运行) 的命令启动我们的服务。

此时我们在浏览器中输入以下网址： **localhost:8000/indexPlus**

就能看到以下界面：





![indexPlus](pic/5.PNG)

其中的**Scramble**和**Solve**与之前的功能相同，我们加入了对魔方的操作，即以下字母表



|  U   |  D   |  L   |  R   |  F   |  B   |
| :--: | :--: | :--: | :--: | :--: | :--: |
|  U'  |  D'  |  L'  |  R'  |  F'  |  B'  |





不同的字母对应不同的操作，比如 **U**对应着将第一行的魔方向左转。

如下图所示

![U](pic/6.PNG)





所以我们可以通过按钮或者在文本框中输入我能想要的魔方样子，在3维立体与二维的平面中都能看到效果。**可以在3维魔方中旋转**。如下图所示。

![input](pic/7.PNG)





当我们点击 **Solve**按钮，我们可以看到复原过程。如下图：

![SolvePlus](pic/8.PNG)

如之前所述，依旧能够通过魔方上的左右进行过程的查看。