Coder Social home page Coder Social logo

is4-project-structure's Introduction

IS4 Project Structure

A logical, reasonably standardized, but flexible project structure for doing and sharing work. (based on Cookiecutter Data Science)

This repository contains the base structure for research projects and theses. Please follow the folder structure presented as close as you can. As all projects have different requirements, you will probably have to change the structure a bit to fit your needs.

Folder structure

The directory structure of your new project looks like this (please adjust the structure and its description to best fit your project):

├── README.md          <- The top-level README for contributers of this project.
│
├── data
│   ├── raw            <- The original, immutable data dump.
│   ├── interim        <- Intermediate data that has been transformed.
│   └── processed      <- The final, canonical data sets for modeling.
│
├── docs               <- Documents
│   ├── reports        <- Generated analysis as HTML, PDF, LaTeX, DOCX etc.
│   ├── figures        <- Generated graphics and figures to be used in reporting
│   └── thesis         <- Thesis source files
│       └── templates  <- Thesis templates
│
├── references         <- Articles, books and other references used in your project. It is good practice to reference these materials in the comments of your code.
│
├── notebooks          <- Jupyter notebooks. Naming convention is a number (for ordering), the creator's initials, and a short `-` delimited description, e.g. `1.0-jqp-initial-data-exploration`.
│
├── requirements.txt   <- The file with instructions for reproducing the project environment (software). Indicates the version of  software you are using. If using Python, you can do `pip freeze > requirements.txt` to generate a list with the version of the different packages you use
│
└── code               <- Source code for use in this project.
    ├── data           <- Scripts to download, generate and process data
    │   └── make_dataset.py/m
    │   └── process_dataset.py/m
    │
    ├── algorithms     <- Functions to create models, run models, optization algorithms, etc.
    │
    ├── results        <- Scripts to apply the algorithms and obtain the results of your project
    │
    └── visualization  <- Scripts and functions for visualizations

Readme file

This file, README.md, should be used to include all information on the files included in the project and how to make them work.

It makes use of Markdown, which is a markup language focused on readability. You can find information on the main syntax of Markdown in:

Markdown Cheatsheet

Markdown Basics Guide

Daring Fireball Markdown Syntax Guide

Multiple text editors, such as Visual Studio Code, Sublime Text, Atom, Notepad++ have extensions that you can install to transform the Markdown file (.md) into a .pdf or .html.

Using Git and GitHub

To make sure you don't lose your work, improve collaboration potencial and supervisor feedback, it is advised to copy this structure to a folder and create a Git repository from it.

If you have never used Git, you will have to follow the following steps:

  1. Register on GitHub
  2. Download and install GitHub Desktop
  3. Go to IS4 Project Structure Repository and click on Use this template
  4. Give a name to your repository and make sure you make it private
  5. Open the GitHub Desktop software and login with your GitHub credentials
  6. Go to: File -> Clone repository ...
  7. Select your newly created GitHub repository and choose the directory you want to save it on
  8. Clone!
  9. Work, commit and push changes everyday!

For additional information on using Git and GitHub:

Contributers

jqmviegas (Joaquim L. Viegas): [email protected]

is4-project-structure's People

Contributors

jqmviegas avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.