Caderno

Um Caderno é um modelo do Modellus organizado como um documento. Em vez de colocares formas livremente num quadro, escreves uma sequência vertical de blocos — títulos, texto, expressões, gráficos, tabelas, seletores e multimédia — como num relatório de laboratório ou numa ficha de trabalho interativos.

Visão geral

Os cadernos usam o mesmo motor de cálculo que o editor Quadro. Os blocos Expressão definem a matemática do modelo — com a mesma linguagem de expressões da forma Expressão — e os restantes blocos mostram-no e controlam-no. Um caderno junta a narrativa (títulos, texto, imagens) a uma simulação em tempo real, que podes pôr a correr.

Todos os cadernos têm um cabeçalho com uma imagem de capa, um título, o nome do autor e a data da última alteração. Clica na imagem de capa para carregares uma nova e clica no título para o editares.

Criar e abrir cadernos

Os cadernos criam-se a partir da página do Catálogo: clica em Criar Caderno na barra lateral. Os cadernos aparecem nos cartões do Catálogo ao lado dos modelos de quadro, marcados com o ícone de caderno , e abrem no editor do caderno em vez do editor do quadro.

Blocos

O conteúdo acrescenta-se em blocos, a partir da barra de ferramentas de cima. Cada botão junta um bloco novo no fim do caderno.

Trabalhar com blocos

• Selecionar — Clica num bloco para o selecionares. Por baixo do bloco aparece uma barra de ferramentas de contexto com as opções próprias desse bloco (termos a mostrar, cores e muito mais).
• Reordenar — Usa a pega na margem esquerda de um bloco para o arrastares para outra posição. A barra de ferramentas de contexto também tem ações para mover.
• Estilo — Todos os blocos têm uma cor de fundo e uma cor de contorno, que encontras no botão de cor da barra de ferramentas de contexto.
• Duplicar, copiar e colar — Podes duplicar um bloco no mesmo sítio ou copiá-lo para a área de transferência e colá-lo a seguir a outro bloco.
• Eliminar — Remove um bloco a partir da barra de ferramentas de contexto, ou seleciona-o e carrega em Delete.
• Anular / refazer — Adicionar, remover, mover e editar blocos pode ser anulado com os botões da barra de ferramentas ou com Ctrl+Z / Ctrl+Y (Cmd no macOS).

Pôr o modelo a correr

A barra de reprodução no fundo do caderno comanda a simulação, tal como no editor do quadro:

• Variável independente — Clica no nome da variável (por exemplo, t) para lhe mudares o nome.
• Início / Passo — Clica no valor inicial para definires o início do domínio e o passo da iteração.
• Fim — Clica no valor final para definires onde a simulação para.
• Reprodução — Botões de reproduzir/pausar, parar, passo anterior/seguinte e repetir, e ainda um cursor de posição para percorrer as iterações.

Os blocos Gráfico, Tabela e Seletor atualizam-se em tempo real enquanto o modelo corre.

Guardar e colaborar

• Os cadernos guardam-se na tua conta a partir do menu. Só o autor do caderno pode guardar alterações.
• Quando tens aberto um caderno teu, as alterações são sincronizadas em tempo real, por isso os colaboradores que estão a ver o mesmo caderno veem as mudanças à medida que acontecem.
• A imagem de capa é carregada como miniatura do caderno quando guardas.

Formato do ficheiro

Um caderno é guardado como qualquer outro modelo, com uma secção notebook adicional no nível de topo da definição do modelo:

{
  "properties": { ... },
  "notebook": {
    "title": "Free Fall Lab",
    "author": "Author",
    "blocks": [
      { "id": 1, "type": "header", "content": "Free fall" },
      { "id": 2, "type": "text", "content": "We model a falling object..." },
      { "id": 3, "type": "expression", "content": "\\frac{dy}{dt}=v" }
    ]
  }
}

Cada bloco tem um id, um type, o seu content e propriedades de estilo como backgroundColor e borderColor. Consulta o Esquema do modelo para conheceres o formato completo dos modelos.