/bastiR

Outils pour le suivi de chantier

Primary LanguageR

bastiR

Build Status GPLv2 License

Le package R bastiR a pour but d'être une collection d'outils pour faciliter le suivi de chantier. Sa première fonctionnalité est la génération de compte-rendus de réunions de chantier.

Logiciels requis

R   LaTeX

  • R version >= 3.2.0 (2015-04-16)
  • Rtools (Windows seulement)
  • RStudio version >= 0.99.441
  • LaTeX :
    • Windows : MiKTeX
    • OS X : MacTeX
    • Debian/Ubuntu : sudo apt-get install texlive
    • Fedora/RedHat : sudo yum install texlive

Installation

Pour installer la dernière version en développement sur GitHub, entrer la commande suivante sous R :

# install.packages("devtools")
devtools::install_github("adrtod/bastiR")

Installation rapide sous Windows

  1. Installez R
  2. Ouvrez la console R puis entrez les commandes suivantes pour installer tous les logiciels requis ansi que le package bastiR :
install.packages(c("installr", "devtools"))
installr::install.rtools()
installr::install.rstudio()
installr::install.miktex(64) # remplacez 64 par 32 pour la version 32-bit
devtools::install_github("adrtod/bastiR")

Spécification des tableaux d'entrée

  • Tableur Excel (>= 2007) .xls ou .xlsx
  • Ne pas fusionner les cellules
  • 1 colonne = 1 variable, libellé en 1ère ligne
  • 1 ligne = 1 individu
  • Colonnes de dates au format date dans Excel
  • N'utiliser que les caractères reconnus par la norme ISO 8859-1
  • ... à l'exception des caractères suivants qui doivent être précédés d'un \ : & % $ # _ { } ~ ^ \
  • Pour le reste utiliser les commandes LaTeX :
    • \euro{}, \oe{}, \OE{}
    • symboles mathématiques et lettres grecques entre dollars, ex: $\lambda$
    • formatage en indice ou exposant, ex: m$^2$
    • apostrophes simples ' seulement
    • tirets simples seulement -. tiret semi-cadratin : --. tiret cadratin : ---

Feuilles de calcul (onglets)

Nom Description Colonnes
LEGENDE Légende des objets Obligatoires :
CLASSE : classe d'objet désigné par une clé (acteur orga, acteur exe, section, etat)
CLE : clé, courte chaîne de caractères, insensible à la casse
NOM : nom de l'objet
Facultatives :
DESIGNATION : nom du lot
LOT : numéro du lot
REPRESENTANT, TEL, MOBILE, FAX, EMAIL, P, DIF, C, ABS ...
TACHES Tâches passées SECTION : clé (ex: orga=Organisation générale, exe=Exécution)
REUNION : date de réunion
ECHEANCE : date d'échéance
REALISATION : date de réalisation
ACTEUR : clé associée à l'acteur
TACHE : texte décrivant la tâche
ETAT : clé (af=A faire, f=Fait, i=Info, av=A valider, v=Validé, an=Annulé)
PRIORITE : automatique (RAPPEL ou URGENT)
CEJOUR Tâches réunion en cours cf. TACHES, sauf PRIORITE
PLANS Armoire à plans SECTION
SOUSSECTION
PLAN, NUM, INDICE, DATE
PLANSNOTE Note pour l'armoire à plans TEXTE
PHOTOS Photographies commentées FICHIER : nom du fichier (avec extension, sans le chemin), ne doit pas contenir d'espace
COMMENTAIRE : texte

Spécification des photos

  • Fichiers reconnus : .jpg, .jpeg, .JPG, .JPEG, .png, .PNG
  • Les noms de fichiers ne doivent pas contenir d'espace
  • Orientation portrait/paysage : effectuer les rotations nécessaires manuellement

Traitements automatiques

  • Prépare feuille de calcul PHOTOS avec fichiers lus dans le dossier courant
  • Efface les lignes vides
  • Complète ETAT manquant par A faire
  • Ajoute CEJOUR à TACHES
  • Convertit clés ETAT, SECTION, ACTEUR en minuscule
  • Tri des lignes par ETAT, SECTION, ECHEANCE puis ACTEUR
  • Edite PRIORITE : Rappel (ECHEANCE passée) ou Urgent (ECHEANCE + 1 semaine)
  • Complète REALISATION manquante par la date de la réunion
  • Supprime les lignes Fait/Validé/Annulé avec REALISATION supérieure à 3 semaines

Ressources

  • Introduction à R et RStudio : TODO

Auteurs

Copyright (C) 2015, Adrien Todeschini, Baptiste Dulau.

bastiR est un logiciel libre distribué sous la Licence GPL-2.

Signaler un bug

https://github.com/adrtod/bastiR/issues

Contribuer au développement

Créer un compte GitHub

https://github.com/signup

Installer Git

Contribution mineure

Fork & pull

Contribution majeure

  • Faire une demande aux propriétaires du projet GitHub pour devenir collaborateur.

  • Mettre en place le projet sous RStudio :

    1. Cliquer sur New Project (dans le menu File)
    2. Choisir un nouveau projet Version Control
    3. Choisir Git
    4. Fournir l'URL du référentiel (et d'autres options appropriées) et cliquer sur Create project.

    Le dépôt distant sera cloné dans le répertoire spécifié, et les fonctions de versionnage de RStudio seront ensuite disponibles pour ce répertoire.
    Voir aussi : projets RStudio, versionnage avec RStudio, tutoriel vidéo.

Ressources

Liste des tâches

  • code en anglais, aide en français ?
  • tester sous osx
  • écrire intro origine et but du projet
  • ajouter ressources
  • problème de lecture lorsque certaines colonnes sont apparemment vides mais ne le sont pas en réalité