bastiR

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 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

• Windows & OS X : http://git-scm.com/downloads
• Debian/Ubuntu : sudo apt-get install git-core
• Fedora/RedHat : sudo yum install git-core

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

• Packages R
• Markdown
• knitr
• dplyr : introduction, aide mémoire
• R & Excel : readxl, openxlsx, http://www.r-bloggers.com/a-million-ways-to-connect-r-and-excel/
• LaTeX

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é