FTH 0 · O corpo do humanoide|INEMA.CLUB-PRO

Aula 8 · 15 min

A ficha técnica do seu humanoide

Ficha de fabricante, arquivo de simulação e medida não dizem a mesma coisa, e é na diferença que mora o sim-to-real. Nesta aula você compara dois humanoides do Menagerie por script, monta uma ficha que separa as três fontes e sai com o plano de estudo da formação.

Começar a aula
Duas maquetes de robôs humanoides de alturas diferentes lado a lado numa mesa escura, com paquímetro e caderno aberto.

Nesta aula você vai

  1. 1O comparar.py: 7 itens lidos do arquivo, lado a lado
  2. 2A ficha em três colunas: fabricante, arquivo, medida
  3. 3Que robô um laboratório compraria hoje, e por quê
  4. 4O plano com datas para os próximos cursos da FTH

Objetivo: comparar dois humanoides do Menagerie por script e montar a sua ficha técnica separando fabricante, arquivo e medida.

01Três fontes, uma ficha

Cada linha da ficha diz de onde veio. Clique em cada bloco.

Clique em cada bloco do diagrama para ver o que ele faz.

A coluna "diferença" é a lista de tarefas do sim-to-real.

02Que robô um laboratório consideraria em out/2026

Com preço só quando há fonte, e sempre variando por versão e revenda. Clique em cada um.

1. Unitree G1 EDU

É a plataforma que aparece em quase tudo: Menagerie (29 graus de liberdade), unitree_rl_lab, mjlab, retargeting (GMR), SONIC com pesos abertos e LeRobot.

O base (US$ 13,5 mil) não tem SDK; o EDU, que tem, é sob consulta.

03Comparar por script e preencher a ficha

O comparar.py imprime 7 itens dos dois arquivos. O modelo de ficha tem as três colunas; os colchetes são o que você preenche.

Terminal · G1 × H1
F=${FTH:-$HOME/fth}; cd $F/anatomia && . $F/.venv/bin/activate
python3 kit/comparar.py unitree_g1/scene.xml unitree_h1/scene.xml; echo "saída: $?"
Arquivo · kit/ficha-modelo.md
# Ficha técnica — [robô] (versão [base/EDU/…])

Data: [DD/MM/AAAA] · Modelo de simulação: [pasta do Menagerie] @ [commit]

| item | fabricante (fonte, data) | arquivo MJCF | medido no curso | diferença |
|---|---|---|---|---|
| graus de liberdade | [n] ([URL], [data]) | nu = [n] | — | [versão diferente?] |
| massa (kg) | [n] | [n] | — | [%] |
| altura do CoM em pé (m) | — | [n] | — | — |
| maior torque (N·m) | [n ou "não publicado"] | [n] ([junta]) | agachado 90°: [n] | [%] |
| sensores | [lista da ficha] | [n] no arquivo | + [acrescentados] | [o que falta] |
| bateria | [mAh, S, h] | — | [Wh, conta derivada] | — |
| computação | [CPU / Orin / Thor] | — | — | — |
| equilíbrio sem controlador | — | — | fica com [n] N · cai com [n] N (0,2 s) | — |
| estágio | [demo/piloto/produção] ([URL], [data]) | — | — | — |
Exemplo do repositório
item                               unitree_g1           unitree_h1
GDL acionados (nu)                         29                   19
massa do modelo (kg)                     33.3                 51.4
altura do CoM (m)                        0.69                 0.95
maior torque (N·m)                        139                  300
junta do maior torque        right_knee_joint           right_knee
sensores no arquivo                         4                    0
pose inicial                            stand                 home
FICHA: 7 itens comparados
saída: 0

O H1 é mais pesado e mais alto (CoM a 0,95 m) e tem joelho de 300 N·m no modelo, mas menos graus de liberdade e nenhum sensor declarado no arquivo.

04O que você montou neste curso

Quatro entregas principais. Clique num degrau para ver o "pronto quando".

Aula 1Tabela

6 robôs

3 exercícios

Estágio, fonte e data para 6 humanoides.

Ver a aula
Aula 2Bancada

MuJoCo + Menagerie

3 exercícios

~/fth com versões fixadas.

Ver a aula
Aulas 3–5Corpo

juntas, torque

3 exercícios

Juntas, torque e sensores lidos do arquivo.

Ver a aula
Aulas 6–8Limites

equilíbrio, ficha

3 exercícios

Limite de empurrão e ficha em três colunas.

Ver a aula
Ao final do cursoBancada pronta, corpo lido do arquivo e ficha com as diferenças anotadas.
8 aulas
Clique num exercício para ver o que fazer e o "pronto quando".
  1. 1/5

    Tabela

    A tabela que separa demo, piloto e produção. Atualize a cada notícia: a data é o que mantém a tabela honesta.

  2. 2/5

    Bancada

    A bancada que os cursos 1 a 4 reaproveitam: venv, MuJoCo 3.16.0 e Menagerie no commit testado.

  3. 3/5

    Corpo

    Árvore de juntas, torque medido no agachamento e sensores conferidos contra o peso: o corpo descrito por números seus.

  4. 4/5

    Limites

    O limite do corpo sem controlador, a conta de energia e a ficha técnica: o ponto de partida do curso de locomoção.

  5. 5/5

    O curso inteiro

    Quatro entregas em sequência. A bancada da aula 2 é pré-requisito de todas as práticas dos próximos cursos da FTH.

A ordem importa: sem a bancada, nada das aulas 3 a 8 roda.

05Gere o seu plano com datas

Escolha a data de início e quanto tempo você tem por semana. O plano lista as práticas de cada aula.

06Prática

Comparar, preencher e decidir.

E1 · G1 × H1

3 min

Rode o bloco de comparação e explique em uma frase por que o H1 tem CoM mais alto.

Pronto quando: python3 kit/comparar.py unitree_g1/scene.xml unitree_h1/scene.xml; echo "saída: $?" → FICHA: 7 itens comparados e saída: 0.

E2 · A ficha do G1

20 min

Copie kit/ficha-modelo.md para ~/fth/ficha-g1.md e preencha as três colunas com o que você leu e mediu nas aulas 1 a 7.

Pronto quando: grep -c "\[" ~/fth/ficha-g1.md → 0 (nenhum colchete por preencher).

E3 · Um terceiro robô

10 min

Acrescente outra pasta ao sparse-checkout (por exemplo apptronik_apollo) e compare com o G1. Atenção: o PAL TALOS não tem scene.xml; use pal_talos/scene_position.xml.

Pronto quando: python3 kit/comparar.py unitree_g1/scene.xml [pasta]/scene.xml | tail -1 → FICHA: 7 itens comparados.

07Teste da aula

A explicação aparece depois da sua resposta.

Pergunta 1 de 3

Para que serve a coluna "diferença" da ficha?competência

08Em três frases

Três fontesFabricante, arquivo e medida, cada linha com a sua origem.
DiferençaO que diverge entre modelo e robô é o trabalho do sim-to-real.
PróximoCom a bancada e a ficha prontas, o curso 1 ensina o G1 a andar.

Para ir além

Aula anteriorVoltar ao início do curso